1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# {{ name }}
{{ one_line_description_raw }}
{% if when_to_use_phrases %}
## When to use
Invoke this {{ noun }} when the user's task matches any of these triggers:
{% for phrase in when_to_use_phrases %}- {{ phrase }}
{% endfor %}
{% endif %}
## When NOT to use
- Do not use this {{ noun }} if the user only wants to *read* or *inspect* {{ display_name }} without performing an action — prefer reading docs directly.
- Do not use this {{ noun }} for tasks outside {{ category_hint }} it was built for.
## Installation
{% if has_cli %}Ensure `{{ cli_binary }}` is installed and available on PATH before invoking the examples below.
{% else %}This is a library, not a CLI. The agent uses it by importing from the host project, not by spawning a binary.
Import pattern:
```
{{ import_pattern }}
```
{% endif %}
{% if has_cli %}## Invocation
The exact command an agent should run to use this tool:
```
{{ invocation_command | default(value=cli_binary) }}
```
{% if documented_flags %}Run `{{ cli_binary }} --help` to discover the available flags. Documented flags (verified by `skillpack verify`):
{% for flag in documented_flags %}- `{{ flag }}`
{% endfor %}
{% endif %}{% if documented_subcommands %}
### Subcommands
This CLI uses subcommands. Each one has its own flags (verified by `skillpack verify`):
{% for sub in documented_subcommands %}{{ sub.indent }}- `{{ sub.name }}`{%- if sub.flags %} — flags: {% for f in sub.flags %}`{{ f }}`{% if not loop.last %}, {% endif %}{% endfor %}{% endif %}
{% endfor %}
Run `{{ cli_binary }} <subcommand> --help` for a subcommand's full options.
{% endif %}{% else %}## Usage
There is no CLI to invoke. Use the import pattern above and call the relevant API surface directly from the task.
{% endif %}
## Footguns / gotchas
{% for fg in footguns %}- {{ fg }}
{% endfor %}- Verify the tool is installed before relying on it; do not assume availability.
{% if has_cli %}- Prefer the documented `{{ cli_binary }}` flags; undocumented flags may change without notice.
{% endif %}- This file is authoritative for agent invocation; if it drifts from the CLI's real `--help`, run `skillpack verify` to catch it.