skills

A CLI for managing AI coding assistant skills from a single source.

Both Claude Code and Codex support skills—reusable instructions that extend what the assistant can do. This tool keeps them in sync across tools, so you can maintain skills in one place (your dotfiles, a team repo) and push them everywhere.

• One source — No more copying files between ~/.claude/skills/ and ~/.codex/skills/
• Sync everywhere — Push to both tools with a single command
• Pull edits back — Edit a skill in Claude Code, pull it to your repo, push to Codex
• Team sharing — Point everyone at a shared repo; they all get the same skills
• Version control — Skills live in git, so you get history and can roll back

Install

cargo install skills

Quick Start

skills init          # Set up ~/.skills.toml
skills list          # See what you have
skills push          # Push skills to your tools

How It Works

Point the CLI at your source directories in ~/.skills.toml:

sources = [
    "~/dotfiles/skills",
    "~/work/team-skills",
]

Each skill is a folder with a SKILL.md file:

code-review/
  SKILL.md

---
name: code-review
description: Use when reviewing pull requests or code changes
---

# Code Review

When reviewing code, focus on:
- Correctness and edge cases
- Readability and maintainability
- Performance implications
- Security considerations

Provide specific, actionable feedback with line references.

Commands

Core Commands

Skill Management

Sharing & Import

Setup

Common Flags

• --tool <tool> — Target specific tool: claude, codex, or all (default)
• --project — Work with project-local skills (.claude/skills/, .codex/skills/)
• -n, --dry-run — Preview changes without writing
• -f, --force — Skip confirmation prompts (shows diff for overwrites)
• -y, --yes — Skip all prompts (use with --force for fully silent operation)

Typical Workflow

Create or edit a skill in Claude Code (it has a built-in skill editor), then sync:

skills pull          # Pull the new skill to your repo
skills push          # Push it to Codex

Or use two-way sync:

skills sync          # Sync based on timestamps

Handle conflicts:

skills sync --prefer-source   # Source wins on conflict
skills sync --prefer-tool     # Newest tool version wins

Templating

Skills can include tool-specific sections using MiniJinja:

{% if tool == "claude" %}
Use the Task tool for background operations.
{% elif tool == "codex" %}
Use /background for async tasks.
{% endif %}

Validate templates before pushing:

skills validate my-skill
skills render my-skill --tool claude

Supported Tools

Community

Want to contribute? Have ideas or feature requests? Come tell me about it on Discord.

License

MIT