Claude Skills 深度解析：82k Star 的官方指南到底讲了什么

术哥

发布于 2026-04-01 19:29:08

6420

🚩2026 年「术哥无界」系列实战文档 X 篇原创计划第 42 篇，Skills 最佳实战「2026」系列第 12 篇大家好，欢迎来到 术哥无界 | ShugeX ｜运维有术。我是术哥，一名专注于 AI 编程、AI 智能体、Agent Skills、MCP、云原生、Milvus 向量数据库的技术实践者与开源布道者！ Talk is cheap, let's explore。无界探索，有术而行。

2025 年 10 月，Anthropic 做了一件有意思的事：他们把驱动 Claude 文档能力的核心技术开源了。

这就是 Skills。GitHub 上 82.3k Star，8.6k Fork，30+ AI 工具已经支持。

说真的，翻完官方文档和源码后，我发现这不是一个简单的插件系统，而是一整套 AI Agent 能力扩展的设计哲学。

Skills 到底是什么？

官方定义很简单：

Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks.

翻译过来就是：一个目录，里面有指令、脚本和资源，Claude 会根据需要动态加载。

听起来很朴素？但这里有几个关键点值得细说。

动态加载，不是常驻内存

这是 Skills 和 Custom Instructions 的核心区别。

Custom Instructions 是全局设置，每次对话都会加载。比如你设置了保持简洁，Claude 在所有对话中都会遵守这个偏好。

Skills 是按需加载。Claude 会先看 description 判断这个 Skill 是否相关，相关才加载详细内容。

这意味着什么？你理论上可以有无限多的 Skills，而不用担心上下文爆炸。

可组合性

Skills 可以组合使用。

比如你在做一个产品发布，可能同时用到：

brand-guidelines：确保所有文档符合品牌规范
technical-documentation：生成技术文档
product-launch：执行发布流程

Claude 会自动识别需要哪些 Skills，并把它们组合起来执行任务。

开放标准

2025 年 12 月，Anthropic 把 Skills 发布成了开放标准（agentskills.io）。

这意味着：

Cursor 可以用
GitHub Copilot 可以用
你自己开发的 Agent 也可以用

一次编写，到处运行，这对于开发者来说是个巨大的优势。

技术架构：三层渐进式披露

这是 Skills 设计中最精妙的部分。

官方采用了渐进式披露（Progressive Disclosure）的架构，分三层：

Level 1: Metadata (name + description)
    ↓ Agent 判断是否相关
Level 2: SKILL.md Body (核心指令)
    ↓ Agent 加载详细指导
Level 3: Linked Files (reference.md, scripts/)
    ↓ Agent 按需访问具体资源

第一层：元数据

---
name:brand-guidelines
description:ApplyAcmeCorpbrandguidelinestoallpresentationsanddocuments
dependencies:python>=3.8
---

只有两个字段是必需的：

name：Skill 的唯一标识符（最多 64 字符）
description：清晰描述功能和适用场景（最多 200 字符）

Claude 在接收到用户请求后，会先扫描所有 Skills 的 metadata，判断哪些相关。

写好 description 很关键。太模糊，Claude 不知道什么时候该用；太具体，又可能漏掉相关场景。

第二层：核心指令

# Brand Guidelines

## When to Apply

Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients

## Core Guidelines

### Logo Usage
- Minimum size: 100px width
- Clear space: 2x logo height on all sides
- Never stretch or distort

### Color Palette
- Primary: #2D5BFF
- Secondary: #FF6B35
- Accent: #00D4AA

这是 Skill 的主体部分。当 Claude 判断这个 Skill 相关后，会加载这部分内容到上下文中。

第三层：链接资源

my-skill/
├── SKILL.md           # 核心指令
├── reference.md       # 详细参考资料
├── scripts/           # 可执行脚本
│   └── validate.py
└── resources/         # 资源文件
    ├── templates/
    └── assets/

第三层是按需访问的。比如：

reference.md 可以包含完整的品牌手册（几百页）
scripts/ 可以包含自动化验证脚本
resources/ 可以包含模板文件

Claude 只在真正需要时才会去读这些文件。

这种设计的好处是什么？

避免上下文过载：不需要一次性加载所有内容
精准匹配：只加载真正相关的 Skills
理论上无限容量：一个 Skill 可以包含任意多的参考资料

