Agent skill · software engineering · sickn33
distribute-skill-to-all-agents
Distribute a skill across configured agent skill folders while respecting local symlink layouts.
Why this skill is useful
Adds specific commands and workflows for distributing skills across multiple agent environments that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
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): 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): 4. Verify all 4 locations show identical byte counts: All four numbers must match. If .claude or .pi shows a different byte count, that symlink is broken — investigate before proceeding. Updating an Existing Distributed Skill Same flow — re-copy from ~/.agents/skills/ to .hermes/skills/. The .claude and .pi symlinks update automatically. cp -r overwrites by default; use rsync -a --delete if the skill folder has nested files that may have been removed: Pitfalls ~/.pi/skills/ is the wrong location. Pi Agent loads from ~/.pi/agent/skills/ only. A skill placed in ~/.pi/skills/ is invisible. If you find skills already there, they're orphans — confirm with the user before deleting. ~/.claude/skills is a symlink, not a folder. cp -r ~/.agents/skills/foo ~/.claude/skills/ will error with "are identical". …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/distribute-skill-to-all-agents