跳到正文
cccskills
免费在 GitHub 公开

distribute-skill-to-all-agents

Distribute shared skills across Codex, Claude Code, Pi, Hermes, and Cursor on a Mac. Use copies and symbolic links, which reference the original folder, to manage placement and updates.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

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.

实测评分 未实测

查看安装方法

适用场景

  • Distribute a new shared skill to five agents
  • Propagate updates to an existing shared skill
  • Check skill locations and symbolic links
  • Investigate differing copies across agents

包含的文件(1)

  • SKILL.md3.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

4x4

免费

Work through sixteen open questions in four rounds to clarify major product decisions, risky changes, or large refactors. The agent adapts later questions to earlier answers, then turns your decisions into a step-by-step implementation plan.

中文简介正在准备中。当前显示英语简介。

  • Clarifying decisions before a major product change
  • Planning a large refactor
  • Deciding rollout order for a risky change
davidondrej/skills41662026年10月23日 更新

Document approved decisions as concise ADRs, or architecture decision records. It preserves the user's meaning and conditions, removes conversational filler, follows the project's numbering, and presents the saved record for review.

中文简介正在准备中。当前显示英语简介。

  • Record a decision approved in conversation
  • Preserve the conditions and scope of a decision
  • Add a numbered ADR to existing records
davidondrej/skills41662026年10月23日 更新

Keep a Mac awake for a chosen duration or while a specified process runs. The skill uses built-in macOS tools to manage one session, verify that sleep prevention is active, and control whether the display stays on.

中文简介正在准备中。当前显示英语简介。

  • Keep a Mac awake during a lengthy task
  • Prevent sleep while a specified process runs
  • Allow the display to dim while keeping the Mac awake
davidondrej/skills41662026年10月23日 更新

Turn a feature or refactoring idea into a concise implementation prompt for another agent. It asks focused questions one at a time, records decisions, and includes development steps, validation, and working rules.

中文简介正在准备中。当前显示英语简介。

  • Clarify requirements for a new feature
  • Decide edge cases and failure behavior
  • Define the scope of a refactor
davidondrej/skills41662026年10月23日 更新

bb-cli

免费

Inspect and manage BB threads, environments, projects, and plugins through its command line interface. The skill guides agents to identify the correct targets, apply changes, and verify the resulting state.

中文简介正在准备中。当前显示英语简介。

  • Check BB projects and environment status
  • Manage skills and plugins
  • Create or operate threads
davidondrej/skills41662026年10月23日 更新

Create, install, and debug TypeScript plugins that extend bb with custom pages, sidebar panels, CLI commands, agent tools, themes, and other features. The skill also guides development reloads, log checks, and verification of installed plugins.

中文简介正在准备中。当前显示英语简介。

  • Add a custom page or sidebar panel to bb
  • Create a bb CLI command or agent tool
  • Investigate plugin errors through logs
davidondrej/skills41662026年10月23日 更新

查看 davidondrej 的全部技能

报告此技能的问题