Skill github-reader
Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
- Estrellas en GitHub
- 7
- Archivos
- 1
- Último commit
- 14 sept 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill github-reader?
github-reader es una agent skill. Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill github-reader
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.
Lo que un agente puede hacer con ella
- 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.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill github-reader
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill github-reader en Plugin
/plugin marketplace add Neplich/dev-agent-skills /plugin install pm-agent@dev-agent-skills
Instalar la skill github-reader en Claude Code
~/.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-readerInstalar la skill github-reader en Claude Code (project)
.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader .claude/skills/github-readerInstalar la skill github-reader en Codex
~/.agents/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.agents/skills/github-readerInstalar la skill github-reader en Gemini CLI
~/.gemini/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.gemini/skills/github-readerInstalar la skill github-reader en Claude.ai
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
Ver en GitHubGitHub 状态读取
从当前仓库 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；数据含义与实际查询保持一致。
Archivos de esta skill
1Preguntas sobre la skill github-reader
¿Cómo instalo la skill github-reader en Claude Code?
Ejecuta npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-reader. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill github-reader?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
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.