[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B2FVPDFTMTDB8VVSBPJTRQ":3,"skill-same:01M7B2FVPDFTMTDB8VVSBPJTRQ":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7B2FVPDFTMTDB8VVSBPJTRQ","distribute-skill-to-all-agents",null,"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.","sandeepsalwan1\u002Fmac-setup","sandeepsalwan1","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F118837112?v=4","01M7B2ETGSAY4K5RNVZPF6MEEG","Sandeep Salwan","01M7B2ETHDG8W38G9GV8PR146B",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fdistribute-skill-to-all-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fdistribute-skill-to-all-agents\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: distribute-skill-to-all-agents\ndescription: 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.\n---\n\n# Distribute a Skill Across All Agents\n\nA global skill must exist at all five locations on the user's Mac, directly or via symlink, for every agent to discover it.\n\n## Managed Mac setup\n\nOn a Mac managed by `mac-setup`, update the tracked `skills\u002F\u003Cskill-name>\u002F` directory\nand run that checkout's `scripts\u002Flink-portable-skills`. This takes precedence over\nthe manual workflow below. The linker preserves existing agent directories, links\neach skill individually, backs up replaced real copies, and respects an external\nprofile owner. Do not copy files between paths that resolve to the same directory.\nLocal Hermes links do not install skills on a separately hosted Hermes server.\n\n## Skill locations\n\nThe layout below describes unmanaged setups. Managed Macs use the linker's per-skill links, including Pi and local Hermes.\n\n- **Codex \u002F OpenAI Agents:** `~\u002F.agents\u002Fskills\u002F` is canonical. Author skills here first.\n- **Claude Code:** `~\u002F.claude\u002Fskills\u002F` → `~\u002F.agents\u002Fskills\u002F`; covered automatically.\n- **Pi Agent:** `~\u002F.pi\u002Fagent\u002Fskills\u002F` → `~\u002F.agents\u002Fskills\u002F`; covered automatically. The nested `\u002Fagent\u002F` is required, not `~\u002F.pi\u002Fskills\u002F`.\n- **Hermes Agent:** `~\u002F.hermes\u002Fskills\u002F` is an independent copy; only Hermes needs copying.\n- **Cursor (IDE + CLI):** `~\u002F.cursor\u002Fskills\u002F` is a real folder that does not reliably read `~\u002F.agents\u002Fskills\u002F`. Add one symlink per skill. Never use `~\u002F.cursor\u002Fskills-cursor\u002F`; it holds Cursor's built-ins.\n\n## Workflow\n\n1. **Author in `~\u002F.agents\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md`**, following `effective-agent-skills`.\n2. **Verify the Claude symlink** (one-time check):\n   ```bash\n   ls -la ~\u002F.claude\u002Fskills\n   # Expect: ~\u002F.claude\u002Fskills -> ~\u002F.agents\u002Fskills\n   ```\n   If it is a real directory, copies have diverged - ask before touching.\n3. **Copy to Hermes**; Claude and Pi are covered by symlinks:\n   ```bash\n   SKILL=\u003Cskill-name>\n   cp -r ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.hermes\u002Fskills\u002F\n   ```\n4. **Symlink into Cursor** (skip if it already exists):\n   ```bash\n   [ -e ~\u002F.cursor\u002Fskills\u002F$SKILL ] || ln -s ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.cursor\u002Fskills\u002F$SKILL\n   ```\n   If a real Cursor copy exists and differs, compare versions and ask before replacing.\n5. **Verify matching byte counts at all five locations**:\n   ```bash\n   for p in ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.claude\u002Fskills\u002F$SKILL ~\u002F.pi\u002Fagent\u002Fskills\u002F$SKILL ~\u002F.hermes\u002Fskills\u002F$SKILL ~\u002F.cursor\u002Fskills\u002F$SKILL; do\n     echo \"$p: $(wc -c \u003C $p\u002FSKILL.md) bytes\"\n   done\n   ```\n   All five numbers must match. If Claude, Pi, or Cursor differs, investigate the symlink before proceeding.\n\n## Update an existing skill\n\nRe-copy from `~\u002F.agents\u002Fskills\u002F` to `~\u002F.hermes\u002Fskills\u002F`; Claude, Pi, and symlinked Cursor skills update automatically. `cp -r` overwrites by default. Use `rsync -a --delete` when nested files may have been removed:\n\n```bash\nrsync -a --delete ~\u002F.agents\u002Fskills\u002F$SKILL\u002F ~\u002F.hermes\u002Fskills\u002F$SKILL\u002F\n```\n\n## Pitfalls\n\n- **`~\u002F.pi\u002Fskills\u002F` is the wrong global location.** Pi loads from `~\u002F.pi\u002Fagent\u002Fskills\u002F`; skills in the former are invisible orphans. Confirm with the user before deleting them.\n- **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\u002Flink-portable-skills` manage each agent's links, including local Hermes.\n- **Project-local skills can override global skills** on collision (later-discovered wins), including `.\u002F.pi\u002Fagent\u002Fskills\u002F` or `.pi\u002Fskills\u002F` inside a repo. This workflow handles only global distribution.\n- **Hermes and Cursor load skills at session start.** Restart running sessions to discover a newly distributed skill.\n- **Filename casing matters** on case-sensitive volumes: use uppercase `SKILL.md`.\n\n## When not to use this skill\n\n- **Project-specific skill:** use repo-local `.\u002F.claude\u002Fskills\u002F`, `.\u002F.pi\u002Fagent\u002Fskills\u002F`, etc.\n- **Single-agent edit** (e.g. Hermes-only): patch that file directly without propagating.\n- **Global removal:** confirm with the user first; deletion is destructive. Remove with `rm -rf` from `~\u002F.agents\u002Fskills\u002F` (covers Claude and Pi) `~\u002F.hermes\u002Fskills\u002F`, and the `~\u002F.cursor\u002Fskills\u002F` symlink.\n","# Distribute a Skill Across All Agents\n\nA global skill must exist at all five locations on the user's Mac, directly or via symlink, for every agent to discover it.\n\n## Managed Mac setup\n\nOn a Mac managed by `mac-setup`, update the tracked `skills\u002F\u003Cskill-name>\u002F` directory\nand run that checkout's `scripts\u002Flink-portable-skills`. This takes precedence over\nthe manual workflow below. The linker preserves existing agent directories, links\neach skill individually, backs up replaced real copies, and respects an external\nprofile owner. Do not copy files between paths that resolve to the same directory.\nLocal Hermes links do not install skills on a separately hosted Hermes server.\n\n## Skill locations\n\nThe layout below describes unmanaged setups. Managed Macs use the linker's per-skill links, including Pi and local Hermes.\n\n- **Codex \u002F OpenAI Agents:** `~\u002F.agents\u002Fskills\u002F` is canonical. Author skills here first.\n- **Claude Code:** `~\u002F.claude\u002Fskills\u002F` → `~\u002F.agents\u002Fskills\u002F`; covered automatically.\n- **Pi Agent:** `~\u002F.pi\u002Fagent\u002Fskills\u002F` → `~\u002F.agents\u002Fskills\u002F`; covered automatically. The nested `\u002Fagent\u002F` is required, not `~\u002F.pi\u002Fskills\u002F`.\n- **Hermes Agent:** `~\u002F.hermes\u002Fskills\u002F` is an independent copy; only Hermes needs copying.\n- **Cursor (IDE + CLI):** `~\u002F.cursor\u002Fskills\u002F` is a real folder that does not reliably read `~\u002F.agents\u002Fskills\u002F`. Add one symlink per skill. Never use `~\u002F.cursor\u002Fskills-cursor\u002F`; it holds Cursor's built-ins.\n\n## Workflow\n\n1. **Author in `~\u002F.agents\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md`**, following `effective-agent-skills`.\n2. **Verify the Claude symlink** (one-time check):\n   ```bash\n   ls -la ~\u002F.claude\u002Fskills\n   # Expect: ~\u002F.claude\u002Fskills -> ~\u002F.agents\u002Fskills\n   ```\n   If it is a real directory, copies have diverged - ask before touching.\n3. **Copy to Hermes**; Claude and Pi are covered by symlinks:\n   ```bash\n   SKILL=\u003Cskill-name>\n   cp -r ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.hermes\u002Fskills\u002F\n   ```\n4. **Symlink into Cursor** (skip if it already exists):\n   ```bash\n   [ -e ~\u002F.cursor\u002Fskills\u002F$SKILL ] || ln -s ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.cursor\u002Fskills\u002F$SKILL\n   ```\n   If a real Cursor copy exists and differs, compare versions and ask before replacing.\n5. **Verify matching byte counts at all five locations**:\n   ```bash\n   for p in ~\u002F.agents\u002Fskills\u002F$SKILL ~\u002F.claude\u002Fskills\u002F$SKILL ~\u002F.pi\u002Fagent\u002Fskills\u002F$SKILL ~\u002F.hermes\u002Fskills\u002F$SKILL ~\u002F.cursor\u002Fskills\u002F$SKILL; do\n     echo \"$p: $(wc -c \u003C $p\u002FSKILL.md) bytes\"\n   done\n   ```\n   All five numbers must match. If Claude, Pi, or Cursor differs, investigate the symlink before proceeding.\n\n## Update an existing skill\n\nRe-copy from `~\u002F.agents\u002Fskills\u002F` to `~\u002F.hermes\u002Fskills\u002F`; Claude, Pi, and symlinked Cursor skills update automatically. `cp -r` overwrites by default. Use `rsync -a --delete` when nested files may have been removed:\n\n```bash\nrsync -a --delete ~\u002F.agents\u002Fskills\u002F$SKILL\u002F ~\u002F.hermes\u002Fskills\u002F$SKILL\u002F\n```\n\n## Pitfalls\n\n- **`~\u002F.pi\u002Fskills\u002F` is the wrong global location.** Pi loads from `~\u002F.pi\u002Fagent\u002Fskills\u002F`; skills in the former are invisible orphans. Confirm with the user before deleting them.\n- **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\u002Flink-portable-skills` manage each agent's links, including local Hermes.\n- **Project-local skills can override global skills** on collision (later-discovered wins), including `.\u002F.pi\u002Fagent\u002Fskills\u002F` or `.pi\u002Fskills\u002F` inside a repo. This workflow handles only global distribution.\n- **Hermes and Cursor load skills at session start.** Restart running sessions to discover a newly distributed skill.\n- **Filename casing matters** on case-sensitive volumes: use uppercase `SKILL.md`.\n\n## When not to use this skill\n\n- **Project-specific skill:** use repo-local `.\u002F.claude\u002Fskills\u002F`, `.\u002F.pi\u002Fagent\u002Fskills\u002F`, etc.\n- **Single-agent edit** (e.g. Hermes-only): patch that file directly without propagating.\n- **Global removal:** confirm with the user first; deletion is destructive. Remove with `rm -rf` from `~\u002F.agents\u002Fskills\u002F` (covers Claude and Pi) `~\u002F.hermes\u002Fskills\u002F`, and the `~\u002F.cursor\u002Fskills\u002F` symlink.\n",{"name":5,"description":7},"main","1d52087de3c5ac2a463b108745b704f3f7eca32e","skills\u002Fdistribute-skill-to-all-agents","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1","sandeeps.tech","GenAI @ Amazon | Builder","2026-11-13 09:45:54",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add sandeepsalwan1\u002Fmac-setup --skill distribute-skill-to-all-agents",{"tool":39,"command":40},"bunx","bunx skills add sandeepsalwan1\u002Fmac-setup --skill distribute-skill-to-all-agents",{"tool":42,"command":43},"pnpm","pnpm dlx skills add sandeepsalwan1\u002Fmac-setup --skill distribute-skill-to-all-agents","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fdistribute-skill-to-all-agents\u002FSKILL.md",true,[47],{"path":48,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":16},"LICENSE","许可证",1069,[52,60,68,76,84,92],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":56,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":20},"01M7B2NQWYHKR94T1P7BTC8V14","teach","Teach the user a new skill or concept, within this workspace.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fteach\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fteach\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":64,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":20},"01M7B2NJ7N4B1W33GY3KCE6HVY","stop-overthinking","Manually-invoked skill that stops overthinking and forces a short, practical decision. Use only when the user explicitly invokes stop-overthinking.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fstop-overthinking\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fstop-overthinking\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":72,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":20},"01M7B2NAJEG8FCG4NTTSQZ95QP","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 \u002Fremind.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fremind\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fremind\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M7B2N8BSH4VY69BM98QKW2XV","read-all-adrs","Read every ADR markdown file in the project's docs\u002Fadr\u002F folder so you have full context on past decisions. Use only when the user explicitly calls it.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fread-all-adrs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fread-all-adrs\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":20},"01M7B2N09R80Y1ECQVFH6YQWQ8","pstack-why","Find evidence for design choices and historical constraints through relevant authorized read-only sources; distinguish facts, inferences, and gaps.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-why\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-why\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":20},"01M7B2MY9HZ0F1RZ93VTFVVQRR","pstack-unslop","Cut AI tells from any writing.","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-unslop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsandeepsalwan1\u002Fmac-setup\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-unslop\u002FSKILL.md",[],[]]