fadymondy
UserGitHub Issues as a project-management system for Claude Code — plans, features, bugs, evidence-gated lifecycle, PR-driven review. Backed by GitHub primitives.
Categories
Indexed Skills (22)
gh-advance
Advance an issue to the next workflow status with evidence. Validates the gate per `workflows/default.yaml` — required `## Sections`, file paths, cooldown, kind-specific skips. Mirrors Orchestra MCP's `advance_feature`. Auto-invoke when the user says "tests pass for
gh-breakdown
Break a plan (milestone + tracker issue) into child sub-issues with dependencies. Each child becomes a real GitHub sub-issue, sets its native issue type when available, attaches to the plan's milestone, and joins the gh-pms project board. Mirrors Orchestra MCP's `breakdown_plan`.
gh-bug
File a bug report — sets GitHub native Issue Type "Bug" when available, falls back to `type:bug` label. Adds severity field/label, links related feature, attaches to active project. Mirrors Orchestra MCP's `create_bug_report`. Bugs auto-skip Gate 3 (docs).
gh-bulk
Apply a single action to many issues at once — bulk-label, bulk-close-stale, bulk-reassign, bulk-set-severity. Always lists matches and asks for confirmation before applying. Auto-invoke when the user says "close all stale", "label everything in svc:X", "bulk update".
gh-context
Print a compact summary of the current repo's gh-pms state — WIP for the user, open issues by status, milestone progress, recent closes, deferred requests. Auto-runs at session start so the agent picks up where the last session left off. User-invocable for an on-demand refresh.
gh-current
Set the active issue — moves it from `status:todo` to `status:in-progress` and verifies the WIP guardrail (one in-progress issue per assignee). Mirrors Orchestra MCP's `set_current_feature`. Auto-invoke after a feature/bug is created and the user wants to start work, or when the user says "let's work on
gh-feature
Create a single feature/chore/hotfix/testcase issue. Sets the GitHub native Issue Type when available (org-level), falls back to `type:*` labels. Adds to the gh-pms project and the active milestone (if any). Auto-invoke when the user says "build X", "add Y", "implement Z", "refactor Q".
gh-init
Bootstrap a GitHub repo for gh-pms — detects available native features (Issue Types, Projects v2, Milestones), provisions what's missing, drops in issue templates and a PR template. Run this once per repo before using gh-pms. Idempotent. Auto-invoke when the user is in a repo without the gh-pms project, or when they say "set up issues", "init pms", "bootstrap this repo".
gh-metrics
Project flow analytics — median time-in-status, gate failure rate, throughput, severity mix. Reads per-issue state files + GitHub closed-issue timestamps to surface metrics PMs actually need. Auto-invoke when the user says "metrics", "velocity", "how's our flow", "throughput last month".
gh-plan
Create a multi-feature plan as a GitHub Milestone (preferred) plus a tracker issue. Use when the user request would result in 3+ features. Mirrors Orchestra MCP's `create_plan`. The milestone groups child issues; the tracker issue holds the high-level objective and breakdown checklist.
gh-push
Ship an in-progress issue — commit local changes on the feature branch, push, open the PR with `Closes
gh-relate
Manage relationships between issues — depends-on, blocks, related-to, duplicate-of. Encodes the link in the issue body's structured sections AND uses GitHub's native cross-references so the relationship appears in both timelines. Auto-invoke when the user says "X depends on Y", "Y blocks X", "X is related to Y", "X is a duplicate of Y".
gh-release
Cut a new release for the plugin — bundle issues closed since the last tag into a CHANGELOG entry, bump semver in plugin.json, refresh the README "What's new" banner, tag the commit, and (optionally) create a GitHub release. Auto-invoke when the user says "ship vX.Y", "cut a release", "release the plugin", "bump version".
gh-reopen
Re-enter a `done` issue at `status:in-progress` with a clean audit trail. Auto-creates a fresh feature branch off the protected base. Auto-invoke when the user says "reopen
gh-review
Open the PR for an issue, run Gate 4 (self-review), and orchestrate user approval (Gate 5). Mirrors Orchestra MCP's `request_review` + `submit_review`. Auto-invoke when the user says "review
gh-search
Ad-hoc issue queries beyond the fixed `gh-status` dashboard. Translates natural-language asks into GitHub search syntax (or accepts raw syntax) and renders results as a compact severity-sorted table. Auto-invoke when the user says "show me all X", "find issues that Y", "list bugs with severity high".
gh-status
Show the gh-pms dashboard for the current repo — open issues grouped by status, WIP for current user, next-actionable items. Auto-invoke when the user says "status", "where are we", "what's next", "show issues".
gh-task
Add a task — either a sub-sub-issue under a feature, or (for trivial work) a checkbox in the parent feature's body. Use when a feature has internal steps that need tracking but don't warrant their own issue. The skill decides between sub-issue vs. checkbox based on estimated effort.
gh-test-plan
Auto-generate `testcase` sub-issues from a feature's `## Acceptance criteria` checkboxes. QA coverage tracks the spec automatically — every unchecked criterion becomes a testcase, idempotent on re-run. Auto-invoke when the user says "generate test plan for
gh-triage
Drain the `type:request` inbox — for each deferred user ask, decide accept-as-feature / accept-as-bug / reject / defer-again. Promotes accepted requests into real work; closes rejected ones with a documented reason. Auto-invoke when the user says "triage requests", "drain the inbox", "what's in the request queue".
gh-request
Save a deferred user request as a `type:request` issue and continue current work. Mirrors Orchestra MCP's `create_request`. Auto-invoke when the user asks for something unrelated to the in-progress issue — captures it for later instead of dropping current flow.
gh-validate
Dry-run gate validation — check if evidence would pass without actually transitioning. Mirrors Orchestra MCP's `validate_gates`. Use to preview before `gh-advance`.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.