Keep coding agent skills in sync across repositories

Write skills once.
Use them everywhere.

Problem: Keeping skills in sync across repositories and agents is a pain.

Solution: Create and sync reusable AI skill files across every repo and every agent.

$npm install -g overskill

Get started Read the docs

Works withClaude CodeCursorCodexEverything else

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 3 skill(s):

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

> all

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

Result

my-project/
  .claude/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 new skill

1. Create

$ skill new code-review

  ✓ Created code-review
  ✓ 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
  ✓ Updated CLAUDE.md
  ✓ Updated .cursor/rules/overskill.mdc
  ✓ Generated SKILLS_INDEX.md

Result

my-project/
  .claude/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, save your changes, and sync updates across every project that uses it.

05 - Edit and save

1. Open the skill

$ skill open code-review

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

2. Save changes to the registry

$ skill save code-review

  ✓ Saved code-review to registry

06 - Sync updates in a project

Pull latest into your project

$ skill sync

  ✓ Synced code-review
  ✓ Synced deploy-checklist
  ✓ 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.

Content-addressed

Lockfiles with content hashes ensure integrity. Always in sync. 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.