Agent Skill 包

定义

Agent Skill 包是一种跨 agent 通用的纯 markdown 指令书——一个目录下放一个 SKILL.md（必要时配 reference / scripts / data），不绑定任何运行时，让任意支持 skill 发现的 agent（Claude Code、Cursor、Codex、Gemini、Hermes、OpenClaw、Copilot、Windsurf、Trae、Kiro 等）都能加载执行。它是 Skills系统 在 agent-agnostic 维度的极致表达：能力的载体是文件，分发靠协议而非 SDK。

要点

• 形态约束：纯 markdown，零运行时绑定。Python / JS 脚本是可选附件，主指令必须是 agent 自己读得懂的自然语言步骤
• 分发机制：通过 symlink 或符号链接把同一份 skill 同时挂到 14+ agent 的发现路径（项目级 .claude/skills/、.cursor/skills/ 等 + 全局 ~/.claude/skills/ 等），一次安装多端可用
• bootstrap 单一真相源：AGENTS.md 作为唯一原文，CLAUDE.md / .hermes.md 等 agent 专属入口全部 symlink 过去，避免多份漂移
• 配置发现协议：agent 从 cwd 向上找 .env → 用户目录 config → vault 自带 AGENTS.md 三级回退
• 是 文件作为协议〔待补〕 在 agent runtime 维度的具体应用——同一份能力同时服务多个 agent

示例

Ar9av/obsidian-wiki〔待补〕 是 reference 实现：30+ 个 skill 全部为纯 markdown，setup.sh 把它们 symlink 到 14+ agent 路径，搭配三级配置发现，让 /wiki-update 这类命令在任意 project 目录、任意 agent 中都能跑。lewislulu/llm-wiki-skill 是同模式的实验性实现，但只覆盖 OpenClaw/Codex。

相关概念

• Skills系统 - Agent Skill 包是其 agent-agnostic 演化形态
• 文件作为协议〔待补〕 - 同一份文件同时被多个 agent runtime 消费
• Fat Skills Thin Harness - skill 越厚、harness 越薄，越适合跨 agent 分发
• Skill可迁移幻觉 - 跨 agent 分发不等于跨模型能力等价
• AGENTS - 项目级 bootstrap 的事实标准入口
• LLM Wiki〔待补〕 - obsidian-wiki 通过 Agent Skill 包实现 LLM Wiki〔待补〕 模式

参考资料

• Ar9av/obsidian-wiki setup.sh
• obsidian-wiki AGENTS.md