← use cases · completions
Tab completion for a CLI that never shipped one
Generate a SKILL.md for a tool with no completion script, and get contextual Tab completions from its own docs.
Who it's for
Anyone who lives in a CLI — kubectl, terraform, aws, gh — that either has no shell completion or one that lags the real flags.
The problem
Most CLIs either ship no completion script or ship one that drifts from the actual documented flags. Writing one by hand means reading the whole man page and maintaining it forever.
How skillterm does it
- 1
Run skillterm generate <tool>; the agent runtime searches for the canonical docs, fetches them, and reads man / --help.
- 2
The agent writes a Claude-compatible SKILL.md capturing subcommands, flags, and examples, following the skill-creator format spec.
- 3
The shell hook (installed via skillterm init zsh|bash|fish) calls skillterm complete on each Tab.
- 4
Completions are sourced from the matching SKILL.md — generated once, served forever.
generate and use
$ skillterm generate kubectl → agent: WebSearch → WebFetch → Bash(man) → Write SKILL.md$ kubectl get <TAB> → completions from ~/.skillterm/skills/kubectl/SKILL.md
The outcome
A tool with no completion support becomes Tab-aware, and the completions come from the same document a human can read as reference.