distribute-skill-to-all-agents

name	distribute-skill-to-all-agents
description	Distribute a skill across configured agent skill folders while respecting local symlink layouts.
category	development
risk	critical
source	community
source_repo	davidondrej/skills
source_type	community
date_added	2026-07-07
author	davidondrej
tags	["skills","distribution","agents"]
tools	["claude","codex"]
license	MIT
license_source	https://github.com/davidondrej/skills/blob/main/LICENSE

Distribute a Skill Across All Agents

When to Use

• Use when a skill should be made available across multiple local agent skill folders.
• Use when the user asks to sync or distribute skill updates to other agents.

The user has 4 agent skill locations on his MacBook. A skill must exist in each (or via symlink) to be discoverable by every agent.

The 4 Canonical Locations

Agent	Skills Folder	Notes
Codex / OpenAI Agents	~/.agents/skills/	Canonical — author skills here first
Claude Code	~/.claude/skills/	Symlink → ~/.agents/skills/ — writing to .agents/skills automatically covers Claude
Pi Agent	~/.pi/agent/skills/	Symlink → ~/.agents/skills/ — auto-covered. (Path is /agent/ nested — NOT ~/.pi/skills/)
Hermes Agent	~/.hermes/skills/	Independent copy — the only one needing a manual copy

Workflow

1. Author the skill in ~/.agents/skills/<skill-name>/SKILL.md (canonical). Follow effective-agent-skills SKILL.md guidance.
2. Verify the .claude symlink is intact (one-time check):

   ls -la ~/.claude/skills
   # Expect: ~/.claude/skills -> ~/.agents/skills
   

   If it's a real directory instead of a symlink, the user has diverged copies — ask before touching.
3. Copy to .hermes only (.claude and .pi are symlinks — already covered):

   SKILL=<skill-name>
   cp -r ~/.agents/skills/$SKILL ~/.hermes/skills/
   

4. Verify all 4 locations show identical byte counts:

   for p  ~/.agents/skills/ ~/.claude/skills/ ~/.pi/agent/skills/ ~/.hermes/skills/; 
      
   
   

   All four numbers must match. If or shows a different byte count, that symlink is broken — investigate before proceeding.