Skip to main content

Agent skill

Commands use stim. If it is not installed globally, replace stim with npx stim-cli.

For AI coding agents, install the bundled skill so the agent knows how to drive the CLI (the lifecycle, the facts contract, and the destructive-command rules). It installs with the skills CLI, straight from GitHub:

npx skills add appandflow/stim

Keeping the agent skill in sync

The skill other AI agents read ships inside the npm package. Because it is installed by copy, upgrading stim-cli does not refresh it -- a 0.14.0 CLI happily runs against a skill from 0.6.x, and the only symptom is an agent following instructions that no longer match the binary.

After upgrading, refresh it the same way it was installed:

npx skills add appandflow/stim

That installs the one bundled skill, stim-cli: how to drive the CLI. There is no separate setup skill -- stim-cli needs no project changes, and the handful of things it cannot handle itself are what stim doctor reports, at the moment they matter.

The skill is deliberately thin: it carries the rules that don't change (the ownership model, the destructive-command rules, the parallel-agent rules) and defers everything version-specific to stim guide <topic>, which is generated by the installed binary and so cannot drift.