github-reader Skill
Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
- GitHub Stars
- 7
- Dateien
- 1
- Letzter Commit
- 14. Sept. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der github-reader Skill?
github-reader ist ein Agent Skill. Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den github-reader skill
Analyzing GitHub project health by examining issues, pull requests, milestones, and release statuses is what this skill enables. Developers can use it to generate comprehensive project state reports or perform global audits of a repository's current activity. The tool functions by using the GitHub CLI or authenticated API calls to fetch data from a remote repository or a user-specified target.
When an agent loads this skill, it can categorize pull requests by status, such as drafts or those requiring changes, and identify unassigned or stale issues. It provides specific metrics like milestone completion rates and tracks overdue items based on deadlines. To ensure accuracy, the skill reports the total count of items found versus the number actually retrieved, noting if results are incomplete. It produces structured data including repository details, fetch timestamps, and truncated collections for further processing by other tasks.
Was ein agent damit machen kann
- 1Generate project status reportsAsk the agent to provide a full overview of open issues, pull requests, and recent milestones for a specific repository.
- 2Audit pull request workflowsRequest a breakdown of open pull requests categorized by draft status, author, or those needing a review decision.
- 3Track milestone progressDetermine the completion percentage of milestones and identify which ones have passed their deadlines with open tasks.
- 4Identify unassigned or stale issuesFind all open issues that currently have no assignee or have not been updated for a long time.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den github-reader Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den github-reader Skill in Plugin installieren
/plugin marketplace add Neplich/dev-agent-skills /plugin install pm-agent@dev-agent-skills
Den github-reader Skill in Claude Code installieren
~/.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-readerDen github-reader Skill in Claude Code (project) installieren
.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader .claude/skills/github-readerDen github-reader Skill in Codex installieren
~/.agents/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.agents/skills/github-readerDen github-reader Skill in Gemini CLI installieren
~/.gemini/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.gemini/skills/github-readerDen github-reader Skill in Claude.ai installieren
npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader github-reader && zip -r github-reader.zip github-reader # claude.ai → Customize → Skills → + → Create skill → Upload a skill → github-reader.zip
SKILL.md
Auf GitHub ansehenGitHub 状态读取
从当前仓库 remote 或用户指定仓库确定目标，通过 Connector 或已认证 gh 读取所需状态。用户只询问某一集合时聚焦该集合；全局盘点包含 issue、PR、milestone 与近期交付。
gh repo view --json nameWithOwner,url,defaultBranchRef
gh issue list --state open --limit 1000 --json number,title,state,labels,milestone,assignees,createdAt,updatedAt
gh pr list --state open --limit 1000 --json number,title,state,author,reviewDecision,createdAt,labels,isDraft
gh api repos/{OWNER}/{REPO}/milestones --paginate -X GET -f state=open
读取总数时使用 search 的 total_count，同时检查 incomplete_results。获取数量低于总数时写明“已获取 N/M 条，分类基于已获取部分”。milestone 使用分页。时间范围按当前时间计算并明确起止日期；用户提供导出时保留仓库、采集时间和完整性说明。
gh api search/issues -X GET -f q='repo:{OWNER}/{REPO} is:issue is:open' --jq '{total_count, incomplete_results}'
gh api search/issues -X GET -f q='repo:{OWNER}/{REPO} is:pr is:open' --jq '{total_count, incomplete_results}'
PR 可按 bot、draft、CHANGES_REQUESTED 和待 review 分类，附作者、标签、等待时间和链接。Milestone 完成率为 closed/(open+closed)，过期且有开放事项时标记逾期；缺少截止日时如实说明。issue 可标注未分配及长期未更新状态。
输出围绕需要用户关注的结果，详细列表按规模裁剪并链接原记录。其他任务需要复用数据时，可提供含 repo、fetched_at、总数、milestones、truncated_collections 和 incomplete_totals 的 github_reader_data；数据含义与实际查询保持一致。
Dateien in diesem Skill
1github-reader Skill-Fragen
Wie installiere ich den github-reader Skill in Claude Code?
Führe npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-reader aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den github-reader Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
How does the tool handle large numbers of issues or pull requests?
The tool uses pagination and checks for incomplete results, explicitly stating if the number of items retrieved is less than the total count.
Can the tool categorize pull requests?
Yes, pull requests can be categorized by bot, draft, CHANGES_REQUESTED, and pending review status.
How are milestones evaluated?
Milestone completion rate is calculated as closed divided by the sum of open and closed items, and overdue milestones are flagged if they have open items.