github-reader skill
Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
- GitHub 스타
- 7
- 파일
- 1
- 마지막 커밋
- 2026년 9월 14일
- 라이선스
- MIT
- 허용된 도구
- —
github-reader skill은 무엇을 하나요?
github-reader은(는) agent skill입니다. Read and analyze GitHub issues, pull requests, milestones, and release statuses to provide comprehensive project state reports.
skill의 SKILL.md에서 생성된 요약입니다.
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.
agent가 수행할 수 있는 작업
- 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 skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.플러그인에 github-reader skill 설치
/plugin marketplace add Neplich/dev-agent-skills /plugin install pm-agent@dev-agent-skills
Claude Code에 github-reader skill 설치
~/.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-readerClaude Code (project)에 github-reader skill 설치
.claude/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader .claude/skills/github-readerCodex에 github-reader skill 설치
~/.agents/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.agents/skills/github-readerGemini CLI에 github-reader skill 설치
~/.gemini/skills/github-reader/SKILL.md
$ npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.gemini/skills/github-readerClaude.ai에 github-reader skill 설치
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에서 보기GitHub 状态读取
从当前仓库 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；数据含义与实际查询保持一致。
이 스킬의 파일
1github-reader skill 질문
Claude Code에 github-reader skill을 어떻게 설치하나요?
npx degit Neplich/dev-agent-skills/agents/product_manager/skills/github-reader ~/.claude/skills/github-reader를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
github-reader skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
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.