Manage, sync, and publish Agent Skills across multiple AI platforms (Claude, Codex, Gemini, Copilot) and marketplace repositories. Use when users want to list skills, sync between platforms, publish to marketplace keys, mirror canonical skills, audit drift, or set up their environment. Triggers on phrases like "list skills", "sync skills", "publish skill", "skill marketplace", "deploy skill", "audit skills", or "skill inventory".
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Manage, sync, and publish Agent Skills across multiple AI platforms (Claude, Codex, Gemini, Copilot) and marketplace repositories. Use when users want to list skills, sync between platforms, publish to marketplace keys, mirror canonical skills, audit drift, or set up their environment. Triggers on phrases like "list skills", "sync skills", "publish skill", "skill marketplace", "deploy skill", "audit skills", or "skill inventory".
Skill Manager
Manage Agent Skills across multiple AI platforms and tiered marketplace repositories.
Core Capabilities
Multi-Platform Sync - Deploy skills across Claude Code, OpenAI Codex, Gemini CLI, and GitHub Copilot
Inventory - Discover and list all skills across platform locations
Publish - Push skills to tiered GitHub marketplace repositories (private/team/public)
Marketplace Distribute - Make marketplace-installed skills available to other AI platforms via symlinks
Validate - Check skill compliance with the Agent Skills specification
Source of Truth: How Syncing Works
Skill-manager uses a single source of truth model. You designate one platform as your "source" where you create and edit skills, and skill-manager syncs them one-way to other platforms.
Why one-way sync?
Prevents conflicts when the same skill exists on multiple platforms
Clear ownership: you always know where the authoritative version lives
Simple mental model: edit in one place, distribute everywhere
Example: If Claude Code is your source of truth:
Create and edit skills in ~/.claude/skills/
Run to distribute to Codex, Gemini, Copilot
scripts/sync.py --all
Skills created directly in ~/.codex/skills/ will NOT sync back to Claude
If you accidentally create a skill on the wrong platform:
Copy it manually to your source platform's skills directory
Run sync to distribute it properly
Optionally delete the original from the non-source platform
To change your source of truth: Edit config.json and set "is_source": true on your preferred platform (and false on all others), or re-run scripts/init.py.
Supported Platforms
Platform
User Skills Path
Detection
Claude Code
~/.claude/skills/
~/.claude/ exists
OpenAI Codex
~/.codex/skills/
~/.codex/ exists
Gemini CLI
~/.gemini/skills/
~/.gemini/ exists
GitHub Copilot
~/.copilot/skills/
~/.copilot/ exists
Quick Start
First-Time Setup
Run the interactive setup wizard:
scripts/init.py
This will:
Detect installed AI platforms on your system
Choose which platform is your "source of truth"
Configure which platforms to sync skills to
Set sync mode (symlink or copy)
Optionally configure marketplace repositories
Sync Skills Between Platforms
After setup, sync a skill from your source platform to all configured targets:
--include-marketplace - Backward-compatible alias (marketplace is already included by default)
Inventory Behavior
Default scripts/inventory.py output includes all discovered sources:
global skills
project skills
marketplace skills
Use source flags only when you want to narrow results.
Legacy include forms remain supported:
--include-marketplace
--include marketplace
--include=marketplace
Marketplace System
skill-manager works with marketplace keys from config.json (for example: private, team, public, three-dna, enterprise-core). Keys are identifiers only; repository names and plugin names can be arbitrary.
Publish a Skill
scripts/publish.py ~/.claude/skills/my-skill --to team
This will:
Copy the skill to your team marketplace repo
Update marketplace.json
Update the README.md "Available Skills" table (for new skills)
Create a PR for review
Sync to other platforms (if configured)
If you don't specify --to, you'll be prompted to choose.
Note on README updates: When publishing a new skill, the README.md is automatically updated with the skill's entry in the "Available Skills" table. For updates to existing skills, README changes are optional and only made if the skill's description has changed.
Mirror from a canonical source ref (tag, branch, or commit) into a target marketplace with manifest and README updates:
scripts/marketplace-mirror.py mirror --from public --to three-dna --source-ref v1.2.0
scripts/marketplace-mirror.py mirror --from public --to three-dna --source-ref 8ab12cd --skill skill-manager
scripts/marketplace-mirror.py mirror --from public --to three-dna --source-ref main --dry-run
Generate drift reports at any time:
scripts/marketplace-mirror.py drift --from public --to three-dna
scripts/marketplace-mirror.py drift --from public --to three-dna --source-ref v1.2.0
Distribute Marketplace Skills to Other Platforms
Make skills from your local marketplace clones available to other AI assistants (Codex, Gemini, Copilot) via symlinks. Claude Code is skipped by default since it has native marketplace access.
scripts/marketplace-distribute.py # Distribute all marketplace skills
scripts/marketplace-distribute.py --marketplace team # Only from team marketplace
scripts/marketplace-distribute.py --skill my-skill # Only distribute one skill
scripts/marketplace-distribute.py --to codex,gemini # Only to specific platforms
scripts/marketplace-distribute.py --dry-run # Preview what would happen
scripts/marketplace-distribute.py --list # List available marketplace skills
scripts/marketplace-distribute.py --status # Show distribution status
Options:
--marketplace NAME - Only distribute from specific marketplace
--skill NAME - Only distribute a specific skill by name
--to PLATFORMS - Target platforms: codex, gemini, copilot, all
--include-claude - Also create symlinks for Claude (normally skipped)
--dry-run - Preview changes without applying
--force - Overwrite existing skills without prompting
--list - List available marketplace skills
--status - Show current distribution status
How it works:
Scans your local marketplace repo clones under local_repos_path from config.json
Creates symlinks in target platform skill directories pointing to marketplace skills
Skips Claude Code by default (it already has access via the plugin system)
# List
scripts/inventory.py
# Publish
scripts/publish.py ~/.claude/skills/my-skill --to team
# Mirror
scripts/marketplace-mirror.py mirror --from public --to team --source-ref main --skill my-skill
# Audit/drift
scripts/marketplace-mirror.py drift --from public --to team
Configuration
Configuration is stored in config.json:
{"platforms":{"claude":{"enabled":true,"user_path":"~/.claude/skills","is_source":true},"codex":{"enabled":true,"user_path":"~/.codex/skills","is_source":false},"gemini":{"enabled":false,"user_path":"~/.gemini/skills","is_source":false},"copilot":{"enabled":false,"user_path":"~/.copilot/skills","is_source":false}},"sync_mode":"symlink","marketplaces":{"private":{"repo":"https://github.com/you/skills-private","description":"Personal/experimental skills","visibility":"private"},"team":{"repo":"https://github.com/your-org/skills-team","description":"Shared skills for collaborators","visibility":"private"},"public":{"repo":"https://github.com/your-org/skills-public","description":"Freely available skills","visibility":"public"}},"owner":{"name":"Your Name","email":"you@example.com"},"local_repos_path":"~/GitHub"}
{"name":"skills-team","owner":{"name":"Your Name","email":"you@example.com"},"metadata":{"description":"Shared skills for collaborators","version":"1.0.0"},"plugins":[{"name":"skills-team","description":"Shared skills for collaborators","source":"./","strict":false,"skills":["./skills/skill-one","./skills/skill-two"]}]}
Workflow: Publishing Skills
Step 1: Develop Locally
Create and test your skill in your source platform's skills directory:
