CLI

The Skill Studio CLI does the same jobs as the app, from the terminal. It uses the same history, so you can undo a CLI change in the app.

Run it

The CLI needs Node.js and macOS. Run it with npx. You do not need to install it first.

npx skill-studio diagnose

To see all commands:

npx skill-studio --help

Check your skills

List every skill, with the path and id of each copy:

npx skill-studio scan

Find problems, for example broken links or bad frontmatter:

npx skill-studio diagnose

Find skills that have copies with different content:

npx skill-studio conflicts

Find unused skills

Show which skills your agents used in the last 30 days, and which they did not. Unused skills come first.

npx skill-studio usage

To use a different number of days:

npx skill-studio usage --days 7

Fix a skill

npx skill-studio fix --skill my-skill

The CLI repairs what it can. If it cannot fix a problem, it prints the path to the file, so you can fix it yourself.

Park and unpark

Park a skill to hide it from every agent. The CLI does not delete it. You can park a skill that is in the shared .agents/skills folder.

npx skill-studio park my-skill

To use the skill again, or to undo a park:

npx skill-studio unpark my-skill

If more than one copy has the same name, the CLI lists each copy with its path and id. Run the command again with the id:

npx skill-studio park --id <id>

Turn a skill off for one agent

npx skill-studio disable my-skill --agent codex

To turn it on again:

npx skill-studio enable my-skill --agent codex

The agent can be claude-code, codex or opencode. For other agents, park the skill.

Undo

Undo the last change:

npx skill-studio undo

To undo an older change, list the history, then restore one event:

npx skill-studio events
npx skill-studio restore --event-id <id>

Keep skills current

Find skills that have a newer version:

npx skill-studio outdated

Update a skill that you installed from skills.sh:

npx skill-studio update --skill my-skill --method skills-sh

Add and remove

Install a skill from a GitHub repository:

npx skill-studio add owner/repo --name my-skill

Remove a skill that you installed with Skill Studio, npx skills or dotagents:

npx skill-studio remove my-skill

To get the skill back, run undo.

Use it in scripts

Add --json to get output that a script can read:

npx skill-studio diagnose --json

diagnose, conflicts and fix exit with code 1 when they find a problem. Other errors use codes 2 and higher.