Add Command
Step-by-step checklist for adding a new command to the Doist todoist-cli codebase
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 31, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · c29142d
Fetched the real SKILL.md from .agents/skills/add-command/ (the .claude copy is a pointer stub). Spot-checked referenced files via raw fetch: errors.ts, permissions.ts, skills/content.ts, output.ts, api/core.ts all HTTP 200, but step 1's src/__tests__/helpers/mock-api.ts is 404 (real path is src/test-support/mock-api.ts) and the src/__tests__/ test dir doesn't exist — tests are co-located (e.g. src/commands/add.test.ts). In a clone I verified permissions.ts default-denies unknown methods (line 92) and that sync:skill / check:skill-sync are real npm scripts. For output I wrote two patch artifacts for adding a `td label count` subcommand: baseline touches 3 files; skill-followed touches 8 files plus `npm run sync:skill` — the extra permissions.ts allowlist entry prevents the read-only command being wrongly blocked under a read-only OAuth token, and the sync step prevents CI check:skill-sync from failing the PR. Trigger judged 5/5 (loads for "add a td subcommand"/"new SDK endpoint", correctly ignores "add a task to my Todoist" and "write a React component").
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 4/5
- Triggers reliably 5/5
- Output vs. baseline 7/10
- Docs & honesty 4/5
What Add Command does
A repository-specific checklist for adding new CLI commands or subcommands to the Doist todoist-cli TypeScript project. It enumerates every cross-cutting file to touch — mock API, spinner messages, the read-only permission allowlist, error codes, tests, and the generated skill file — and triggers when implementing a new SDK endpoint or extending the CLI. Applies only inside a clone of Doist/todoist-cli, not to general CLI development or Todoist usage.
How to install Add Command
git clone --depth 1 https://github.com/Doist/todoist-cli.git /tmp/add-command-src
mkdir -p ~/.claude/skills
cp -R /tmp/add-command-src/.agents/skills/add-command ~/.claude/skills/add-command
# The full guide lives at .agents/skills/add-command/SKILL.md; the .claude/skills copy is only a pointer stub.
# Repo-specific: only useful while working inside a clone of Doist/todoist-cli. No external deps or API keys.
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Add Command
-
/add-commandStep-by-step checklist for adding a new command to the Doist todoist-cli codebase
It also activates on plain-language prompts like these:
-
Add a new subcommand to todoist-cli -
Implement this SDK endpoint as a CLI command -
Extend the label command group with a new option
Frequently asked questions
- Is the Add Command skill free?
- Yes. The skill itself is free from Doist/todoist-cli. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Add Command work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 31, 2026. Verdict: Tested · Works. Fetched the real SKILL.md from .agents/skills/add-command/ (the .claude copy is a pointer stub). Spot-checked referenced files via raw fetch: errors.ts, permissions.ts, skills/content.ts, output.ts, api/core.ts all HTTP 200, but step 1's src/__tests__/helpers/mock-api.ts is 404 (real path is src/test-support/mock-api.ts) and the src/__tests__/ test dir doesn't exist — tests are co-located (e.g. src/commands/add.test.ts). In a clone I verified permissions.ts default-denies unknown methods (line 92) and that sync:skill / check:skill-sync are real npm scripts. For output I wrote two patch artifacts for adding a `td label count` subcommand: baseline touches 3 files; skill-followed touches 8 files plus `npm run sync:skill` — the extra permissions.ts allowlist entry prevents the read-only command being wrongly blocked under a read-only OAuth token, and the sync step prevents CI check:skill-sync from failing the PR. Trigger judged 5/5 (loads for "add a td subcommand"/"new SDK endpoint", correctly ignores "add a task to my Todoist" and "write a React component").
- What is the Add Command SkillProof Score?
- 8.0/10 — installs cleanly 4/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 4/5.
- How do I install Add Command?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Add Command with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.