distribute-skill-to-all-agents
Distribute global skills across Codex, Claude Code, Pi, Hermes, and Cursor. Use for "distribute this skill", "sync skills across agents", or after creating or updating a global skill.
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- distribute-skill-to-all-agents
- description
- Distribute global skills across Codex, Claude Code, Pi, Hermes, and Cursor. Use for "distribute this skill", "sync skills across agents", or after creating or updating a global skill.
02 资源文件 1
- 许可证LICENSE1.0 KB
03 SKILL.md 正文
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.
Managed Mac setup
On a Mac managed by mac-setup, update the tracked skills/<skill-name>/ directory
and run that checkout's scripts/link-portable-skills. This takes precedence over
the manual workflow below. The linker preserves existing agent directories, links
each skill individually, backs up replaced real copies, and respects an external
profile owner. Do not copy files between paths that resolve to the same directory.
Local Hermes links do not install skills on a separately hosted Hermes server.
Skill locations
The layout below describes unmanaged setups. Managed Macs use the linker's per-skill links, including Pi and local Hermes.
- 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
- Author in
~/.agents/skills/<skill-name>/SKILL.md, followingeffective-agent-skills. - Verify the Claude symlink (one-time check):
If it is a real directory, copies have diverged - ask before touching.ls -la ~/.claude/skills # Expect: ~/.claude/skills -> ~/.agents/skills - Copy to Hermes; Claude and Pi are covered by symlinks:
SKILL=<skill-name> cp -r ~/.agents/skills/$SKILL ~/.hermes/skills/ - Symlink into Cursor (skip if it already exists):
If a real Cursor copy exists and differs, compare versions and ask before replacing.[ -e ~/.cursor/skills/$SKILL ] || ln -s ~/.agents/skills/$SKILL ~/.cursor/skills/$SKILL - Verify matching byte counts at all five locations:
All five numbers must match. If Claude, Pi, or Cursor differs, investigate the symlink before proceeding.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
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 through symlinks to the same source. On unmanaged setups, Claude and Pi may share the canonical directory while Hermes has a separate copy. On managed Macs, let
scripts/link-portable-skillsmanage each agent's links, including local Hermes. - 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 -rffrom~/.agents/skills/(covers Claude and Pi)~/.hermes/skills/, and the~/.cursor/skills/symlink.
04 同仓库更多 Skills
teach
Teach the user a new skill or concept, within this workspace.
stop-overthinking
Manually-invoked skill that stops overthinking and forces a short, practical decision. Use only when the user explicitly invokes stop-overthinking.
remind
Rewrite the last response simpler and shorter in plain English, prefixed with a 3-5 sentence TLDR of the conversation so far. Manual-only, invoked as /remind.
read-all-adrs
Read every ADR markdown file in the project's docs/adr/ folder so you have full context on past decisions. Use only when the user explicitly calls it.
pstack-why
Find evidence for design choices and historical constraints through relevant authorized read-only sources; distinguish facts, inferences, and gaps.
pstack-unslop
Cut AI tells from any writing.