skill

Overview ¶

Package skill implements the `bitbottle skill` command tree, which installs, refreshes, and removes the bundled bitbottle agent skill (the SKILL.md + references that teach AI agents how to drive bitbottle correctly).

Why this command exists: the npm postinstall already wires the skill on initial install, but users who installed via Homebrew, Go install, deb/rpm, or the bare binary won't have it. They also need a discoverable way to refresh after a release rather than memorizing the npx incantation.

The implementation is a thin, intentional wrapper over the vercel-labs/skills CLI. We don't reimplement its runtime detection — there are 50+ agent runtimes with non-trivial install paths each, and that ecosystem is moving fast. Shelling out keeps us aligned.