Features
Create, edit, share, and sync — from solo projects to large teams.
Already have instructions scattered across CLAUDE.md and .cursorrules? Import them. Starting fresh? The editor opens automatically.
# Create a new skill from scratch
$ skill new deploy-checklist
✓ Created deploy-checklist
✓ Opening in editor...
# Import existing agent instructions
$ skill import
Found 3 instruction files:
CLAUDE.md → claude-setup
.cursorrules → cursor-config
codex.md → codex-rules
✓ Imported 3 skills
# Create from a file
$ skill new api-guide --content ./API_RULES.mdOpen any skill in your editor from anywhere — no project required. Make your changes, then save them back to the registry.
# Open a skill in your editor (works globally)
$ skill open code-review
✓ Opening code-review/SKILL.md in editor...
# After editing, save changes to the registry
$ skill save code-review
✓ Saved code-review to registry
# .skills.lock (auto-generated)
skills:
- slug: code-review
sha256: "a1b2c3..."skill sync pulls the latest content for each skill from the registry into your project and auto-wires agent configs. Every agent discovers skills immediately.
$ skill sync
✓ Synced code-review
✓ Synced deploy-checklist
✓ Synced api-standards
✓ Synced testing-guide
✓ Updated CLAUDE.md
✓ Updated AGENTS.md
✓ Updated .cursor/rules/overskill.mdc
✓ Generated SKILLS_INDEX.mdOverskill automatically updates CLAUDE.md for Claude Code, AGENTS.md for Codex, and .cursor/rules/ for Cursor. Skills just work.
# After sync, your project has:
CLAUDE.md ← managed section added
AGENTS.md ← managed section added
.cursor/rules/
overskill.mdc ← auto-generated
.skills/
SKILLS_INDEX.md ← agent reads this first
code-review/
SKILL.md ← full instructions
meta.yaml ← tags, compat info
deploy-checklist/
SKILL.md
meta.yamlEach skill has a readable SKILL.md alongside its metadata. Content hashes ensure integrity. All writes are atomic.
~/.overskill/registry/
skills/
code-review/
SKILL.md # working copy
meta.yaml # name, description, tags, sha256
deploy-checklist/
SKILL.md
meta.yaml