Skills manager for AI coding agents

Write skills once.
Use them everywhere.

Version, share, and sync reusable AI skill files across every repo and every agent.

$npm install -g overskill

Get started

Works withClaude CodeCursorCodexWindsurf

Install and initialize

Get up and running in under a minute.

01 — Install

Install the CLI globally via npm or Homebrew.

# npm
$ npm install -g overskill

# OR - Homebrew
$ brew tap jchaselubitz/tap
$ brew install overskill

# Verify
$ skill --version
overskill v1.0.1

02 — Initialize a project

Run skill init in your project root. This creates .skills.yaml.

$ cd my-project
$ skill init

  ✓ Created .skills.yaml
  ✓ Added local source

Import and sync skills across your repositories

Import existing instructions or create new ones — then sync them into any project.

03 - Import existing skills

Your existing repo structure

my-project/
  .claude/
    skills/
      code-review.md
      edge-functions.md
      gemini-api.md
  AGENTS.md

Import into Overskill

$ skill import

Found 4 skill(s):

Claude Skills (.claude/skills):
  [1] code-review
  [2] edge-functions
  [3] gemini-api

> all

  ✓ Imported 4 skill(s):
    code-review
    edge-functions
    gemini-api

Result

my-project/
  .skills/
    SKILLS_INDEX.md
    code-review/
      SKILL.md
      meta.yaml
    edge-functions/
      SKILL.md
      meta.yaml
    gemini-api/
      SKILL.md
      meta.yaml

04 - Create a skill

1. Create

$ skill new code-review

  ✓ Created code-review v1.0.0
  ✓ Opening in editor...

2. Edit as Markdown - code-review/SKILL.md

# Code Review

## When to use
Run this skill when reviewing pull requests
or when asked to review code.

## Instructions
- Check for security vulnerabilities
- Verify error handling is complete
- Flag any missing test coverage
- Suggest performance improvements
- Keep feedback constructive and specific

## Output format
Use a structured review with sections:
**Security**, **Logic**, **Tests**, **Style**

3. Add to a project & sync

$ skill add code-review
$ skill sync

  ✓ Installed code-review@1.0.0
  ✓ Updated CLAUDE.md
  ✓ Updated .cursor/rules/overskill.mdc
  ✓ Generated SKILLS_INDEX.md

Result

my-project/
  .skills/
    SKILLS_INDEX.md
    code-review/
      SKILL.md
      meta.yaml
  CLAUDE.md              # auto-updated
  .cursor/rules/
    overskill.mdc        # auto-updated

Update skills and keep projects in sync

Edit a skill, publish a new version, and sync updates across every project that uses it.

05 - Publish an update

1. Edit the skill

$ skill edit code-review

  ✓ Opening code-review/SKILL.md in editor...

2. Publish a new version

$ skill publish code-review

  code-review 1.0.0 → 1.1.0
  ✓ Published code-review@1.1.0

3. Push to cloud

$ skill push code-review

  ✓ Pushed code-review@1.1.0 to registry

06 - Sync updates in a project

Check for updates

$ skill diff code-review

  code-review: 1.0.0 → 1.1.0
  + Added security checklist section
  ~ Updated output format

Update and sync

$ skill update
$ skill sync

  ✓ Updated code-review 1.0.0 → 1.1.0
  ✓ Updated CLAUDE.md
  ✓ Updated .cursor/rules/overskill.mdc
  ✓ Regenerated SKILLS_INDEX.md

Agent-agnostic

Skills are plain markdown. No plugin API, no vendor lock-in. They work with any agent that reads files.

Version-controlled

Semver versioning with lockfiles and content hashes. Pin versions. Roll back. Treat AI instructions like dependencies.

Local-first

Everything works offline. Content-addressed storage on your machine. Cloud is additive for sharing.

Start managing your AI skills

Install the CLI and create your first skill in under a minute.