backlog.md

Create, view, edit, and search backlog tasks via a CLI.

17|2|Updated Dec 27, 2013
One-click install
npx skills add https://github.com/l-lin/dotfiles --skill backlog-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backlog.md
Source: https://github.com/l-lin/dotfiles/tree/main/home-manager/modules/share/ai/backlog.md/.config/ai/skills/backlog.md
Command: npx skills add https://github.com/l-lin/dotfiles --skill backlog-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages backlog tasks via a Backlog.md CLI, enabling structured task creation, viewing, editing, and searching from the terminal.

Core Features & Use Cases

  • Create Task: add tasks with acceptance criteria and subtasks
  • View/Edit: view or modify metadata, statuses, labels
  • Search/List: keyword search and list with plain AI-friendly output

Quick Start

Create a new task with backlog task create "Title" -d "Description" --ac "Criterion" and view with backlog task 42 --plain.

Frequently Asked Questions about backlog.md

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

FAQPage Schema
How do I manage project tasks from the command line with structured metadata?

Backlog.md provides a CLI to manage tasks from the terminal with structured metadata including titles, descriptions, acceptance criteria, subtasks, and status tracking. Create tasks with `backlog task create`, view with `backlog task [id] --plain`, and search by keyword to keep your backlog organized without leaving the shell.

Can I track acceptance criteria and subtasks for individual backlog items?

Yes. Backlog.md lets you define acceptance criteria per task using the `--ac` flag and break work into subtasks with the `-p` flag. Each task stores structured data including priority, assignee, labels, and status, making it easy to track what done looks like before you start.

What's the best way to link JIRA tickets to CLI-managed tasks?

Backlog.md expects JIRA ticket references in task titles by convention. Include your ticket ID in the title when you create a task, and the plain-text output preserves that reference, creating a traceable link between your CLI backlog and JIRA without extra sync overhead.

How do I search and filter tasks in a large backlog from the command line?

Backlog.md supports keyword search and filtering by status, assignee, labels, and priority. Use `backlog task search [keyword]` to find tasks and combine flags like `-s`, `-a`, and `-l` to narrow results, keeping your terminal workflow unbroken.

Can I use draft mode to save incomplete tasks without finalizing them?

Yes. The `--draft` flag lets you save tasks in progress without marking them ready for work. Draft tasks stay in your backlog but are flagged separately, so you can capture ideas and refine them later before assigning or scheduling.

Does Backlog.md support multi-line task descriptions and acceptance criteria?

Yes. Backlog.md handles multi-line content using ANSI-C quoting syntax. Wrap descriptions and acceptance criteria in `$'...'` to include newlines and special characters, and the plain-text output renders them correctly for both human review and AI processing.