五种常见设计模式

翻完官方示例和社区实践，我发现 Skills 的设计模式大致可以归为五类。

模式一：品牌规范类

场景：确保所有输出符合企业视觉标准

---
name:brand-guidelines
description:Applycompanybrandguidelinestopresentationsanddocuments
---

# Brand Guidelines

## When to Apply
-Creatingpresentations
-Designingmarketingmaterials
-Writingexternalcommunications

## Guidelines
[品牌规范详情...]

## Resources
-Logo files:/resources/logos/
-Color codes:/resources/colors.json
-Font files:/resources/fonts/

典型应用：

企业内部所有文档自动应用品牌规范
营销材料保持视觉一致性
客户报告符合公司标准

模式二：工作流程类

场景：将复杂流程固化成可复用能力

---
name:product-launch
description:Guideproductlaunchprocessfromplanningtoexecution
---

# Product Launch Workflow

## Phases

### Phase 1: Planning
-[]Definelaunchgoals
-[]Identifytargetaudience
-[]Settimeline

### Phase 2: Preparation
-[]Createmessagingframework
-[]Developmarketingmaterials
-[]Trainsalesteam

### Phase 3: Execution
-[]Coordinatelaunchactivities
-[]Monitormetrics
-[]Gatherfeedback

典型应用：

产品发布流程
项目管理模板
合规检查流程

模式三：文档标准化类

场景：技术文档、报告等有固定格式要求的内容

---
name:technical-documentation
description:Createtechnicaldocumentationfollowingstandardformat
---

# Technical Documentation

## Structure

### 1. Overview
-Purpose
-Scope
-Audience

### 2. Architecture
-Systemdesign
-Componentoverview
-Dataflow

### 3. API Reference
-Endpoints
-Request/Responseformat
-Errorcodes

典型应用：

API 文档生成
技术规范编写
用户手册制作

模式四：数据分析类

场景：特定领域的数据处理和分析

---
name:customer-feedback-analysis
description:Analyzecustomerfeedbackandextractactionableinsights
dependencies:pandas,matplotlib
---

# Customer Feedback Analysis

## Process

### 1. Data Collection
-Importfeedbackfrommultiplesources
-Standardizeformat

### 2. Classification
-Categorizebytopic
-Identifysentiment
-Flagurgentissues

### 3. Pattern Recognition
-Findrecurringthemes
-Tracktrendsovertime

### 4. Prioritization
-Scorebyimpact
-Rankbyfrequency

典型应用：

用户反馈分析
销售数据报告
市场调研总结

模式五：准备工作类

场景：会议、演讲、销售通话等准备

---
name:sales-call-prep
description:Prepareforsalescallswithresearchandtalkingpoints
---

# Sales Call Preparation

## Checklist

### Account Research
-[]Companyoverview
-[]Recentnews
-[]Keydecisionmakers
-[]Currentsolutions

### Engagement Summary
-[]Previousinteractions
-[]Openopportunities
-[]Outstandingissues

### Talking Points
-[]Valueproposition
-[]Relevantcasestudies
-[]Objectionresponses

典型应用：

销售通话准备
会议议程生成
演讲大纲制作

从零开始创建一个 Skill

说了这么多理论，来点实际的。

假设你要创建一个周报生成的 Skill，完整流程是这样的：

第一步：创建目录结构

mkdir -p weekly-report-skill/resources

第二步：编写 SKILL.md

---
name: weekly-report
description: Generate structured weekly team reports with achievements, blockers, and priorities
---

# Weekly Team Report

## When to Apply

Generate a weekly report when:
- User asks for **weekly report** or **week summary**
- User wants to summarize team progress
- User needs to prepare for weekly meeting

## Report Structure

### 1. Key Achievements
List 3-5 significant accomplishments:
- What was completed
- Impact of the work
- Who was involved

### 2. Blockers & Challenges
Identify obstacles:
- What's blocking progress
- Help needed
- Proposed solutions

### 3. Next Week's Priorities
Top 3-5 focus areas:
- Specific goals
- Expected outcomes
- Resource needs

### 4. Metrics (Optional)
Include relevant data:
- Sprint velocity
- Bug count
- Customer feedback

## Output Format

