工具与生态
围绕 Agent Skills 的资料可以分成三类：平台兼容性、工具链、示例 Catalog。本页作为总入口，帮助你快速跳到对应主题。
该看哪一页
| 你想解决的问题 | 推荐阅读 |
|---|---|
| 不同平台放在哪里、怎么触发 | 平台兼容性 |
Codex 的 .agents/skills/ 与 agents/openai.yaml | Codex Skills |
| 如何安装、创建、校验 Skill | 工具与校验 |
| 哪里找官方和社区范例 | Catalog 与示例 |
SKILL.md 正文怎么组织 | 正文模式 |
| 如何证明 Skill 有效 | 评估 Skill |
| 安装第三方 Skill 前怎么审计 | 安全与信任模型 |
跨平台核心判断
只要遵守 agentskills.io 规范，一份 Skill 的通用核心通常可以在多个 agent 平台复用：
text
my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/真正需要关注的差异主要是：
- 安装路径：如 Claude Code 的
.claude/skills/与 Codex 的.agents/skills/。 - 显式触发语法：如 Claude Code 的
/skill与 Codex 的$<skill>。 - 平台扩展字段：如 Claude Code 的 frontmatter 扩展、Codex 的
agents/openai.yaml。 - 分发方式：本地目录、GUI 上传、API 上传、Plugin / Marketplace。
推荐学习顺序
如果你刚开始系统整理 Skill 内容，建议按这个顺序：
如果你主要面向 Codex 使用，可以在第 5 步前先读 Codex Skills。
下一步
- 想直接开始写？→ 快速开始
- 不确定 description 怎么写？→ 写好 description
- 写完想自查？→ 反模式 checklist