Навык github-reader
Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
- Звёзды на GitHub
- 7
- Файлы
- 1
- Последний коммит
- 14 сент. 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык github-reader?
github-reader — это Agent Skill. Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
Сводка сгенерирована из SKILL.md навыка.
О 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.
Что агент может делать с ним
- 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 SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык github-reader
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка github-reader в Плагин
/plugin marketplace add Neplich/dev-agent-skills /plugin install pm-agent@dev-agent-skills
Установка навыка github-reader в Claude Code
~/.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-readerУстановка навыка github-reader в Claude Code (project)
.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader .claude/skills/github-readerУстановка навыка github-reader в Codex
~/.agents/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.agents/skills/github-readerУстановка навыка github-reader в Gemini CLI
~/.gemini/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.gemini/skills/github-readerУстановка навыка github-reader в 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
Открыть на 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；数据含义与实际查询保持一致。
Файлы в этом навыке
1Вопросы о навыке github-reader
Как установить навык github-reader в Claude Code?
Выполните npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-reader. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык github-reader?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
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.