mcpField
D
distribute-skill-to-all-agents

distribute-skill-to-all-agents

github.com/davidondrejAgent workflows4.2k208 installsUpdated today
Repository

About distribute-skill-to-all-agents

A skill for distributing a global skill across Codex/OpenAI Agents, Claude Code, Pi Agent, Hermes Agent, and Cursor on a Mac. It documents canonical locations, symlink and copy steps, and checks to keep installations aligned.

Key features

  1. 01Lists global skill locations for five agents
  2. 02Uses `~/.agents/skills/` as the canonical source
  3. 03Sets up symlinks and the Hermes copy
  4. 04Checks file byte counts across locations
  5. 05Covers updates, conflicts, and removal

Use cases

  1. 01Make a global skill discoverable across agents
  2. 02Update a skill across separate installations
  3. 03Diagnose mismatched copies or incorrect paths

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/davidondrej/skills --skill distribute-skill-to-all-agents

After installing, type/distribute-skill-to-all-agentsin Claude Code to confirm it loaded.

Details

From the project README

Distribute a Skill Across All Agents

A global skill must exist at all five locations on the user's Mac, directly or via symlink, for every agent to discover it.

Skill locations

  • Codex / OpenAI Agents: ~/.agents/skills/ is canonical. Author skills here first.
  • Claude Code: ~/.claude/skills/ → ~/.agents/skills/; covered automatically.
  • Pi Agent: ~/.pi/agent/skills/ → ~/.agents/skills/; covered automatically. The nested /agent/ is required, not ~/.pi/skills/.
  • Hermes Agent: ~/.hermes/skills/ is an independent copy; only Hermes needs copying.
  • Cursor (IDE + CLI): ~/.cursor/skills/ is a real folder that does not reliably read ~/.agents/skills/. Add one symlink per skill. Never use ~/.cursor/skills-cursor/; it holds Cursor's built-ins.

Workflow

  1. Author in ~/.agents/skills/<skill-name>/SKILL.md, following effective-agent-skills.
  2. Verify the Claude symlink (one-time check): 
    ls -la ~/.claude/skills
# Expect: ~/.claude/skills -> ~/.agents/skills
    If it is a real directory, copies have diverged — ask before touching.
  3. Copy to Hermes; Claude and Pi are covered by symlinks: 
    SKILL=<skill-name>
cp -r ~/.agents/skills/$SKILL ~/.hermes/skills/
  4. Symlink into Cursor (skip if it already exists): 
    [ -e ~/.cursor/skills/$SKILL ] || ln -s ~/.agents/skills/$SKILL ~/.cursor/skills/$SKILL
    If a real Cursor copy exists and differs, compare versions and ask before replacing.
  5. Verify matching byte counts at all five locations: 
    for p in ~/.agents/skills/$SKILL ~/.claude/skills/$SKILL ~/.pi/agent/skills/$SKILL ~/.hermes/skills/$SKILL ~/.cursor/skills/$SKILL; do
  echo "$p: $(wc -c < $p/SKILL.md) bytes"
done
    All five numbers must match. If Claude, Pi, or Cursor differs, investigate the symlink before proceeding.

Update an existing skill

Re-copy from ~/.agents/skills/ to ~/.hermes/skills/; Claude, Pi, and symlinked Cursor skills update automatically. cp -r overwrites by default. Use rsync -a --delete when nested files may have been removed:

rsync -a --delete ~/.agents/skills/$SKILL/ ~/.hermes/skills/$SKILL/

Pitfalls

  • ~/.pi/skills/ is the wrong global location. Pi loads from ~/.pi/agent/skills/; skills in the former are invisible orphans. Confirm with the user before deleting them.
  • Do not copy into the Claude or Pi symlinks. They already point to ~/.agents/skills/; copying there errors with "are identical". Only Hermes is independent. Do not replace it with a symlink unless the user asks.
  • Project-local skills can override global skills on collision (later-discovered wins), including ./.pi/agent/skills/ or .pi/skills/ inside a repo. This workflow handles only global distribution.
  • Hermes and Cursor load skills at session start. Restart running sessions to discover a newly distributed skill.
  • Filename casing matters on case-sensitive volumes: use uppercase SKILL.md.

When not to use this skill

  • Project-specific skill: use repo-local ./.claude/skills/, ./.pi/agent/skills/, etc.
  • Single-agent edit (e.g. Hermes-only): patch that file directly without propagating.
  • Global removal: confirm with the user first; deletion is destructive. Remove with rm -rf from ~/.agents/skills/ (covers Claude and Pi) ~/.hermes/skills/, and the ~/.cursor/skills/ symlink.

Comments

Markdown supported