一、最简上手
前置条件：已有 .claude/skills/ 目录。
创建一个符合 agentskills.io 开放标准的 Skill：
在该目录下创建 SKILL.md：
验证 Skill 已被识别：
Claude 应能从 / 菜单中找到该 Skill 并执行。
这个 SKILL.md 仅使用了 agentskills.io 规范的两个核心字段（name 和 description），在任何支持 Agent Skills 规范的平台上都能运行——包括 Claude Code、OpenAI Codex CLI、Cursor、Gemini CLI、JetBrains Junie 等 30+ 产品。
二、更多配置方式
添加跨平台元数据
agentskills.io 开放标准定义了 6 个 Frontmatter 字段。除 name 和 description 外，还可以补充：
添加 Claude Code 平台扩展字段
在 agentskills.io 标准字段之上，Claude Code 额外支持 9 个平台专属字段。完整字段清单和语法见 YAML Frontmatter。
Agent Skill 最常用的扩展配置：
context: fork 让 Skill 在隔离的 SubAgent 中运行，中间过程不影响主对话。agent 指定 SubAgent 类型。这两个字段的决策逻辑和完整说明见 context: fork。
使用验证工具检查格式
agentskills.io 提供官方验证工具：