backlog

Triage, groom, prioritize, and file GitHub issues across the backlog lifecycle.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/chris-prener/dev-kit --skill backlog-chris-prener
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: backlog
Source: https://github.com/chris-prener/dev-kit/tree/main/dev-kit/skills/backlog
Command: npx skills add https://github.com/chris-prener/dev-kit --skill backlog-chris-prener

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing a GitHub issue backlog involves repetitive process work: capturing half-formed ideas before they are lost, grooming stale or under-specified issues, routing freshly filed items, and keeping priorities current. This Skill encodes that entire issue lifecycle as six named operations so Claude Code can execute them consistently instead of re-deriving the process each time. ## Core Features & Use Cases - Capture and Create: File issues interactively, from a minimal-friction quick capture with a needs-grooming label to a fully baked issue with user story, parent epic linkage, and Definition-of-Ready pre-flight checks. - Groom and Triage: Periodically curate the needs-grooming inbox, walk ROADMAP horizons, kill stale issues, regroup orphans, and route needs-triage issues to epics, standalone status, duplicate, or not-planned — every mutation confirmed per item. - Prioritize and Auto-file: Suggest implementation order across open issues, and let other skills (QC, doc-audit, code-review) file durable findings non-interactively with dedup markers. - Use Case: After a code review surfaces a tech-debt finding, auto-file it as a labeled GitHub issue with dedup protection, then later run groom-inbox to promote captured ideas into triaged, epic-linked work items. ## Quick Start Ask Claude to groom the backlog by walking the needs-grooming inbox and promoting ready issues to triage.

Frequently Asked Questions about backlog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I groom a GitHub issue backlog with Claude Code?▼

Invoke the backlog skill's Groom operation, which walks issues labeled needs-grooming, fills in deferred sections like problem statement and acceptance criteria, runs a Definition-of-Ready pre-flight check, and promotes each issue to needs-triage with per-item confirmation.

How to triage GitHub issues automatically with the gh CLI?▼

The Triage operation lists open issues carrying the needs-triage label via gh issue list, runs a dedup search and epic-linkage check on each, then proposes one of six routes — epic link, standalone, duplicate, not-planned, promote-to-epic, or defer — confirming before any mutation.

What is the difference between needs-grooming and needs-triage labels?▼

needs-grooming marks half-formed captured ideas awaiting full authoring during grooming, while needs-triage marks fully baked issues awaiting routing to an epic, standalone status, or closure. Grooming promotes issues from the first label to the second.

Can this skill create or close epics directly?▼

No. Epic promotion is propose-only and hands off to the epic skill, while epic demotion is refused when open sub-issues exist and routes to epic-retrospective. The backlog skill never sets the epic label or creates epics itself.

Why does auto-file mode add a dedup marker to issues?▼

Auto-file mode embeds an autofile-id HTML comment in each filed issue so repeated findings from QC, doc-audit, or code-review runs never create duplicate open issues. On a dedup hit it updates or comments on the existing issue instead.

When should I use Capture instead of Create for a new issue?▼

Use Capture when the idea is half-formed and you only have a user story; it files quickly with a needs-grooming label and defers all heavy authoring. Use Create when the issue is ready for full specification with codebase context and epic linkage.