github-reader skill
Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
- GitHub yıldızları
- 7
- Dosyalar
- 1
- Son commit
- 14 Eyl 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
github-reader skill ne işe yarar?
github-reader bir agent skill'dir. Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
github-reader skilli hakkında
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.
Bir agent bununla neler yapabilir
- 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.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
github-reader skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.github-reader skill'ini Eklenti uygulamasına kur
/plugin marketplace add Neplich/dev-agent-skills /plugin install pm-agent@dev-agent-skills
github-reader skill'ini Claude Code uygulamasına kur
~/.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-readergithub-reader skill'ini Claude Code (project) uygulamasına kur
.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader .claude/skills/github-readergithub-reader skill'ini Codex uygulamasına kur
~/.agents/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.agents/skills/github-readergithub-reader skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.gemini/skills/github-readergithub-reader skill'ini Claude.ai uygulamasına kur
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
GitHub'da görüntüleGitHub 状态读取
从当前仓库 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;数据含义与实际查询保持一致。
Bu becerideki dosyalar
1github-reader skill soruları
github-reader skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-reader komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
github-reader skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
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.