如何写好一个Skill

[1. 实战举例](#1. 实战举例)
2.Skill到底是什么东西
- [2.1 拆开一个skill](#2.1 拆开一个skill)
- - SKILL.md
  - [assets > report-template.md](#assets > report-template.md)
  - references
  - scripts
[3. Skill VS 系统提示词](#3. Skill VS 系统提示词)
[4. Skill VS MCP](#4. Skill VS MCP)
[5. 高质量的Skill](#5. 高质量的Skill)
[6. Claude Code Skill 完整优先级（从高到低，官方标准）](#6. Claude Code Skill 完整优先级（从高到低，官方标准）)
- [6.1 目录 / 来源优先级（同名直接覆盖，高优覆盖低优）](#6.1 目录 / 来源优先级（同名直接覆盖，高优覆盖低优）)
[7. 如何判断一个Skill值不值得装](#7. 如何判断一个Skill值不值得装)
[8. 从零写一个SKILL](#8. 从零写一个SKILL)
[9. 在项目中创建一个subagent](#9. 在项目中创建一个subagent)
[N. 附录](#N. 附录)

1. 实战举例

Mav Content Factory ---全部由 Skills 驱动的内容创作工作台
调研、写稿、配图、做视频、封面、多平台分发一每个环节由不同 Skill 串联执行
核心机制：上一个Skill 的输出=下一个Skill的输入
两条生产线，每条都是多 Skill 协同的活样本

2.Skill到底是什么东西

2.1 拆开一个skill

在claude code中对话

bash 复制代码

❯ 帮我开发一个技能，名字：security-audit，功能：

  1. 检查代码中是否有密码等敏感信息泄露
  2. 检查SQL等代码是否有注入等漏洞风险
  3. 配置文件中有没有明文的敏感信息泄露
  4. 其它你认为有安全隐患的代码

bash 复制代码

  ~/.claude/skills/security-audit/
  ├── SKILL.md                          158 行 - 主入口:触发描述、四大类总览、工作流程、判定原则
  └── references/
      ├── credentials.md                124 行 - 硬编码密钥/密码/连接串,含云厂商密钥模式
      ├── injection.md                  233 行 - SQL/命令/LDAP/SSRF/路径穿越/XXE
      ├── config.md                     214 行 - YAML/Nacos/Dockerfile/K8s 里的明文敏感信息
      └── other.md                      289 行 - 反序列化/弱加密/鉴权/日志脱敏/CVE 等 15 项
      
(base) ➜  security-audit ls
SKILL.md   assets     references scripts

SKILL.md

assets > report-template.md

references

config.md

scripts

bash 复制代码

(base) ➜  security-audit cd scripts
(base) ➜  scripts ls
scan.sh

3. Skill VS 系统提示词

系统提示词：公司规章制度，全员常驻扁平文本、全局加载，放不下参考范例，嵌入不了可执行文本，每次对话都占慢上下文。
Skill：岗位工具箱，用到才翻三层结构：指令+案例+脚本渐进式加载 ，按需查询。模块化、可组合、可分享。

4. Skill VS MCP

5. 高质量的Skill

从skill.sh上下载 https://www.skills.sh/
Plugin Skills(插件市场安装)

bash 复制代码

注册官方仓库为内置市场：
/plugin marketplace add anthropics/skills

bash 复制代码

 ~/.claude/plugins/marketplaces/claude-plugins-official/plugins/
  ├── frontend-design/skills/frontend-design/
  ├── skill-creator/skills/skill-creator/
  ├── claude-code-setup/skills/
  ├── mcp-server-dev/skills/
  ├── claude-md-management/skills/
  ├── playground/skills/
  ├── example-plugin/skills/
  ├── plugin-dev/skills/
  ├── math-olympiad/skills/
  └── hookify/skills/

第三方综合 Skill 市场
SkillsMP 社区市场（国内可访问）
官网：https://skillsmp.com/zh
收录近 6 万社区开源 Skill，支持关键词检索、分类筛选（前端 / 后端 / 测试 / 文档 / 自动化）
复制 Skill 仓库地址，丢进 Claude Code 对话即可自动下载安装
支持收藏、一键复制安装指令
SkillsMP第三方工具自有一套全局存储标准：统一本体存放 ~/.agents/skills/

bash 复制代码

# 例子
# 下载
npx skills add https://github.com/affaan-m/ECC --skill java-coding-standards
# 迁移 也可以用mv命令
cp -r ~/.agents/skills/java-coding-standards ~/.claude/skills/

6. Claude Code Skill 完整优先级（从高到低，官方标准）

6.1 目录 / 来源优先级（同名直接覆盖，高优覆盖低优）

企业托管 Managed Skills（最高）
路径：/etc/claude/.claude/skills/ / 后台策略下发
特点：组织强制规范，无法被下级任何 Skill 覆盖，全公司所有项目统一生效。
用户全局 User Skills
路径：~/.claude/skills/（你本机所有项目通用）
也就是你之前疑惑的 Claude Code 原生全局目录，/install 命令默认安装到这里。
项目级 Project Skills
路径：当前项目 ./.claude/skills/
仅本仓库生效，可提交 Git 团队共享；同名会被全局 / 企业级覆盖。
手动附加目录 --add-dir
启动命令手动指定的额外 Skill 目录，优先级低于项目目录。
旧兼容 commands 目录（.claude/commands/）
老版自定义命令，同名时会被同级目录下的 Skill 覆盖。
第三方插件内置 Plugin Skills
存放于插件内部，自带命名空间插件名:skill名，不会和上面三层普通 Skill 重名冲突。
Claude Code 内置原生 Bundled Skills（最低）
工具自带基础技能，无同名冲突时兜底，所有自定义 Skill 均可覆盖它

7. 如何判断一个Skill值不值得装

8. 从零写一个SKILL

9. 在项目中创建一个subagent

bash 复制代码

在本项目中，帮我创建一个subagent,名字叫做tester，用于单元测试，当有用户有单元测试的需求的时候都可以调用这个subagent

N. 附录

video 20分钟让你成为skill专家：从原理到自制