Skip to content

About

Tidy up your agent skills. A macOS app, CLI, and MCP server that finds broken, duplicate, and unused skills across Claude Code, Codex, Cursor, and more, then fixes or parks them with undo.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

259 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skill Studio

Tidy up your agent skills. Skill Studio finds broken, duplicate, and unused skills across Claude Code, Codex, OpenCode, pi, Cursor, and Grok Build. Then it helps you fix or park them, and you can undo every change.

It comes as a macOS app, a CLI, and an MCP server. All three use the same Rust core.

Website · Docs · Download for Apple silicon · Download for Intel

What it does

  • See every skill in one list. Global and project skills for Claude Code, Codex, OpenCode, pi, Cursor, Grok Build, and the shared .agents/skills folder. Each skill shows where it came from: skills.sh, dotagents, a Claude Code or Codex plugin, the project repo, or a manual copy.
  • Find problems. Broken SKILL.md frontmatter, agentskills.io spec violations, conflicts between copies of the same skill, outdated installs, and skills that your agents never use.
  • Fix them. Preview a frontmatter repair before you apply it, or edit SKILL.md in the app or in your editor.
  • Park a skill. Parking moves a skill out of the folders that agents read, so it is off for every agent. Unpark puts it back.
  • Install and update. Search the skills.sh store, install a skill to global or project scope, update one skill or all of them, and remove skills you do not need.
  • Undo. The Activity view records every change. You can restore any of them.
  • Manage plugins. Enable, update, or uninstall the Claude Code and Codex plugins that ship skills.

Install

macOS app

Download the DMG for Apple silicon or Intel. The app needs macOS 13 or later and updates itself.

The app sends anonymous crash reports. They do not include skill names, files, or paths. To stop them, turn off Settings > Telemetry, or turn them off on the first screen.

CLI

# Run once
npx skill-studio diagnose

# Or install it
npm install -g skill-studio
Command What it does
scan List every installed skill
diagnose Find broken skills and spec violations
conflicts Find copies of the same skill that do not match
usage Show how often each skill is used
fix Repair broken frontmatter
park / unpark Turn a skill off or on for every agent
add Install a skill
outdated / update Find and apply skill updates
remove Remove a skill
events / restore Show the change history and restore a change
undo Undo the last change
mcp Start the MCP server

See the CLI docs.

MCP server

Connect Skill Studio to your agent. Then you can ask the agent to check, fix, and park your skills.

# Claude Code
claude mcp add --transport stdio skill-studio -- npx -y skill-studio mcp

# Codex
codex mcp add skill-studio -- npx -y skill-studio mcp

See the MCP docs for other agents.

Development

Prerequisites

  • Node.js ^22.18 or >=24.11 (the Vite 8 and Babel 8 toolchain needs this range)
  • pnpm 11 (pinned in packageManager in package.json; enable it with corepack enable)
  • Rust
  • Tauri prerequisites

Setup

pnpm install

# Run the desktop app in development mode
pnpm run tauri dev

# Run the full local gate (TypeScript and Rust)
pnpm run check

Fixture launch mode

Set SKILL_STUDIO_FIXTURE to a folder to use that folder as HOME. Every scan and change then stays inside the fixture, so you can work against a known skill layout and not touch your real ~/.claude, ~/.codex, and other agent folders.

SKILL_STUDIO_FIXTURE=/path/to/fixture-home pnpm run tauri dev

The MCP server and the TUI also read SKILL_STUDIO_FIXTURE.

Repository layout

Path Contents
apps/desktop Tauri 2 app: React in src/, Rust in src-tauri/
apps/cli skill-studio CLI
apps/mcp MCP server over stdio
apps/server skills.sh API proxy (Cloudflare Worker)
apps/tui Terminal UI
crates/skill-studio-core Shared core: scan, diagnose, park, install, events
crates/skill-studio-host Real file system, process, and telemetry adapters
packages/marketing Website and docs at useskillstudio.com
packages/npm npm packages for the CLI
packages/lib, packages/ui Shared TypeScript code and UI components
docs/ Specs and flows.md, the list of every user flow

Contributing

See CONTRIBUTING.md for setup, the local gate, and how a change lands. This project follows the Contributor Covenant.

Security

See SECURITY.md to report a vulnerability.

License

MIT

About

Tidy up your agent skills. A macOS app, CLI, and MCP server that finds broken, duplicate, and unused skills across Claude Code, Codex, Cursor, and more, then fixes or parks them with undo.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages