AI Skills in One Read: Concepts, Roles, and How to Use Them
Supports switching languages:
简体中文- 繁体中文
English
Introduces AI Skills (Agent Skills): what they are, why they matter, how to use them, and how to write them, so you can capture reusable workflows in tools like Cursor.
What Is an AI Skill?
AI Skill (called Agent Skill in Cursor) is an on-demand guide the AI can load. It is usually a Markdown file (e.g. SKILL.md), with YAML front matter, stored under .cursor/skills/or the project’s ~/.cursor/skills/ directory. When a question matches a Skill’s description, the Agent loads that file and runs the steps or rules inside.
Unlike Rules: Rules are hard constraints that apply to every message; Skills are soft, scenario-based guidance—better for longer workflows that don’t fit global rules but still need a shared team playbook.
What AI Skills Are For
- Consistency: for the same kind of question, the AI follows one playbook each time, avoiding ad-hoc detours.
- Less repetition: you don’t have to paste the same prompt in every chat—capture recurring flows as Skills.
- Team sharing: project Skills can live in the repo; new teammates and new sessions can reuse them as searchable team knowledge.
- Context focus: loaded only when needed, so unrelated chat context stays clean—great for large projects.
How to Use AI Skills
1. Create the Skill directory and files
Under .cursor/skills/your-skill-name/create SKILL.md, or under your personal ~/.cursor/skills/ there. Project Skills apply only to the current repo; personal Skills apply to all projects.
2. Write YAML and body content
The top of the file must include name and description. The description is critical: use third personState in third person what it does and when it fires; the Agent uses that to decide whether to load it. Use Markdown in the body for steps, examples, and caveats.
3. How triggering works
When the user asks a question, the Agent matches it against each Skill’s description. If it matches, it loads that Skill and follows it—so the description should include keywords, such as “adding a post,” “code review,” or “deployment.”
Tips
- Keep the description to 1–2 sentences and spell out both what it does and when to use it, so the Agent can route correctly.
- In the steps, prefer real paths, script names, and commands, which cuts down on guesswork for the AI.
- One concrete example beats a long wall of abstract explanation.
- Split complex flows into numbered steps or checklists so the Agent can follow them one by one.
- Call out pitfalls explicitly so you don’t trip over the same mistakes twice.
In short: an AI Skill turns the flow you keep explaining into a document the Agent can pull in on demand. Good Skills make collaboration steadier and faster.
什么是 AI Skill？
AI Skill（在 Cursor 中称为 Agent Skill）是一种可被 AI 按需读取的操作指南。它通常是一个 Markdown 文件（如SKILL.md），带有 YAML 前置元数据，存放在.cursor/skills/或项目的~/.cursor/skills/目录下。当用户的问题与某个 Skill 的描述匹配时，Agent 会主动加载该文件，并按其中的步骤或规则执行任务。
与 Rules 不同：Rules 是「每条消息都会生效」的硬性约束；Skill 则是「按场景触发」的软性指引，适合那些步骤较多、不适合塞进全局规则，但又希望团队统一执行的流程。
AI Skill 的作用
- 一致性：同一类问题，AI 每次都按同一套流程回答，避免临场发挥导致的路径偏差。
- 减少重复：不必在每个会话里反复粘贴同一段提示词，把常用流程沉淀成 Skill 即可。
- 团队共享：项目内的 Skill 可提交到仓库，新成员或新会话都能复用，形成可检索的团队知识。
- 上下文聚焦：按需加载，不占用无关对话的上下文，适合大型项目。
如何使用 AI Skill
1. 创建 Skill 目录与文件
在.cursor/skills/your-skill-name/下新建SKILL.md，或在个人目录~/.cursor/skills/下创建。项目 Skill 仅对当前仓库生效；个人 Skill 对所有项目生效。
2. 编写 YAML 与内容
文件顶部需包含name和description。description 至关重要：用第三人称写明「做什么、什么场景触发」，Agent 据此决定是否加载。正文用 Markdown 写步骤、示例和注意事项。
3. 触发方式
用户提问时，Agent 会比对问题与各 Skill 的 description。若匹配，则加载对应 Skill 并按其中指引执行。因此 description 中应包含关键词，如「添加文章」「代码审查」「部署流程」等。
使用技巧
- description 控制在 1–2 句，同时写清「做什么」和「何时用」，便于 Agent 路由。
- 步骤里尽量写真实路径、脚本名、命令，减少 AI 猜测。
- 一个完整的小例子胜过一大段抽象说明。
- 复杂流程可拆成多步，用清单或编号列出，方便 Agent 逐步执行。
- 如有易错点，单独标出，避免重复踩坑。
总结：AI Skill 就是把「你总在复述的流程」变成「Agent 能主动调用的文档」。善于写 Skill，能让协作更稳、效率更高。
什麽是 AI Skill？
AI Skill（在 Cursor 中稱為 Agent Skill）是一種可被 AI 按需讀取的操作指南。它通常是一個 Markdown 文件（如SKILL.md），帶有 YAML 前置元數據，存放在.cursor/skills/或項目的~/.cursor/skills/目錄下。當用戶的問題與某個 Skill 的描述匹配時，Agent 會主動加載該文件，並按其中的步驟或規則執行任務。
與 Rules 不同：Rules 是「每條消息都會生效」的硬性約束；Skill 則是「按場景觸發」的軟性指引，適合那些步驟較多、不適合塞進全局規則，但又希望團隊統一執行的流程。
AI Skill 的作用
- 一致性：同一類問題，AI 每次都按同一套流程回答，避免臨場發揮導致的路徑偏差。
- 減少重復：不必在每個會話裏反復粘貼同一段提示詞，把常用流程沉澱成 Skill 即可。
- 團隊共享：項目內的 Skill 可提交到倉庫，新成員或新會話都能復用，形成可檢索的團隊知識。
- 上下文聚焦：按需加載，不占用無關對話的上下文，適合大型項目。
如何使用 AI Skill
1. 創建 Skill 目錄與文件
在.cursor/skills/your-skill-name/下新建SKILL.md，或在個人目錄~/.cursor/skills/下創建。項目 Skill 僅對當前倉庫生效；個人 Skill 對所有項目生效。
2. 編寫 YAML 與內容
文件頂部需包含name和description。description 至關重要：用第三人稱寫明「做什麽、什麽場景觸發」，Agent 據此決定是否加載。正文用 Markdown 寫步驟、示例和注意事項。
3. 觸發方式
用戶提問時，Agent 會比對問題與各 Skill 的 description。若匹配，則加載對應 Skill 並按其中指引執行。因此 description 中應包含關鍵詞，如「添加文章」「代碼審查」「部署流程」等。
使用技巧
- description 控制在 1–2 句，同時寫清「做什麽」和「何時用」，便於 Agent 路由。
- 步驟裏盡量寫真實路徑、腳本名、命令，減少 AI 猜測。
- 一個完整的小例子勝過一大段抽象說明。
- 復雜流程可拆成多步，用清單或編號列出，方便 Agent 逐步執行。
- 如有易錯點，單獨標出，避免重復踩坑。
總結：AI Skill 就是把「你總在復述的流程」變成「Agent 能主動調用的文檔」。善於寫 Skill，能讓協作更穩、效率更高。
