github-flow-kit

Save 3+ hours/week on GitHub PR reviews, release notes, issue triage, and repo onboarding — powered by Claude Code.

---

Why github-flow-kit?

• Zero setup — install one command, use immediately. No API keys, no config files.
• 4 skills for every GitHub workflow — from first PR review to weekly backlog cleanup.
• Safe by design — never modifies migrations, .env, auth, or CI files without asking.

---

Quick Install

# Install all 4 skills at once
for skill in pr-respond release-notes issue-triage repo-tour; do
  gh skill install thinkyou0714/github-flow-kit $skill --agent claude-code --scope user
done

Or install individually:

gh skill install thinkyou0714/github-flow-kit pr-respond     --agent claude-code --scope user
gh skill install thinkyou0714/github-flow-kit release-notes  --agent claude-code --scope user
gh skill install thinkyou0714/github-flow-kit issue-triage   --agent claude-code --scope user
gh skill install thinkyou0714/github-flow-kit repo-tour      --agent claude-code --scope user

---

Skills

Skill	What it does	Time saved
pr-respond	Read PR review comments → fix code → commit → draft replies	~50 min/PR → 3 min
release-notes	git log + merged PRs → user-facing + dev changelog	~55 min → 6 min
issue-triage	Score 50+ issues by Impact×Effort → sprint plan + labels	Hours → 7 min
repo-tour	Explore codebase → REPO_TOUR.md with Mermaid diagram	1-3h → 2 min

---

Demo

Coming soon — asciinema recordings of each skill in action.

Sneak peek: /pr-respond on a real open-source PR (5 review comments, 3 files changed, 0 manual edits needed).

---

Requirements

• GitHub CLI v2.90.0+
• Claude Code (any plan — Free works)
• gh auth login completed

---

Usage

pr-respond

Address all open PR review comments in one pass.

/pr-respond                    # auto-detect open PRs with comments
/pr-respond --pr 42            # target specific PR
/pr-respond --dry-run          # preview actions without executing
/pr-respond --auto-push        # push after committing

What it does:

1. Fetches unresolved review comments
2. Classifies each: MUST-FIX / ACK / DISCUSS / SKIP
3. Edits files for MUST-FIX items and commits
4. Drafts response text for each comment
5. Posts replies via gh pr review --comment

---

release-notes

Generate polished release notes from git history.

/release-notes                        # since last tag, auto-detect language
/release-notes --since v1.2.0        # custom base tag
/release-notes --audience en         # English output
/release-notes --type dev            # conventional changelog format
/release-notes --dry-run             # preview without creating GitHub release

Output: GitHub Release draft + suggested semver bump.

---

issue-triage

Score and prioritize your backlog.

/issue-triage                  # all open issues, 2-week sprint
/issue-triage --sprint 1w      # 1-week sprint capacity
/issue-triage --top 20         # top 20 only
/issue-triage --label bug      # filter by label
/issue-triage --dry-run        # output TRIAGE.md without applying labels

Scoring: Impact(1-5) × (6 - Effort(1-5)) + Urgency bonus

Output: TRIAGE.md + priority labels applied.

---

repo-tour

Understand any codebase in minutes.

/repo-tour                     # full analysis, auto-detect language
/repo-tour --depth 2           # limit directory depth
/repo-tour --focus src/api     # focus on specific subtree
/repo-tour --lang en           # English output
/repo-tour --output stdout     # print instead of writing REPO_TOUR.md

Output: REPO_TOUR.md with 30-second summary, annotated tree, Mermaid diagram.

---

Combine Skills

# New repo: understand → triage → start working
/repo-tour && /issue-triage --sprint 2w

# Release day
/pr-respond --auto-push && /release-notes

# Weekly maintenance (5 minutes total)
/issue-triage --top 10 --dry-run

---

Update All Skills

gh skill update --all

---

Cost

Each skill run costs approximately ¥10-40 in Claude API usage (claude-sonnet-4-6, billed through Claude Code).

---

FAQ

Q: Do I need a paid Claude Code plan? No. All 4 skills work on the Free plan.

Q: gh skill install failed with "command not found" You need GitHub CLI v2.90.0 or later. Run gh --version to check. Update: gh upgrade or download from cli.github.com.

Q: Does it work in Japanese? Yes. All skills auto-detect language from README/commit history. Use --lang ja or --lang en to override.

Q: Is it safe to run on production repos? Yes. pr-respond never modifies migrations, .env, auth, or CI files. All changes require your git push to take effect.

Q: Can I customize the scoring or classification rules? Yes. After install, edit ~/.claude/skills/<skill-name>/references/*.md. Your changes persist across updates until you reinstall.

---

Secrets Setup (for CI/CD features)

The GitHub Actions workflows in this repo require these secrets in your fork:

Secret	Required for	How to get
ANTHROPIC_API_KEY	auto-release-notes, weekly-triage	console.anthropic.com
SLACK_WEBHOOK_URL	skill-release-announce	Slack app settings → Incoming Webhooks

Set them at: github.com/YOUR_ORG/YOUR_REPO → Settings → Secrets and variables → Actions

---

Contributing

See CONTRIBUTING.md. Found a bug? Open an Issue.

---

License

MIT — Free to use, fork, and customize.

---

Built with gh skill · Powered by Claude Code

⭐ If github-flow-kit saved you time, a star helps others find it!