Agent Skills机制详解教程：SKILL.md编写、安装与自动触发全流程

2026-08-06 | AI Tools Hub

Agent Skills是2026年AI编程领域的核心范式。一个Skill就是一个有组织的文件夹，内含指令（SKILL.md）、脚本、资产和资源，让Agent能精准执行特定任务。Skills格式是开放标准，同一份SKILL.md无需修改即可在Claude Code、Codex、Gemini CLI、Cursor、GitHub Copilot等主流工具中通用。

SKILL.md结构

---name: api-doc-generator
description: Generate comprehensive API documentation from code
---# 指令内容（Markdown）

YAML元数据必须包含name和description，后跟Markdown指令。description使用generate、modify等动词精准匹配用户意图。

三级加载机制

启动时始终加载每个Skill的name和description（约100 tokens/Skill）。用户发起任务时，系统自动匹配并加载对应Skill的完整指令。如无匹配则不占用任何上下文，极为高效。触发方式有两种：显式调用（CLI输入）和隐式触发（任务描述与Skill匹配时自动激活）。

安装方式

# Claude Code
/plugin marketplace add anthropics/skills
/plugin install <技能名>@anthropic-agent-skills

# Codex
-installer <技能名>

Skill可存放于三个作用域：个人（C:\Users\pc/.agents/skills/）、项目（.agents/skills/）、管理员（/etc/codex/skills/）。

对Skills生态感兴趣？阅读Superpowers技能框架，或了解ECC Claude Code增强。

📚 常见问题

Agent Skills机制详解是什么？

Agent Skills是2026年AI编程领域的核心范式。一个Skill就是一个有组织的文件夹，内含指令（SKILL.md）、脚本、资产和资源，让Agent能精准执行特定任务。Skills格式是开放标准，同一份SKILL.md无需修改即可在Claude Code、Codex、Gemini CLI、Cursor、Git