About backlog
Backlog is a skill for adding and reviewing project work items in a local backlog file or GitHub, based on repository context. It includes duplicate checks, category handling, and review options for triage, selection, or theme grouping.
Key features
- 01Chooses a local file or GitHub destination
- 02Checks for duplicate items
- 03Categorizes bugs, enhancements, chores, and docs
- 04Adds items with existing numbering or labels
- 05Reviews items through triage, selection, or themes
Use cases
- 01Recording a bug or enhancement request
- 02Reviewing open items by category and age
- 03Grouping related backlog items into themes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ sammcj/ agentic-coding --skill backlogAfter installing, type/backlogin Claude Code to confirm it loaded.
Details
From the project READMEBacklog
Destination
First match wins:
BACKLOG.mdordocs/BACKLOG.md-> local file.- The user's own repo, not a fork -> GitHub.
- Otherwise ask. Create no backlog file unless the user picks one.
Categories: bug, enhancement, chore (refactor, dependencies, CI, build, tests), documentation.
Local:
- Category as a title prefix, e.g.
[bug]. Find dupes with grep. - Add a section, or a new file continuing the existing numbering (
0001-slug.md).
GitHub:
- Category is an existing label (
gh label list). Ask before creating one. - Dupes:
gh issue list --search "<keywords>". List:gh issue list --limit 50 --json number,title,labels,createdAt. - Add: write the body to a file in a
mktemp -ddirectory, thengh issue create --body-file <file>.
Add
- Search for dupes first. On a near match, ask: update it or file new.
- Guess the category. Ask at most one question in total, only when scope or category is ambiguous.
- File it. Reply with the URL or path only.
Review
- List open items, grouped by category, oldest first: number, title, age.
- Offer, letting the user choose:
- Triage: relabel, close stale items, merge dupes. Confirm each close.
- Pick one: load the item and stop. If
openspec/exists, end withNext: /opsx:propose from #<n>. - Themes: cluster related items, suggest groupings.
Notes
- Keep the contents concise, quick and easy to read.
Comments
Markdown supported