github-issue-analyzer

name	github-issue-analyzer
description	Fetches issues from any GitHub repository with recent activity and generates a prioritized report by analyzing issue state, labels, and comment counts to identify high-priority bugs, enhancements, and good first issues for contributors.

GitHub Issue Analyzer

Instructions

This skill fetches GitHub issues from any repository and generates a comprehensive prioritized report. It's useful for understanding project health, identifying what needs attention, and helping new contributors find good starting issues.

Usage

1. Import the analyzer function
2. Call it with a repository owner and name
3. Optionally specify the number of days for "recent activity" (default: 30)
4. The function returns a structured report and saves raw data to ./workspace/

Features

• Automatic Categorization: Issues are categorized into HIGH, MEDIUM, LOW priority and "Good First Issues"
• Smart Filtering: Identifies bugs vs enhancements, counts active discussions
• Activity-Based Ranking: Sorts by comment count and recency
• Comprehensive Report: Includes summary statistics, top 10 recommended issues, and full issue listings

Priority Logic

• HIGH PRIORITY: Open bugs OR open issues with >3 comments
• MEDIUM PRIORITY: Open enhancements/feature requests
• LOW PRIORITY: Closed issues or less active items
• GOOD FIRST ISSUES: Issues explicitly labeled as beginner-friendly

Examples

import { analyzeGitHubIssues } from './.claude/skills/github-issue-analyzer/implementation';

// Basic usage - analyze last 30 days
const report = await analyzeGitHubIssues('modelcontextprotocol', 'inspector');

// Custom timeframe - analyze last 60 days
const report = await analyzeGitHubIssues('modelcontextprotocol', 'inspector', 60);

// Report includes:
// - summary statistics
// - top 10 recommended issues with explanations
// - categorized issues by priority
// - actionable insights and next steps

Output Files

The skill automatically saves:

• ./workspace/all-issues.json - Raw issue data (100 issues per page)
• ./workspace/issue-report.md - Formatted markdown report

Dependencies

• MCP Tool: list_issues from GitHub server