Overskill

Overskill is a AI coding agent skills manager that lets you keep skills in sync across repositories. It gives you a single place to write, version, and sync the instruction files that guide tools like Claude Code, Cursor, Codex, and Windsurf — then apply them to any repository with one command. Learn more at overskill.jacobchaselubitz.com.

Why Overskill?

• Write once, use everywhere. Create a skill once and add it to as many repositories as you need. When you improve it, update every project in seconds.
• Agent-agnostic. Skills are plain markdown files. They work with any agent that can read markdown — no plugin API, no vendor lock-in.
• Transparent and auditable. Skills live in your project as visible files you can read, diff, and review like any other code.
• Works offline. Once synced, skills are local files with no runtime dependency on external services.

Upgrading

Run skill upgrade in each repository that uses Overskill. This migrates your global registry (if needed) and updates the project to the latest format — moving skills to .claude/skills/, removing .skills.lock, and syncing everything.

cd your-project
skill upgrade

How it works

Overskill maintains a global registry on your machine (in ~/.overskill/registry/). When you create or import a skill, it's saved there. When you run skill add and skill sync in a repository, Overskill writes the skills into .claude/skills/<slug>/SKILL.md and generates a SKILLS_INDEX.md in that same directory.

.claude/skills/ is the single source of truth for all agents. Overskill configures your IDE to point agents at .claude/skills/SKILLS_INDEX.md so they can discover available skills. Run skill init and Overskill will set this up in your agent config files (CLAUDE.md, AGENTS.md, .cursor/rules/).

Documentation

1. Getting Started — Install Overskill and add it to your first project
2. Configuration — View and change global settings like your default editor
3. Managing Skills in a Repository — Initialize a repo, import existing skills, create new ones, add and remove skills
4. Syncing and Updating — Check installed versions, sync skills, and update to the latest
5. Editing Skills — Edit a skill, publish a new version, and apply changes to a project
6. Command Reference — Full list of commands and flags

Quick start

# Install
npm install -g overskill

# Or install with Homebrew
brew tap jchaselubitz/tap
brew install overskill
  
# Initialize in a project
cd your-project
skill init

# Import skills you've already written for Claude, Cursor, or Codex
skill import

# Or create a new skill from scratch
skill new my-skill

# Add skills to the project
skill add my-skill

# Modify a skill
skill open my-skill    # opens in your editor
skill save my-skill    # saves changes to the registry
skill sync             # run in any project that uses this skill

License

MIT