Peter Hartree（AI Wow）于 2026-02-18 发表，介绍如何让同一套 Skill 文件被 Claude Code、Codex、Gemini CLI 等多个 coding agent 共享使用。
问题背景
各 agent 读取 skill 的路径不同，导致同一个 skill 需要在多个目录重复维护：
~/.agents/skills/ # 被 Codex 和 Gemini 读取，但 Claude Code 不读
~/.claude/skills/ # 被 Claude Code 读取
~/.codex/skills/ # 被 Codex 读取
~/.gemini/skills/ # 被 Gemini 读取
解决方案：Symlink
将 skill 统一存放在 ~/.agents/skills/，然后用 symlink 将 ~/.claude/skills/ 指向它：
# Symlink ~/.agents/skills to ~/.claude/skills
ln -sfn ~/.agents/skills ~/.claude/skills这样：
- Skill 文件只维护一份（在
~/.agents/skills/） - Claude Code 通过 symlink 读取到同样的 skill
- Codex / Gemini 直接读取
~/.agents/skills/
同样的模式也适用于项目级别的 skill。
背景说明
npx skills add -g 默认安装到 ~/.agents/skills/，是跨 agent 共享的标准全局路径。Claude Code 的专属路径 ~/.claude/skills/ 是独立的——作者预计 Claude Code 会很快原生支持 ~/.agents 目录，届时 symlink 技巧将不再必要。
关联页面
- skills-cli — npx skills CLI 详解，包含安装路径与作用域说明
- agent-skill-self-update — Skill 自动更新机制：SessionStart Hook
- agentara-skills — 使用 npx skills 安装的 Skill 库示例