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
Weitere Erweiterungen