dotfiles/agents/knowledge/cli/_template.md
Felipe Martin 2494760df1
Manage ~/.agents so skills follow the machines, and keep knowledge in git.
npx-managed skills stay copies so an installer update cannot land in the repo by accident; knowledge is a symlink outside home/ so maintain writes are tracked instead of dying on the next apply. Verified the live ~/.agents/knowledge link and that the lockfile is named dot_skill-lock.json so chezmoi does not ignore it.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-26 18:27:53 +02:00

801 B

name last_verified last_verified_version sources
tool-name YYYY-MM-DD x.y.z
https://official.example/docs

tool-name

Purpose

One sentence describing what the CLI does.

Environment

  • Authentication or configuration prerequisites.
  • Repository-specific conventions, if durable.

Common operations

Operation

tool-name subcommand --flag VALUE

Explain placeholders, expected effects, and safe verification.

Safety

  • Identify destructive or externally visible operations.
  • State preview, dry-run, or confirmation options when available.

Gotchas

  • Record durable version, shell, platform, or output-format caveats.

Discovery

tool-name --help
tool-name subcommand --help