Agent skill

Backlog

by jiangzhe in jiangzhe/doradb

Manage backlog todo documents in docs/backlogs with deterministic tooling.

Apache-2.0Auto-check passedDevelopment

Install Backlog

skills CLI
$ npx skills add jiangzhe/doradb --skill backlog -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jiangzhe/doradb backlog --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jiangzhe/doradb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/backlog .claude/skills/backlog && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
backlog
GitHub stars
121
Token cost
~1k tokens
SKILL.md length
407 words
Files
3 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Manage backlog todo documents in docs/backlogs with deterministic tooling.

  • Works in 2 steps: backlog create: create a new backlog… → backlog close: close/archive an open…
  • Manually creating backlog items with duplicate checks
  • SKILL.md covers backlog create Required Flow, backlog close Required Flow, Output Quality Bar and Reference
  • Calls cargo

What it does

Backlog is an agent skill from jiangzhe/doradb. Manage backlog todo documents in docs/backlogs with deterministic tooling. Use when manually creating backlog items with duplicate checks, especially deferred follow-ups discovered during in-progress task/RFC work that need recoverable context, or closing/archiving backlog items with explicit reasons.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/workflow.md`).

It sits in Development. The repository describes itself as: DoraDB - Async Rust storage engine. The licence is Apache-2.0.

When your agent uses it

  • Manually creating backlog items with duplicate checks
  • Especially deferred follow-ups discovered during in-progress task/RFC work that need recoverable context
  • Closing/archiving backlog items with explicit reasons

Example prompts

  • “/backlog”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. backlog create: create a new backlog todo with duplicate check.
  2. backlog close: close/archive an open backlog item with reason.

What it can do on your machine

Read from SKILL.md and the folder at commit 3291b68. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Backlog loads about 1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 78 tokens; SKILL.md has 407 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jiangzhe/doradb at commit 3291b68, republished under its Apache-2.0 licence (© jiangzhe). 407 words, ~1,010 tokens.

Download SKILL.mdSave it as .claude/skills/backlog/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
backlog
description
Manage backlog todo documents in docs/backlogs with deterministic tooling. Use when manually creating backlog items with duplicate checks, especially deferred follow-ups discovered during in-progress task/RFC work that need recoverable context, or closing/archiving backlog items with explicit reasons.

Backlog Workflow

Use this skill for backlog lifecycle operations. Scripts are executable; invoke them directly (no cargo +nightly -Zscript prefix).

This skill has two prompt workflows:

  1. backlog create: create a new backlog todo with duplicate check.
  2. backlog close: close/archive an open backlog item with reason.

backlog create Required Flow

  1. Understand and confirm the user's backlog intention first.
  2. Classify the backlog item before collecting fields:
    • standalone follow-up backlog item, or
    • intentionally deferred work from active task/RFC execution.
  3. Collect required base fields:
    • title
    • slug
    • summary
    • reference
    • scope hint
    • acceptance hint
    • optional notes
  4. If the backlog item is intentionally deferred from active task/RFC work, require deferred-work context:
    • deferred from: source task doc, source RFC doc/phase, or both.
    • defer reason: why the work is postponed now.
    • findings: what current execution learned and should not be lost.
    • direction hint: what future task/RFC planning should revisit, prefer, or avoid.
  5. Run duplicate detection on open backlog docs only:
bash
tools/backlog.rs find-duplicates \
  --title "Backlog title" \
  --slug "backlog-title"
  1. If duplicate candidates exist, show candidates and ask whether to continue.
  2. Create the backlog doc with allocated id:
bash
tools/backlog.rs create-doc \
  --title "Backlog title" \
  --slug "backlog-title" \
  --summary "..." \
  --reference "..." \
  --scope-hint "..." \
  --acceptance-hint "..." \
  --auto-id

When the item is intentionally deferred from active task/RFC work, also pass:

bash
  --deferred-from "docs/tasks/000040-example.md; docs/rfcs/0006-example.md phase 2" \
  --defer-reason "..." \
  --findings "..." \
  --direction-hint "..."
  1. If docs/backlogs/next-id is missing, initialize it first:
bash
tools/backlog.rs init-next-id

Ensure deferred-work backlog docs preserve enough context for a future task or RFC to recover the right design direction instead of re-discovering the same issue from scratch. For multiline text, markdown, Rust code, or any text containing backticks, prefer the file-backed flags (--summary-file, --reference-file, --notes-file, --deferred-from-file, --defer-reason-file, --findings-file, --direction-hint-file) instead of inline shell arguments. Default safe pattern: write the text with a quoted heredoc such as <<'EOF' to a temp file, then pass the file path to tools/backlog.rs create-doc.

Show full SKILL.md (130 more words)Show less

backlog close Required Flow

  1. Resolve and confirm the target is an open backlog doc in docs/backlogs/.
    • If user input is id-only shorthand (for example backlog close 000123 ...), resolve first:
bash
tools/doc-id.rs search-by-id --kind backlog --id 000123 --scope open
  1. Require explicit close reason type and detail.
  2. Close/archive with:
bash
tools/backlog.rs close-doc \
  --path docs/backlogs/000123-example.md \
  --type stale \
  --detail "Superseded by later design"
  1. Ensure file moves to docs/backlogs/closed/ and includes ## Close Reason. If detail or reference text is longer than a short phrase or contains markdown/backticks, use --detail-file and --reference-file.

Output Quality Bar

Ensure every backlog document is:

  1. Specific about why the follow-up exists now.
  2. Linked to source task/RFC work when it was intentionally deferred from active execution.
  3. Explicit about why the work was deferred and what was learned.
  4. Useful as future planning input rather than just a reminder title.

Reference

Read references/workflow.md for detailed create/close checklists.

© jiangzhe, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/backlog of jiangzhe/doradb.

  • SKILL.md
  • agents/openai.yaml
  • references/workflow.md

Open the folder on GitHubat commit 3291b68

Compare with similar skills

Backlog next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Backlog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Backlog this skilljiangzhe/doradb121—~1kAutomated safety check: PassApache-2.0
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from jiangzhe/doradb

All 10 skills in this repo
  • Issue Rfc

    jiangzhe/doradb

    Create and list GitHub Issues for Doradb RFC documents with deterministic scripts.

    121 GitHub stars~519 tokensUpdated 3 days ago
    Auto-check passed
  • Issue Task

    jiangzhe/doradb

    Create and list GitHub Issues for Doradb task documents with deterministic scripts.

    121 GitHub stars~719 tokensUpdated 3 days ago
    Auto-check passed
  • Rfc Create

    jiangzhe/doradb

    Design and formalize Doradb RFC documents through evidence-gated research, materially different architectural proposals, two review rounds, and explicit draft and formalization approvals.

    121 GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Rfc Resolve

    jiangzhe/doradb

    Resolve completed or superseded Doradb RFC programs after implementation tasks, tests, review, and verification are complete.

    121 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • Style Audit

    jiangzhe/doradb

    Audit branch-diff Rust files, or explicitly requested file/directory Rust targets, for Doradb coding style using deterministic tooling and concise read-only review.

    121 GitHub stars~951 tokensUpdated 3 days ago
    Auto-check passed
  • Task Prune

    jiangzhe/doradb

    Inspect and optionally remove completed Doradb task worktrees and their local branches with deterministic safety checks.

    121 GitHub stars~551 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Backlog

What does Backlog do?

Manage backlog todo documents in docs/backlogs with deterministic tooling. Backlog is an agent skill from jiangzhe/doradb. Manage backlog todo documents in docs/backlogs with deterministic tooling.

When should I use Backlog?

Backlog fits situations like: manually creating backlog items with duplicate checks; especially deferred follow-ups discovered during in-progress task/RFC work that need recoverable context; closing/archiving backlog items with explicit reasons.

How do I install Backlog in Claude Code?

Run `npx skills add jiangzhe/doradb --skill backlog -a claude-code`. Or copy the skill folder (.agents/skills/backlog in jiangzhe/doradb) into .claude/skills/backlog in your project. Claude Code loads it when a task matches its description.

How do I install Backlog in Codex?

Run `npx skills add jiangzhe/doradb --skill backlog -a codex`. Or copy the skill folder (.agents/skills/backlog in jiangzhe/doradb) into .agents/skills/backlog in your project. Codex loads it when a task matches its description.

Can I use Backlog in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jiangzhe/doradb --skill backlog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/backlog, .gemini/skills/backlog, .github/skills/backlog and .opencode/skills/backlog in your project.

What does Backlog need to run?

Going by SKILL.md and its folder, Backlog needs the command-line tools its instructions call (cargo).

Does Backlog access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Backlog safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Backlog use?

Backlog is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Backlog use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 855 tokens, read only when the agent opens those files.

What are the alternatives to Backlog?

Skills that share tags, products or a category with Backlog: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Backlog?

jiangzhe (a GitHub user) maintains it in jiangzhe/doradb, which has 121 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 5, 2026.

Source: jiangzhe/doradb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.