Skip to main content
skill CX Codex

backlog · sammcj — Claude Code skill: what it does, how to install

Tracks bugs and features in local Markdown files or GitHub Issues. Keeps backlogs tidy without drafting heavy PRDs or specifications.

Apache-2.0 ★ 173 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sammcj/agentic-coding --skill backlog -a claude-code
Open on GitHub

What backlog does

The skill routes backlog items automatically. It checks for BACKLOG.md or docs/BACKLOG.md first. When found, it writes local entries with category prefixes like [bug] or creates numbered files matching 0001-slug.md. If no file exists in an original repository, it defaults to GitHub Issues.

Duplicate checks run before creating any entry via grep or gh issue list --search. Items fall into four fixed buckets: bug, enhancement, chore, and documentation. During reviews, open items appear ordered from oldest to newest, allowing you to triage stale records, cluster themes, or pick a ticket to start working.

GitHub integration relies on an authenticated gh CLI. If you need full product specs or PRD authoring, this tool will not generate them.

What it helps with

  • file bugs and feature requests directly into the backlog
  • search existing issues for duplicates before filing
  • triage stale tickets and confirm closing them
  • cluster open backlog tasks into common themes

Example prompts for the agent

  • Add a bug to the backlog: user avatar fails to render on Safari
  • Review the backlog and show open items by category
  • Triage open tasks and merge duplicate issues

How to install backlog

1Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill backlog -a claude-code

2Manually: put the files in place

~/.claude/skills/backlog/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/backlog/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about backlog

How to install backlog in Claude Code?

Run npx skills add sammcj/agentic-coding --skill backlog -a claude-code in your terminal or place the file into ~/.claude/skills/backlog/SKILL.md.

Where does the backlog skill save items?

It targets BACKLOG.md or docs/BACKLOG.md first. For personal non-fork repositories without local files, it creates GitHub Issues instead.

Can I use this skill to write PRDs?

No. The skill is strictly scoped to quick bug entries, chores, enhancements, and backlog triage rather than full specifications.

Source text

SKILL.md · Apache-2.0
---
name: backlog
description: Use when the user wants to add a bug or feature to the backlog, or list or triage the backlog. Not for PRDs or specs.
---

# Backlog

## Destination

First match wins:

1. `BACKLOG.md` or `docs/BACKLOG.md` -> local file.
2. The user's own repo, not a fork -> GitHub.
3. 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 -d` directory, then `gh issue create --body-file <file>`.

## Add

1. Search for dupes first. On a near match, ask: update it or file new.
2. Guess the category. Ask at most one question in total, only when scope or category is ambiguous.
3. File it. Reply with the URL or path only.

## Review

1. List open items, grouped by category, oldest first: number, title, age.
2. 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 with `Next: /opsx:propose from #<n>`.
   - **Themes**: cluster related items, suggest groupings.

## Notes

- Keep the contents concise, quick and easy to read.
- Use the users wording, if you have context you may add it, if clarification is required: ask, do not make up requirements.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Similar skills

All skills for Git and GitHub →

backlog by other authors comes first.

backlog nschurmann The backlog skill for Claude Code turns ideas or features into a list of short, vertical user stories. It slices requirements into independent units of work. CX Codex +1 ★ 265repo stars backlog-swipe-triage official James Montemagno backlog-swipe-triage is a GitHub Copilot plugin for swiping through backlog issues to assign, request details, defer, close, or ignore them. It helps process a long issue list without opening each issue. ★ 41,430repo stars github-backlog-grooming microsoft github-backlog-grooming audits open GitHub issues against repository code and pull requests, generating an advisory report without mutating tickets. CX Codex +1 ★ 1,627repo stars backlog-plan microsoft backlog-plan plans backlog work in Azure DevOps, GitHub, and Jira without modifying remote trackers. Generates local plan files for sprints, triage, and task handoffs. CX Codex +1 ★ 1,627repo stars oh-my-issues thedotmack oh-my-issues — a skill for Claude Code and Codex clusters GitHub issue backlogs by root cause into plan-master issues. Runs during backlog triage and consolidation. CX Codex +1 4,500installs speckit.taskstoissues alfredoperez speckit.taskstoissues turns the task list from tasks.md into numbered GitHub issues while keeping dependency order. Handy when the plan is already broken into tasks but the tracker is empty. CX Codex +1 ★ 110repo stars om-prepare-issue open-mercato om-prepare-issue turns a brief into an actionable tracker issue without writing code. It dedupes against existing backlog tasks and attaches codebase guidance with SDLC labels. CX Codex +1 3,700installs

From the same set73

The whole set →
deeper Rewrites your prompt so the task gets deeper rather than longer. It adds the methods a specialist would use and a way to check the result. CX Codex +1 ★ 173repo stars golang-development golang-development configures build flags, modernize checks, and idiomatic Go practices in Claude Code. Helpful when writing services or tests in Go. CX Codex +1 ★ 173repo stars edit-article edit-article restructures draft articles around heading dependencies and rewrites each section into short paragraphs under 240 characters. CX Codex +1 ★ 173repo stars llm-prompting-guide llm-prompting-guide is a Claude Code skill with prompt format rules for MiniMax H3 and MiniMax Music 3. Consult it when drafting prompts for these models in ComfyUI or other tools. CX Codex +1 ★ 173repo stars github This skill sets rules for using gh to work with GitHub, from reading PR feedback to checking GitHub Actions. It fits tasks involving issues and code review. CX Codex +1 ★ 173repo stars compact-prep compact-prep — a Claude slash command that tidies the work state before the context window fills up, then hands you prompts for compacting the session and resuming it. CX Codex +1 ★ 173repo stars subagent-delegation subagent-delegation guides Claude Code in scoping sub-tasks, assigning file ownership, and choosing between clean named sub-agents or session forks. CX Codex +1 ★ 173repo stars openspeccer openspeccer opens a read-only local dashboard for an OpenSpec repository and reports active changes, artifacts, and tasks. Useful when you need project status. CX Codex +1 ★ 173repo stars

Project sponsors

Companies that keep this analytics open