Use clear, concise language. Bullet points preferred. Keep it scannable.

第三步：添加模板（可选）

<!-- resources/template.md -->

# Weekly Report - [Team Name]
Week of: [Date Range]

## Key Achievements
1. [Achievement 1]
2. [Achievement 2]
3. [Achievement 3]

## Blockers
- [Blocker 1] - [Status/Help Needed]
- [Blocker 2] - [Status/Help Needed]

## Next Week's Priorities
1. [Priority 1]
2. [Priority 2]
3. [Priority 3]

## Metrics
- [Metric 1]: [Value]
- [Metric 2]: [Value]

第四步：测试和迭代

测试清单：

[ ] Description 准确描述触发场景
[ ] 多种表述都能触发（周报、这周总结、weekly report）
[ ] 生成的报告符合预期结构
[ ] 内容简洁、可扫描

实战建议：避坑指南

坑一：Description 写得太模糊

❌ description:Helpwithreports

✅description:Generatestructuredweeklyteamreportswithachievements,blockers,andpriorities

后果：Claude 不知道什么时候该用，可能该用的时候没用，不该用的时候乱用。

坑二：试图做一个全能的 Skill

❌ 一个 Skill 既做文档，又做分析，还做设计

✅ 一个 Skill 只做一件事，做好一件事

后果：难以维护，难以触发，难以复用。

坑三：忽略When to Apply部分

❌ 直接开始写指令，没说明适用场景

✅ 明确列出触发条件
## When to Apply
- Scenario 1
- Scenario 2

后果：Claude 不知道什么时候该加载这个 Skill。

坑四：安全意识不足

风险点：

Prompt injection：恶意指令注入
数据泄露：脚本执行导致数据外泄
未授权操作：执行非预期动作

防护措施：

只安装来自可信源的 Skills
使用前审查 Skill 内容
检查代码依赖和脚本
在沙盒环境中测试

Skills vs 其他能力：如何选择？

特性	Skills	Projects	Custom Instructions	MCP
作用范围	所有对话	单个项目	所有对话	外部工具连接
加载方式	动态按需	静态常驻	静态常驻	按需调用
内容容量	大（渐进式）	中等	小	取决于工具
适用场景	特定任务流程	项目知识库	通用偏好	外部服务集成
可复用性	高（跨平台）	低	中	中

简单来说：

想让 Claude 在所有对话中都记住你的偏好？-> Custom Instructions
有一个长期项目需要累积上下文？-> Projects
需要连接 Notion、Figma 等外部服务？-> MCP
想把某个工作流程固化成可复用能力？-> Skills

而且，这些能力可以组合使用。你完全可以在一个 Project 中，同时使用 Skills 和 MCP。

Skills 的未来：Agent 自我进化？

翻官方博客的时候，有一段话引起了我的注意：

未来，我们希望 Agent 能够自主创建和优化 Skills，将成功模式固化成可重用能力。

这意味着什么？

Agent 不只是使用 Skills，还能创造 Skills。

想象一个场景：Claude 在处理某个复杂任务时，发现了一套有效的工作方法。它可以自动把这套方法封装成一个 Skill，下次遇到类似任务时直接复用。

这才是 Skills 的终局：Agent 的自我进化能力。

当然，目前这还是愿景。但开放标准的发布，30+ 平台的支持，82k 的 Star 数，都在说明一件事：

Skills 可能成为 AI Agent 能力扩展的事实标准。

总结

说了这么多，用三句话概括：

Skills 的本质：把成功的工作流程固化成可复用能力。

Skills 的价值：一次创建，多处使用；避免重复说明；确保输出一致性。

Skills 的未来：Agent 自我进化的基础能力。

如果你经常重复做某类任务，或者希望团队输出保持一致，Skills 值得一试。

从简单的开始：一个 SKILL.md 文件，几十行 Markdown，就够了。

相关资源

官方文档：https://support.claude.com/en/articles/12512176-what-are-skills

GitHub 仓库：https://github.com/anthropics/skills

开放标准：https://agentskills.io

官方博客：https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

好啦，谢谢你观看我的文章，如果喜欢可以点赞转发给需要的朋友，我们下一期再见！敬请期待！

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2026-03-03，如有侵权请联系 cloudcommunity@tencent.com 删除

脚本