Shared Skills

English | 中文

One source. Every agent. Zero drift.

shared-skills is the skill sync layer for multi-agent workflows. Write a skill once — sync-skills.py converts and deploys it to Claude Code, Codex, Hermes, and OpenClaw simultaneously. Zero external dependencies. Pure Python. 4-agent format conversion.

Linux ✅   macOS ✅   Windows ✅   |   MIT   |   Python 3.10+

---

Quick Links

Start here
Installation	Clone → sync
Usage	sync / --check / --show-log / Web UI
How It Works	Source → format convert → deploy
Adding a Skill	2 files: SKILL.md + meta.yaml
Unison	Companion: multi-agent pipeline framework

Installation

git clone https://github.com/Xuan0629/shared-skills.git
cd shared-skills

Requirements: Python 3.10+, standard library only (zero third-party dependencies).

Usage

# Sync all skills to their configured target agents
python3 sync-skills.py

# Check whether synced skills match the source
python3 sync-skills.py --check

# View sync log
python3 sync-skills.py --show-log

# Start the Web UI Dashboard
cd webui && python3 -m http.server 8080

How It Works

shared-skills/          # Single source of truth
├── skill-name/
│   ├── SKILL.md        # Skill content
│   └── meta.yaml       # Metadata (version, sync targets, per-agent config)
├── skills-manifest.yaml
├── sync-skills.py       # Format conversion + sync engine
└── webui/               # Dashboard

        ↓ sync-skills.py

~/.hermes/skills/...    ~/.claude/skills/...    ~/.codex/skills/...    ~/.openclaw/.../skills/
    (Hermes format)       (Claude format)         (Codex format)         (OpenClaw format)

sync-skills.py reads source skills, converts them to each agent's required format (frontmatter, file structure), and writes them to the target directories.

Adding a New Skill

mkdir my-skill
# Write my-skill/SKILL.md
# Write my-skill/meta.yaml (specify sync_to: [hermes, claude, codex])
python3 sync-skills.py

meta.yaml format:

version: "1.0.0"
sync_to: [hermes, claude, codex]   # Target agent list
hermes:
  category: software-development
  description: "Description"
claude:
  description: "Description"
codex:
  description: "Description"

Web UI Dashboard

The webui/ directory provides a visual dashboard showing sync status for every skill across all agents.

cd webui && python3 -m http.server 8080

Then open http://localhost:8080.

Companion Project

shared-skills is the recommended companion tool for the Unison multi-agent collaboration framework. In Unison workflows, shared-skills ensures every reviewing agent uses identical skill definitions — eliminating version drift.

License

MIT