Agent Skills

Summary

Agent Skills 是一种可移植的组件格式，用于将可复用的 AI Agent 能力打包为标准化的技能文件。它是 agent-plugins 规范的核心组件类型之一，与 mcp-model-context-protocol 服务器并列。Agent Skills 的格式由 Agent Skills 规范 定义，包含 SKILL.md 主文件及可选的脚本和引用材料。

Key Facts

• 规范网站: agentskills.io
• 在 Agent Plugins 中的位置: skills/ 目录
• 核心文件: SKILL.md（必需）
• 可选目录: scripts/（脚本）、references/（引用材料）

Structure

skills/
└── skill-name/
    ├── SKILL.md          # 必需：技能定义文件
    ├── scripts/          # 可选：可执行脚本
    │   └── analyze.sh
    └── references/       # 可选：引用材料
        └── checklist.md

How It Works

1. SKILL.md 定义技能的触发条件、步骤和行为
2. scripts/ 包含技能执行时调用的脚本
3. references/ 提供技能运行时可读取的参考资料
4. 客户端（如 Claude Code、Cursor）通过 agent-plugins 标准发现和加载这些技能

Relationship to Other Concepts

• agent-plugins — Agent Skills 是 Agent Plugins 的核心组件类型之一
• mcp-model-context-protocol — MCP 服务器是 Agent Plugins 的另一个核心组件类型
• skill-file — Agent Skills 是 Skill File 概念的标准化实现
• thin-harness-fat-skills — Agent Skills 体现了”胖技能”的设计理念

Open Questions

• Agent Skills 规范与各客户端（Claude Code、Cursor 等）的原生 skill 格式如何映射？
• 技能的版本管理和依赖解析机制尚未标准化

---

Evidence Timeline

• 2026-08-09: Ingested from agent-plugins.org (sources/articles/agent-plugins-org-2026.md)