Skills-Tutorial
Skills sind im Wesentlichen Betriebsanleitungen, die der KI beibringen, Dinge in einem festen Prozess zu erledigen. Einmal geschrieben, können sie wie Funktionen wiederholt aufgerufen werden.
Wir können uns Skills alsWie man eine bestimmte Art von Sache professionell erledigtDieses "How-to" wird in ein wiederverwendbares, automatisch ausgelöstes Fähigkeitsmodul verpackt.
Skills existieren als Markdown-Dateien. Sie führen keine Funktionen aus; stattdessen erreichen sie durch bedarfsgesteuertes, progressives Laden eine effiziente und wiederverwendbare Wissensvermittlung.
Der größte Unterschied zwischen Skills und traditionellen Prompts ist: bedarfsgesteuertes Laden + progressive Offenlegung (das dicke SOP nur bei Bedarf in den Kontext stopfen, was viele Tokens spart).
| Vergleichspunkt | Gewöhnlicher Prompt | Skills-Mechanismus |
|---|---|---|
| Muss jedes Mal neu beschrieben werden | Ja | Nein (nur einmal beschrieben) |
| Nutzung der Kontextlänge | Jedes Mal vollständig geladen | Progressives Laden (liest den vollständigen Inhalt nur, wenn ausgelöst) |
| Konsistenz | Hängt von der Qualität des jeweiligen Prompts ab | Hoch (festes SOP + Vorlagen) |
| Wiederverwendbarkeit | Manuelles Kopieren und Einfügen | Automatisches Matching / Slash-Befehle / Projekt-Sharing |
| Wartungsmethode | Jede Prompt-Änderung erfordert erneutes Senden | Ändere die Datei SKILL.md; wirkt global/für das Projekt |
Wenn wir zum Beispiel normalerweise Artikel schreiben, mussten wir vor Skills jedes Mal die folgenden Schritte wiederholen:
帮我总结文章 → 翻译 → 改成公众号风格 → 加标题 → 输出 Markdown
Mit Skills:
Du brauchst nur einen Satz:
使用「技术文章转公众号」Skill
Die KI führt die von dir festgelegten Schritte automatisch aus.
Stell dir KI als einenklugen, aber unerfahrenen Berufseinsteiger-Praktikanten vor:
- Normaler Prompt= Du musst ihm jedes Mal von Grund auf beibringen, wie er Dinge erledigt (heute einmal beibringen, morgen erneut anlernen)
- Regel / Gedächtnis= Du hängst einen „Unternehmensverhaltenskodex“ an seinem Arbeitsplatz aus (immer in Kraft, regelt aber nur Haltung und Format)
- MCP / Tools= Du installierst eine Menge Software und APIs auf seinem Computer (er kann externe Tools aufrufen, weiß aber nicht, wann er sie einsetzen oder wie er sie kombinieren soll)
- Skills= Du gibst ihm direkt ein ganzes Set„Job-Training-Paket“(PDF + Flussdiagramm + SOP + Gesprächsskript-Vorlagen + gängige Skripte) und sagst ihm: „Wenn der Chef dich bittet, so etwas zu tun, folge den Methoden in diesem Ordner.“
Mainstream-Clients, die derzeit Skills unterstützen:
| Ranking | Tool-Name | Ob Skills kostenlos nutzbar sind | Empfohlene Nutzer | Standardpfad für die Skill-Speicherung | Hinweise |
|---|---|---|---|---|---|
| 1 | Claude Code | Ja (offiziell) | Alle | ~/.claude/skills | Standardsetter, umfassendstes Ökosystem |
| 2 | Cursor | Ja | Am häufigsten für Coding verwendet | ~/.cursor/skills | Nahezu nahtlos kompatibel mit Claude Skills |
| 3 | Trae / OpenCode | Ja | Preis-Leistungs-Orientierte | Hängt von den Tool-Einstellungen ab | Mehr Nutzer in China |
| 4 | VS Code + Plugin | Teilweise unterstützt | Nutzen VS Code bereits intensiv | In den Plugin-Einstellungen konfigurieren | Holt schnell auf |
| 5 | Coze / andere chinesische Plattformen | Teilweise unterstützt | Web-Version bevorzugen | Plattform kommt mit einem Skill-Marktplatz | Einige erfordern eine Mitgliedschaft |
Der Unterschied zwischen Skills und MCP:Skills werden verwendet fürWissenswiederverwendung, MCP wird verwendet fürFähigkeitserweiterung。
Skills
Wissenswiederverwendung
- Wissensaustausch: Erfahrungen, Best Practices, Arbeitsabläufe
- Basierend auf einfachen Markdown-Dateien kann sie jeder erstellen
- Progressives Laden, hohe Token-Effizienz
- Keine Server- oder Backend-Einrichtung erforderlich
- Geeignet für Web / Desktop / CLI
MCP
Fähigkeitserweiterung
- Funktionale Erweiterung: Verbindung von APIs, Datenbanken, externen Tools
- Erfordert Programmierkenntnisse und serverseitige Konfiguration
- Lädt alle Tool-Definitionen beim Start
- Starke Integration mit externen Systemen
- Höherer Tokenverbrauch und höhere Komplexität
Die Kernstruktur eines Skills
Der Kern von Skills ist:Ein Ordner + eine SKILL.md-Datei。
Die SKILL.md-Datei enthält:
- Metadaten (mindestens einen Namen und eine Beschreibung)
- Anweisungen, die der KI sagen, wie eine bestimmte Aufgabe zu erledigen ist

