How to Sync AI Skills Across Claude Code, OpenClaw, and Codex in 2 Minutes

How to Sync AI Skills Across Claude Code, OpenClaw, and Codex in 2 Minutes

# ai# opensource# tutorial# productivity
How to Sync AI Skills Across Claude Code, OpenClaw, and Codex in 2 MinutesWillie

Stop copying skills between AI CLIs. Set up a single source of truth and sync everywhere with one command.

You use Claude Code at work, Openclaw for side projects, and Codex for quick scripts.

You have 20+ skills. They need to exist in all three tools.

Here's how to set that up in under 2 minutes — and never manually copy a skill again.

The Problem

Every AI CLI stores skills in a different directory:

~/.claude/skills/          # Claude Code
~/.codex/skills/           # Codex CLI
~/.opencode/skills/        # OpenCode
Enter fullscreen mode Exit fullscreen mode

When you install a skill, you pick which tools get it. When you edit a skill in one tool, the others don't know. When you remove a skill from one tool, you might break the others.

The root cause: there's no single source of truth. Skills are scattered.

The Fix: One Source, Symlinks Everywhere

skillshare keeps all your skills in one directory and creates symlinks to each AI CLI.

~/.config/skillshare/skills/     ← single source
  ├── code-review/
  ├── react-guidelines/
  └── _team-repo/
        ├── frontend/
        └── testing/

~/.claude/skills/code-review → symlink to source
~/.codex/skills/code-review  → symlink to source
Enter fullscreen mode Exit fullscreen mode

Edit the source, every tool sees the change instantly.

Step-by-Step Setup

1. Install 

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

# Homebrew
brew install runkids/tap/skillshare

# Windows PowerShell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
Enter fullscreen mode Exit fullscreen mode

2. Initialize 

skillshare init
Enter fullscreen mode Exit fullscreen mode

This does three things:

  • Creates ~/.config/skillshare/skills/ (your source directory)
  • Detects which AI CLIs you have installed
  • Generates config.yaml with your targets

Output looks like:

✓ Created source directory
✓ Detected targets:
    claude  → ~/.claude
    codex   → ~/.codex/skills
✓ Config saved to ~/.config/skillshare/config.yaml
Enter fullscreen mode Exit fullscreen mode

3. Import existing skills

Already have skills scattered across your AI CLIs? Collect them:

skillshare collect --all
Enter fullscreen mode Exit fullscreen mode

This copies every skill from every detected target into the source directory. Duplicates are flagged so you can choose which to keep.

4. Sync 

skillshare sync
Enter fullscreen mode Exit fullscreen mode

Done. Every target now has symlinks pointing to your source directory.

Synced 3 targets:
  claude   → 15 linked, 0 skipped, 0 removed
  codex    → 15 linked, 0 skipped, 0 removed
Enter fullscreen mode Exit fullscreen mode

From now on, this is the only command you need. Made changes to your skills? skillshare sync.

Day-to-Day Workflows

Install a skill from GitHub 

skillshare install anthropics/skills/skills/pdf
skillshare sync
Enter fullscreen mode Exit fullscreen mode

The skill is downloaded to your source directory, then synced to all targets.

Install a full team/org skill repo 

skillshare install github.com/your-org/team-skills --track
skillshare sync
Enter fullscreen mode Exit fullscreen mode

The --track flag preserves .git, so you can update later:

skillshare update _team-skills   # git pull
skillshare sync                  # push changes to all targets
Enter fullscreen mode Exit fullscreen mode

Create a new skill 

skillshare new my-custom-skill
Enter fullscreen mode Exit fullscreen mode

Creates a SKILL.md template in your source directory. Edit it, sync, and every AI CLI has it.

Scan for security threats

Before syncing third-party skills to your AI agents, scan them:

skillshare audit
Enter fullscreen mode Exit fullscreen mode

This checks every installed skill for prompt injection, data exfiltration, destructive commands, and other threats. Critical findings block installation by default — no malicious skill reaches your AI agent without you explicitly approving it.

Skills are also scanned automatically during skillshare install.

Pull back edits from a specific tool

You tweaked a skill in codex's UI. Pull the change back to source:

skillshare collect codex
skillshare sync             # propagate to other targets
Enter fullscreen mode Exit fullscreen mode

Check status 

skillshare status
Enter fullscreen mode Exit fullscreen mode

Shows which targets are in sync, which have drifted, and which skills are unlinked.

Preview before syncing 

skillshare diff
Enter fullscreen mode Exit fullscreen mode

Shows exactly what sync will do — which symlinks will be created, updated, or removed.

Cross-Machine Sync

If your source directory is a git repo:

# Machine A
skillshare push

# Machine B
skillshare pull
skillshare sync
Enter fullscreen mode Exit fullscreen mode

Or just version-control ~/.config/skillshare/ as part of your dotfiles.

Project-Scoped Skills

For skills that should live inside a specific repo:

cd your-project
skillshare init -p                              # Creates .skillshare/
skillshare install org/skills/skills/react -p   # Install to project
skillshare sync                                 # Sync to targets
Enter fullscreen mode Exit fullscreen mode

Commit .skillshare/ to git. Teammates clone the repo and run skillshare sync — everyone gets the same skills, in every AI tool.

Web Dashboard 

skillshare ui
Enter fullscreen mode Exit fullscreen mode

Opens a web dashboard at http://localhost:19420 for visual skill management — browsing, installing, syncing, and searching skills without the terminal.

The Config File

Everything is controlled by ~/.config/skillshare/config.yaml:

source: /Users/you/.config/skillshare/skills
sync_mode: merge    # merge (per-skill symlinks) or symlink (whole directory)
targets:
  claude:
    path: /Users/you/.claude
  codex:
    path: /Users/you/.codex/skills
Enter fullscreen mode Exit fullscreen mode

Want to add a new AI CLI? Add a target. Want to remove one? Delete the entry. Then sync.

Quick Reference

Command What it does
skillshare init Create config + detect targets
skillshare sync Sync source → all targets
skillshare install <source> Install skill from GitHub/local path
skillshare collect [target] Import skills from target(s) to source
skillshare list List skills in source
skillshare status Show sync status
skillshare diff Preview what sync will change
skillshare search <query> Search skills on GitHub
skillshare audit [name] Scan skills for security threats
skillshare new <name> Create a new skill template
skillshare update --all Update all tracked repos
skillshare push / pull Cross-machine git sync
skillshare ui Open web dashboard

Migration from Other Tools

If you're already using npx skills or manual management:

skillshare init          # detect your AI CLIs
skillshare collect --all # import everything
skillshare sync          # symlink to all targets
Enter fullscreen mode Exit fullscreen mode

Full migration guide: skillshare.runkids.cc/docs/guides/migration

Architectural comparison: skillshare.runkids.cc/docs/guides/comparison

skillshare is open source (MIT), written in Go, and supports 40+ AI CLI targets.

GitHub: github.com/runkids/skillshare
Docs: skillshare.runkids.cc

If you found this useful, a ⭐ on GitHub would help others find it too.