Felipe Martin
2494760df1
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>
46 lines
801 B
Markdown
46 lines
801 B
Markdown
---
|
|
name: tool-name
|
|
last_verified: YYYY-MM-DD
|
|
# Optional: omit when a useful version cannot be determined.
|
|
last_verified_version: "x.y.z"
|
|
sources:
|
|
- 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
|
|
|
|
```sh
|
|
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
|
|
|
|
```sh
|
|
tool-name --help
|
|
tool-name subcommand --help
|
|
```
|
|
|