Ein Skill ist im Wesentlichen eine Markdown-Datei (Dateiname fest als SKILL.md)
my-skill/ └── SKILL.md (唯一必需)
Basis-SKILL.md-Vorlage:
--- name: pdf-processing description: 从 PDF 中提取文本和表格,填写表单,并合并文档 --- # PDF 处理 ## 使用场景 当需要对 PDF 文件进行操作时使用,例如: - 提取 PDF 文本或表格数据 - 填写 PDF 表单 - 合并多个 PDF 文件 ## 提取文本 - 使用 `pdfplumber` 提取文本型 PDF 内容 - 扫描版 PDF 需配合 OCR 工具 ## 填写表单 - 读取 PDF 表单字段 - 按输入数据填充并生成新文件
Minimal erforderliches Beispiel:
--- name: skill-name description: 说明该 Skill 的功能以及适用场景 ---
Beispiel mit optionalen Feldern:
--- name: pdf-processing description: 从 PDF 中提取文本和表格,填写表单,并合并文档 license: Apache-2.0 metadata: author: example-org version: "1.0" ---
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| name | Ja | Skill-Name, bis zu 64 Zeichen, darf nur Kleinbuchstaben, Zahlen und-, und darf nicht beginnen oder enden mit-dem Anfang oder Ende |
| description | Ja | Beschreibung der Funktionalität und der Nutzungsszenarien, bis zu 1024 Zeichen, darf nicht leer sein |
| license | nein | Lizenzname oder Verweis auf die mit dem Skill gebündelte Lizenzdatei |
| Kompatibilität | nein | Beschreibung der Umgebung und Abhängigkeiten (Produkte, Systempakete, Netzwerkberechtigungen usw.), bis zu 500 Zeichen |
| metadata | nein | Benutzerdefinierte Schlüssel-Wert-Paare zum Erweitern von Metadaten (z. B. Autor, Version) |
| allowed-tools | nein | Liste der zulässigen Tools (durch Leerzeichen getrennt, experimentelles Feature) |
Wenn Sie Referenzmaterialien, Referenzbeispiele oder Ausführungsskripte benötigen, können Sie die Verzeichnisstruktur eines komplexeren Skills verwenden:
my-skill/ ├── SKILL.md # 必需:指令 + 元数据 ├── scripts/ # 可选:可执行代码 ├── references/ # 可选:文档资料 └── assets/ # 可选:模板、资源
So funktionieren Skills
Skills verwenden progressives Laden, um den Kontext effizient zu verwalten:
- Entdeckung:Beim Start lädt die KI nur den Namen und die Beschreibung jedes Skills und behält nur die grundlegendsten Identifikationsinformationen.
- Aktivierung:Wenn eine Aufgabe mit der Beschreibung eines Skills übereinstimmt, lädt die KI die vollständigen SKILL.md-Anweisungen in den Kontext.
- Ausführung:Die KI führt gemäß den Anweisungen aus und lädt bei Bedarf Referenzdateien oder führt Code aus.
Dieses Design hält die KI schnell und ermöglicht es ihr, bei Bedarf weitere Informationen abzurufen.
Claude Code Skills
Als Nächstes nehmen wir Claude Code als Beispiel, um einen einfachen Skill zu erstellen.
Claude Code sucht und lädt Skills in der folgenden Reihenfolge (je spezifischer der Ort, desto höher die Priorität):
| Stufe | Pfad | Wirksamer Geltungsbereich |
|---|---|---|
| Enterprise | Konfiguriert über die Admin-Konsole (verwaltete Einstellungen) | Alle Benutzer in der Organisation |
| Persönlich | ~/.claude/skills/<skill-name>/SKILL.md |
Alle Ihre Projekte |
| Projekt | .claude/skills/<skill-name>/SKILL.md |
Nur das aktuelle Projekt |
| Plugin | <plugin>/skills/<skill-name>/SKILL.md |
Umgebungen, in denen dieses Plugin aktiviert ist |
Jeder Skill ist ein Ordner, und der Ordnername ist die Skill-Kennung (kebab-case, Kleinschreibung + Bindestriche, empfohlen).
Minimale Struktur:
~/.claude/skills/
└── code-comment-expert/ # 技能文件夹名
└── SKILL.md # 唯一必填文件(必须全大写 + .md 小写)
Vollständiges SKILL.md-Format:
--- # YAML frontmatter 开始(顶格) name: code-comment-expert # 必填:技能名(也是 /slash 命令名) description: >- # 必填:最关键一行!Claude 靠它判断是否加载 为代码添加专业、清晰的中英双语注释。 适合缺少文档、可读性差、需要分享审查的代码。 常见触发场景:加注释、注释一下、加文档、explain this、improve readability trigger_keywords: # 强烈推荐(大幅提升自动触发率) - 加注释 - 注释 - 加文档 - explain code - document - comment this - readability version: 1.0 # 可选 author: yourname # 可选 --- # ← YAML 结束 # 这里开始是正文(Markdown)—— Claude 真正执行时的指令 你现在是「专业代码注释专家」。 ## 核心原则 - 只在缺少注释或可读性明显不足处添加 - 优先使用英文 JSDoc / TSDoc 风格 - 复杂逻辑 / 非明显意图处额外加一行中文解释 - 注释精炼,每行不超过 80 字符 - 绝不修改原有逻辑 ## 输出格式(严格遵守) 1. 先输出完整修改后的代码块(用 ```语言 包裹) 2. 再用 diff 形式展示只改动注释的部分 3. 最后说明加了哪些注释、理由 现在直接开始处理用户提供的代码,不要闲聊。
Erweiterte Dateistruktur (empfohlen, wenn Skills komplex werden)
Wenn ein Skill 500–800 Zeilen überschreitet oder Vorlagen/Skripte/Referenzmaterialien erfordert, wird die folgende Organisation empfohlen:
~/.claude/skills/react-component-review/
├── SKILL.md # 核心指令 + 元数据(建议控制在 400 行内)
│
├── templates/ # 常用模板(Claude 按需读取)
│ ├── functional.tsx.md
│ └── class-component.md
│
├── examples/ # 优秀/反例(给 Claude 看标准)
│ ├── good.md
│ └── anti-pattern.md
│
├── references/ # 规范、规则、禁用词表
│ ├── hooks-rules.md
│ └── naming-convention.md
│
└── scripts/ # 可执行脚本(需开启 code execution)
├── validate-props.py
└── check-cycle-deps.sh
Beispiel für die Referenzierung in SKILL.md:
Markdown需要给出标准函数组件时,参考 templates/functional.tsx.md 的结构。
如果违反 Hooks 规则,对照 references/hooks-rules.md 第 3–5 条说明。
如需校验 propTypes,可执行 scripts/validate-props.py "{代码片段}"。Nachdem Claude die Pfadreferenz gesehen hat, lädt es die entsprechende Datei bei Bedarf, anstatt alles auf einmal in den Kontext zu stopfen, was Token erheblich spart.
Dein erster Skill
Vergessen wir vorübergehend den komplexen Erstellungsprozess und beginnen wir mitder Verwendung eines fertigen Skills, um den Komfort zu erleben, den er bietet.
Ein Skill-Verzeichnis erstellen
Skills werden in~/.claude/skills/(persönlich global) oder unter dem Projektverzeichnis.claude/skills/(projektspezifisch) gespeichert.
In diesem Abschnitt wird unter dem Projektverzeichnis getestet. Erstellen Sie zuerst ein Verzeichnis claude-test:
mkdir claude-test
Wechsle in dieses Verzeichnis, erstelle das skills-Verzeichnis und die Dateien:
mkdir -p .claude/skills/python-naming-standard
Schreibe die Konfigurationsdatei SKILL.md
Erstelle SKILL.md im Verzeichnis. Dies ist das Gehirn des Skills und teilt Claude mit, wann er ihn verwenden soll.
--- name: Python 内部命名规范技能 description: 当用户要求重构、审查或编写 Python 代码时,请参考此规范。 --- ## 指令 1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。 2. 如果发现不符合此规则的代码,请自动提出修改建议。 3. 在执行 `claude commit` 前,必须检查此规范。 ## 参考示例 - 正确:`def _internal_calculate_risk():` - 错误:`def _calculate_risk():`
Feldanforderungen:
- name: Nur Kleinbuchstaben, Zahlen und Bindestriche verwenden (max. 64 Zeichen)
- description: Kurze Beschreibung des Skills und wann er verwendet werden soll (max. 1024 Zeichen)
Nach der Erstellung sieht die Dateistruktur wie folgt aus:

