todo-create

Create structured todo Markdown files with YAML frontmatter in .claude/todos.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/lucasmccomb/ccgm --skill todo-create-lucasmccomb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-create
Source: https://github.com/lucasmccomb/ccgm/tree/main/modules/todos/skills/todo-create
Command: npx skills add https://github.com/lucasmccomb/ccgm --skill todo-create-lucasmccomb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Capture small review findings, PR comments, and tech-debt items that are too small for GitHub issues so they are not forgotten, and store them as discoverable, versioned todo files in the repository.

Core Features & Use Cases

  • Canonical writer for lightweight todos: creates .claude/todos/NNN-pending-{priority}-{slug}.md files with required YAML frontmatter so other skills can invoke it programmatically.
  • Automatic sequencing and filename rules: allocates zero-padded sequence numbers and enforces status/priority/slug conventions to keep todos consistent.
  • Context-aware metadata inference: infers priority, source, PR number, and touched files from conversation or structured input, and returns the created path when called from other skills.
  • Use cases: capturing a reviewer nitpick, saving an off-path debug finding, recording planning follow-ups, and integrating with triage and resolve workflows.

Quick Start

Run /todo-create with a concise description of the finding to write a new .claude/todos/NNN-pending-{priority}-{slug}.md file in the repository.

Frequently Asked Questions about todo-create

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

FAQPage Schema
How do I capture code review findings and PR comments as markdown files in a repository?

You can capture code review findings and PR comments as structured todo markdown files by writing them into the .claude/todos directory with enforced YAML frontmatter, zero-padded sequence numbers, and inferred priority metadata.

What is the best way to track small tech-debt items that are too small for GitHub issues?

Tracking small tech-debt items is best handled by creating lightweight todo markdown files directly in the repository, ensuring observations are versioned and discoverable rather than lost in ad-hoc notes or forgotten review nits.

How do I automate todo creation from a triage or code-review workflow?

To automate todo creation from a triage workflow, you can programmatically invoke a canonical writer that infers priority, source, PR number, and touched files from structured input, returning the created file path for downstream processing.

Does the todo markdown schema enforce filename conventions and YAML frontmatter?

Yes, the todo markdown schema enforces filename conventions such as NNN-pending-{priority}-{slug}.md and requires YAML frontmatter to maintain consistency across todos created for code review and planning notes.

Can I save debug findings and planning follow-ups without creating full GitHub issues?

You can save debug findings and planning follow-ups as structured markdown todos inside your repository's .claude/todos directory, providing a lightweight alternative to full GitHub issues for off-path observations.

When should I avoid using structured markdown files for repository todos?

You should avoid using structured markdown files for repository todos when items require extensive discussion threads, cross-references, or external visibility, as these lightweight files lack the collaborative tracking features of dedicated issue trackers.