入门必看入门

什么是 Claude Code Skill？

Skill 是 Claude Code 的「专业技能包」。给它一个 Skill，它就能在特定场景下表现得更专业。

📋 SKILL.md 完整代码

---
name: what-is-skill
description: >-
  Skill 是 Claude Code 的「专业技能包」。给它一个 Skill，它就能在特定场景下表现得更专业。
  Use when working on what is skill tasks.
allowed-tools: Read,Write,Bash
---

# 什么是 Claude Code Skill？

## Quick Start
1. Save as `~/.claude/skills/what-is-skill/SKILL.md`
2. Restart Claude Code
3. Type `/what-is-skill` or describe your task naturally
4. Claude auto-triggers when your task matches the description

## Instructions
- Understand the user's specific context and needs
- Apply domain best practices consistently
- Provide actionable, specific guidance with examples
- Verify all outputs before presenting to user

## Gotchas
- Test with a fresh Claude instance after changes
- Keep SKILL.md under 500 lines; use references/ for details
- Description is the trigger key — make it specific and keyword-rich

🚀 怎么用

1. 复制上面的 SKILL.md 代码
2. 保存为 ~/.claude/skills/what-is-skill/SKILL.md
3. 重启 Claude Code
4. 输入 /what-is-skill 或直接描述任务触发
5. AI 自动按 Skill 流程执行

一句话理解

Skill = 给 AI 写的「专业操作手册」。告诉它遇到什么情况、按什么流程、用什么工具、输出什么格式。一个 Skill 就是一个可复用的专业能力包。类比：Skill = 菜谱，Agent = 厨师。

Skill 和 Prompt 的区别

Prompt 是一次性的指令，用完就没了。Skill 是持久的、可复用的、可共享的。装了 Skill 之后，AI 在每次遇到相关任务时都会按 Skill 的流程来执行。这就是从「每次都要说清楚」到「一次配置，永久生效」的升级。

Skill 的四大作用域

REPO（仓库级，团队共享，放在项目 .claude/skills/）→ USER（用户级，所有项目通用，放在 ~/.claude/skills/）→ ADMIN（机器级，整台电脑生效）→ SYSTEM（Codex/Claude 内置的官方 Skill）。优先级：企业 > 个人 > 项目。

快速上手

创建目录 mkdir -p ~/.claude/skills/my-skill，编写 SKILL.md（包含 YAML 头部和 Markdown 正文），重启 Claude Code，用自然语言描述任务测试触发，或用 /my-skill 手动调用。