Ihr Projekt sollte jetzt so aussehen:
my-project/ ├─ src/ │ └─ test.py # 项目源码 ├─ .claude/ │ ├─ skills/ │ │ └─ hello-world/ │ │ ├─ skill.md # Skill 定义(YAML + Instructions,机器可执行) │ │ └─ README.md # Skill 说明(人类阅读,可选) │ └─ config.yml # Claude 项目级配置(可选) ├─ .gitignore └─ README.md # 项目整体说明
Führen Sie als Nächstes den folgenden Befehl im Terminal aus, um Claude Code zu starten:
claude
Geben Sie die Aufgabe ein:
Help me write a function that calculates user discounts.
Claude durchsucht die installierten Skills, stellt fest, dass Ihre Anfrage "das Schreiben von Python-Code" betrifft, und gleicht sie mit python-naming-standard ab.

Es wird den folgenden Code basierend auf den Anforderungen in SKILL.md generieren:
def _internal_get_discount(user_score):
# 计算逻辑...
return discount
Ressourcendateien hinzufügen (optional)
Zusätzlich können wir unter.claude/skills/die folgenden Verzeichnisse hinzufügen:
Fügen Sie im selben Ordner hinzu:
examples/: Speichert Beispieldateien.references/: Speichert Referenzdokumente.scripts/: Speichert ausführbare Skripte (z. B. Python zur Verarbeitung von PDFs).
Verweisen Sie dann in SKILL.md darauf:
查看示例 commit:./examples/good-commit.txt 运行脚本:使用工具执行 ./scripts/process.py
Zusammenstellung relevanter Ressourcen zu Agent Skills
| Ressourcenbeschreibung | Link |
|---|---|
| Skill-Aggregations-Eintrag | https://skills.sh/ |
| Skills Marketplace (chinesische Oberfläche) | https://skillsmp.com/zh |
| Tencents Skills Marketplace | https://skillhub.tencent.com/ |
| Offizielle Standard-Website für Agent Skills | https://agentskills.io |
| Offizieller Anthropic-Engineering-Artikel (praktische Konzepte für Agent Skills) | https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills |
| VS Code Copilot Agent Skills-Dokumentation | https://code.visualstudio.com/docs/copilot/customization/agent-skills |
| Offizielles Anthropic Skills GitHub-Repository | https://github.com/anthropics/skills |
| Kuratierte Liste von Claude-Skills (Awesome-Reihe) | https://github.com/ComposioHQ/awesome-claude-skills |
| Skill-Sammlung für Automatisierungs-Workflows in der Softwareentwicklung | https://github.com/obra/superpowers |
| Ein Skill, der automatisch Skills generiert (offizielles Beispiel) | https://github.com/anthropics/skills/tree/main/skills/skill-creator |
Empfohlene Skills:
| Skill | Kernfunktion | Installationsbefehl |
|---|---|---|
| find-skills (vercel-labs) | Zentrum für Skill-Suche und -Empfehlungen | npx skills add vercel-labs/skills |
| vercel-react-best-practices | Standards zur Performance-Optimierung für React / Next | npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices |
| frontend-design (anthropics) | Fähigkeit für hochwertiges UI-Design | npx skills add anthropics/skills --skill frontend-design |
| web-design-guidelines | Standards für Web-Barrierefreiheit und UX | npx skills add vercel-labs/agent-skills --skill web-design-guidelines |
| remotion-best-practices | Best Practices für React-Videoproduktion | npx skills add remotion-dev/skills --skill remotion-best-practices |
| Brainstorming (superpowers) | Fähigkeit zu strukturiertem Denken und Planen | npx skills add obra/superpowers --skill brainstorming |
| agent-browser | Steuerung der Browser-Automatisierung | npx skills add vercel-labs/agent-browser |
| browser-use | Hochleistungsfähige Browser-Interaktion | npx skills add browser-use/browser-use |
| supabase-postgres-best-practices | Supabase / PostgreSQL-Optimierung | npx skills add supabase/agent-skills --skill supabase-postgres-best-practices |
| azure-cost-optimization | Azure-Cloud-Kostenoptimierung | npx skills add microsoft/github-copilot-for-azure --skill azure-cost-optimization |
| cloudflare/skills | Praktiken für Workers und Edge Computing | npx skills add cloudflare/skills |
| redis/agent-skills | Fortgeschrittene Redis-Muster und Anti-Patterns | npx skills add redis/agent-skills |
| vercel-composition-patterns | Standards für React-Kompositionsmuster | npx skills add vercel-labs/agent-skills --skill vercel-composition-patterns |
| vercel-react-native-skills | Offizielle Best Practices für React Native | npx skills add vercel-labs/agent-skills --skill vercel-react-native-skills |
| sleek-design-mobile-apps | Moderner Leitfaden für Mobile-App-Design | npx skills add sleekdotdesign/agent-skills --skill sleek-design-mobile-apps |
| ui-skills | UI- und Interaktionspraktiken auf Designer-Niveau | npx skills add ibelick/ui-skills |
| pdf (anthropics) | PDF-Generierung und Parsing-Fähigkeit | npx skills add anthropics/skills --skill pdf |
| seo-audit | SEO-Audit und Optimierung | npx skills add coreyhaines31/marketingskills --skill seo-audit |
| skill-creator | Fähigkeit zum Erstellen benutzerdefinierter Skills | npx skills add anthropics/skills --skill skill-creator |
| code-review-expert | Professionelle Code-Review-Fähigkeit | npx skills add sanyuan0704/code-review-expert |