sauce skills installs, updates or checks the package’s agent skills in your project.
Synopsis
Description
The package ships 13 agent skills as Agent Skills directories, each aSKILL.md with its examples and references. sauce skills copies the skills of the sauce command that runs it into a project, where coding agents read them:
Those two directories reach all five agents, and they are what the default
--agent all writes. An agent named alone gets only the directory it reads. --agent agents-md is written only when you name it: it writes .agents/skills/ and an index of the skills into a marked block of AGENTS.md, for a tool that reads AGENTS.md but no skills directory.
Each skills directory also gets a tsconfig.json, the SauceScript project that sauce init <dir> --tsconfig writes, so an editor types the skills’ example programs. It is installed, updated and reported like a skill file. Each directory records what it was given in .sauce-skills.json: the package, its version and the sha256 of each file as written. That record is how update tells a package upgrade (a file still as installed) from your edit (a file that changed). Skills of your own in the same directories are never touched.
The three subcommands:
update and status act on the targets already installed. In a project that pins the package, npx sauce skills install installs that version’s skills, and a global sauce skills status there reports skills installed from another version.
Options
Output
install and update print one line per target and one line per file they wrote, updated, removed or kept. update prints a summary per target: added N, updated N, removed N, kept N modified. status prints one line per target.
Examples
Install the skills in a project
install with no --agent writes both directories.
Check the skills
install writes nothing and exits 0:
Update after an edit
After a line was appended to.claude/skills/sauce-cli/SKILL.md, status reports the file as modified and update keeps it.
--force replaces the edited file with the packaged one.
Install for one agent
Add the AGENTS.md index
In the same project, agents-md finds .agents/skills/ already current and adds the index.
SKILL.md. The command owns the block and nothing else in AGENTS.md.
Status in a project with no skills
Next steps
sauce init, which scaffolds a project and installs the skills in itsauce mcp, whose server serves the same skills with nothing installed- Agents
sauce update