Agent Skills (Agent Skills)

Agent bedeutet intelligenter Agent, und Skills bedeutet Fähigkeiten. Agent Skills ist ein Kernwerkzeug, das Fachwissen und Workflow-Spezifikationen in wiederverwendbare Assets verwandelt.

Agent Skills ist im Wesentlichen eine modulare Markdown-Datei, die KI-Tools (wie Claude, GitHub Copilot, Cursor usw.) lehren kann, bestimmte Aufgaben auszuführen, und unterstützt automatische Auslösung, Team-Sharing und Engineering-Management, wodurch wiederholte Prompt-Eingaben vollständig überflüssig werden.

Das Wesen von Agent Skills ist kein Werkzeug, sondern:

Eine Kombination aus Verhaltensnormen + Fachwissen + Einsatzzeitpunkt.

Grundlegende Skills-Inhalte als Referenz:Skills-Tutorial

Kernform:

  • Ein Skill ist ein Ordner, der eine SKILL.md-Datei enthalten muss (einschließlich Beschreibung und Metadaten) und optional weitere Ressourcendateien enthalten kann (wie Skripte, Beispiele, Referenzdokumente).

  • Ein Skill ist eine Markdown-Datei (SKILL.md), mit der Claude beigebracht wird, Dinge in bestimmten Szenarien auf Ihre Weise zu erledigen.

  • Im Wesentlichen entspricht es der Ausgabe eines professionellen Handbuchs an einen KI-Agenten. Die KI lernt nicht jedes Mal von Grund auf neu, sondern ruft das Wissen im Handbuch automatisch je nach Aufgabe ab.

  • Einfach gesagt, früher haben wir Prompts verwendet, um der KI beizubringen, wie man Dinge tut; jetzt können wir mit Agent Skills Prompts + Ressourcen in wiederverwendbare, teilbare Skill-Pakete verpacken, was effizienter und zuverlässiger ist.

Wie Agent Skills funktionieren

Der Schlüssel bei Agent Skills ist die schrittweise Offenlegung, geladen in drei Ebenen:

  • Ebene 1: Skill-Entdeckung-- Die KI liest zuerst die Metadaten (Name und Beschreibung) aller Skills, um festzustellen, ob die Aufgabe relevant ist. Diese Metadaten sind immer im System-Prompt.
  • Ebene 2: Kernanweisungen laden-- Falls relevant, liest die KI automatisch den Hauptinhalt von SKILL.md, um detaillierte Anleitung zu erhalten.
  • Ebene 3: Ressourcendateien laden-- Zusätzliche Dateien (z. B. Skripte, Beispiele) nur bei Bedarf lesen oder Skripte über Tools ausführen.

Unterstützte Tools und Umgebungen

Derzeit unterstützt:

  • Claude (Anthropic): Claude.ai, Claude Code, Agent SDK.
  • VS Code + GitHub Copilot: Skills auf Projektebene (.github/skills/) oder auf persönlicher Ebene.
  • Cursor: Skills auf Projektebene (.cursor/skills/) oder globale Skills, unterstützt Installation von GitHub.
  • Weitere: werden erweitert, offener Standard unterhttps://github.com/agentskills/agentskills。

Warum brauchen wir Skills? Welche Probleme lösen sie?

Gewöhnliche KI-Agenten (wie Claude oder Copilot) sind intelligent, aber sie neigen zu Fehlern, wenn ihnen spezifischer Kontext fehlt. Zum Beispiel:

  • Das Team hat seine eigenen Coding-Standards, aber die KI muss jedes Mal manuell daran erinnert werden.
  • Bei komplexen Prozessen wie der Verarbeitung von PDF-Formularen oder dem Debuggen von GitHub Actions kennt die KI möglicherweise nicht die Best Practices.

Agent Skills löst diese Probleme:

  • Automatische Auslösung: Die KI lädt relevante Skills automatisch basierend auf der Aufgabe, sodass keine langen Prompts manuell eingegeben werden müssen.
  • Wiederverwendbar & teilbar: Einmal erstellt, vom gesamten Team oder der Community genutzt, unterstützt die Git-Versionskontrolle.
  • Effiziente Nutzung des Kontexts: Setzt auf progressive Offenlegung, wobei nur die benötigten Teile geladen werden, um ein Überlaufen des Kontextfensters zu vermeiden.
  • Plattformübergreifend: Derselbe Skill kann in Tools wie Claude, VS Code Copilot, Cursor usw. verwendet werden.

Schnelles Verständnis der Kernkonzepte

Konzept Metapher Funktion
Skill Ein eigenständiges Multifunktionswerkzeug wie ein Schweizer Taschenmesser oder ein Kochrezept Eine komplette Suite zur Erledigung einer bestimmten Aufgabe (z. B. E-Mails schreiben, Daten analysieren).
Anweisung Das Benutzerhandbuch des Werkzeugs oder die Schritte eines Rezepts Sagt Claude genau, was zu tun ist, wie zu denken ist und in welchem Format ausgegeben werden soll.
Wissen Die Teileliste des Werkzeugs oder Hintergrundinformationen zu den Zutaten eines Rezepts Dateien (z. B. Produkthandbücher, API-Dokumentation) als dedizierte Wissensbasis des Skills hochladen.
Tool Spezielles Zubehör am Werkzeug (z. B. ein Flaschenöffner) Definiert externe APIs oder Funktionen, die der Skill aufrufen kann, um Daten abzurufen oder Operationen auszuführen.

Ablauf der Skill-Ausführung

  • Ausgehend von der Nutzeranweisung zunächst die Absichtserkennung des Skills durchführen, um zu entscheiden, ob ein kontrollierter Ausführungspfad betreten wird.

  • Nachdem der Skill zugeordnet wurde, lädt das System SKILL.md, legt Werkzeugberechtigungen und Verhaltensgrenzen fest und schlussfolgert dann mit dem Kontext.

  • Externe zulässige Werkzeuge nur aufrufen, wenn es wirklich notwendig ist; andernfalls die Logik innerhalb der Regeln abschließen.

  • Das Endergebnis wird nach der Integration der Einschränkungen ausgegeben, und die nächste Eingabe des Benutzers löst eine neue Runde des vollständigen Ablaufs aus.


Minimale Struktur eines Skills

my-skill/
└── SKILL.md   (唯一必需)

Basis-SKILL.md-Vorlage:

---
name: your-skill-name
description: What it does and when Claude should use it
---

# Skill Title

## Instructions
Clear, concrete, actionable rules.

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

Metadatenfelder:

Feld Erforderlich Beschreibung
name nein Anzeigename des Skills; standardmäßig der Verzeichnisname; nur Kleinbuchstaben, Zahlen und Bindestriche werden unterstützt (max. 64 Zeichen)
description Empfohlen Zweck und Verwendungsszenarien des Skills; Claude verwendet sie, um zu entscheiden, ob er automatisch angewendet wird
argument-hint nein Parameterhinweise, die während der Autovervollständigung angezeigt werden, wie z. B.[issue-number]、[filename] [format]
disable-model-invocation nein Setzen auftrueClaude daran hindern, automatisch auszulösen; nur manuell/nameinvocation (standardmäßig false)
user-invocable nein Setzen auffalsefrom/Im Menü ausgeblendet, wird als Hintergrund-Erweiterungsfunktion verwendet (Standard: true)
allowed-tools nein Tools, die Claude ohne Autorisierung verwenden kann, wenn der Skill aktiv ist
model nein Modell, das verwendet wird, wenn der Skill aktiv ist
context nein Setzen aufforkläuft in einem Subagent-Kontext, wenn gesetzt
agent nein Subagent-Typ (verwendet mit context: fork)
hooks nein Konfiguration der Skill-Lebenszyklus-Hooks

Skills unterstützen das Einfügen dynamischer Variablen in Inhalte:

Variable Beschreibung
$ARGUMENTS Alle Parameter, die beim Aufrufen des Skills übergeben werden
$ARGUMENTS[N] Zugriff auf Parameter per Index, z. B.$ARGUMENTS[0]
$N Kurzschreibweise, z. B.$0Gibt den ersten Parameter an
${CLAUDE_SESSION_ID} Aktuelle Sitzungs-ID, verwendet für Logs, temporäre Dateien und zugehörige Ausgaben

Zum Beispiel:

---
name: session-logger
description: 记录当前会话活动
---

请将以下内容写入日志文件:

logs/${CLAUDE_SESSION_ID}.log

$ARGUMENTS

Aufruf:

/session-logger 用户登录成功

Es werden tatsächlich sitzungsspezifische Log-Einträge generiert.

Kernkomponenten der SKILL.md-Datei

Nehmen wir Claudes PDF-Dokumentbearbeitungs-Skill als Beispiel: Claude kann PDFs nativ parsen, aber nicht direkt manipulieren (z. B. Formulare ausfüllen). Dieser Skill schließt diese Lücke.

  • Kernform:Ein Verzeichnis, das SKILL.md enthält
  • Erforderliche Metadaten:Der YAML-Block am Anfang von SKILL.md muss name und description enthalten; er wird beim Start in den System-Prompt vorgeladen.

Multi-File-Skill (Progressive Disclosure)

Progressive-Disclosure-Mechanismus

  • Ebene 1: Metadaten → ermöglicht Claude, die anwendbaren Szenarien für den Skill zu beurteilen, ohne den gesamten Inhalt zu laden.
  • Ebene 2: SKILL.md-Inhalt → nachdem die Relevanz bestimmt wurde, den vollständigen Kontext laden.
  • Ebene 3+: Angehängte Dateien (z. B. forms.md) → bei Bedarf referenziert, um die Kerndatei kompakt zu halten.

Das folgende Diagramm zeigt, wie sich das Kontextfenster ändert, wenn eine Benutzernachricht den Skill auslöst:

  • Anfangszustand: Das Kontextfenster enthält den System-Prompt, Skill-Metadaten und die Benutzeranweisung.
  • Rufen Sie das Bash-Tool auf, um die Ziel-SKILL.md zu lesen und den entsprechenden Skill auszulösen.
  • Hilfsdateien bei Bedarf laden (z. B. forms.md).
  • Führen Sie die Aufgabe des Benutzers aus, nachdem das Laden abgeschlossen ist.

Empfohlene Verzeichnisstruktur

Um eine Überladung des Kontexts zu vermeiden:

  • Kernregeln →SKILL.md
  • Detaillierte Materialien → separate Dateien
  • Praktische Logik → Skriptausführung (nicht geladen)

Empfohlene Struktur:

my-skill/
├── SKILL.md
├── reference.md
├── examples.md    # 存放示例文件
└── scripts/
    └── helper.py

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 im Projektverzeichnis.claude/skills/(projektspezifisch) gespeichert.

In diesem Kapitel testen wir im Projektverzeichnis. Erstelle 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 generiert den folgenden Code gemäß den Anforderungen in SKILL.md:

def _internal_get_discount(user_score):
    # 计算逻辑...
    return discount

Ressourcendateien hinzufügen (optional)

Zusätzlich können wir.claude/skills/die folgenden Verzeichnisse darunter hinzufügen:

Im selben Ordner fügen Sie hinzu:

  • examples/: speichert Beispieldateien.
  • references/: speichert Referenzdokumente.
  • scripts/: speichert ausführbare Skripte (z. B. Python zum Verarbeiten von PDFs).

Verweisen Sie dann in SKILL.md darauf:

查看示例 commit:./examples/good-commit.txt
运行脚本:使用工具执行 ./scripts/process.py

Offizieller Marketplace

Neben dem Verfassen eigener Skills kannst du auch vom Agent Skills Open Standard profitieren, der Ende 2025 veröffentlicht wurde:

  • Offizieller Marketplace: Besuchehttps://github.com/anthropics/skillsdas Repository, um vorgefertigte Skills herunterzuladen (z. B. React-Optimierer, SQL-Tuning-Tools).
  • Skill Creator: Du kannst zu Claude sagen: "Hilf mir, die Docker-Konfigurationslogik, die ich dir gerade beigebracht habe, in einen Skill zusammenzufassen," und es wird automatisch Dateien für dich im entsprechenden Verzeichnis generieren.

Wir können dieses Repository als Plugin-Marketplace für Claude Code registrieren, indem wir einfach den folgenden Befehl in Claude Code ausführen:

/plugin marketplace add anthropics/skills

Dann kannst du/plugin verwenden, um Folgendes anzuzeigen:

Schritte zum Installieren eines bestimmten Skill-Sets:

  • Plugins durchsuchen und installieren
  • Wähle die Plugin-Quelle anthropic-agent-skills aus

  • Wähle document-skills (Dokument-Skills) oder example-skills (Beispiel-Skills) aus

  • Klicke auf "Jetzt installieren"

Wir können die oben genannten zwei Arten von Plugins auch direkt über Befehle installieren:

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

注意:通过插件安装的 skills 目录位于~/claude/plugins/marketplaces/下。

插件安装完成后,需要重启 Claude Code。

使用时,只需在指令中提及 skill 名称即可调用。例如,安装 document-skills 插件后,可以给 Claude Code 如下指令:

使用 PDF 技能提取 path/to/some-file.pdf 文件中的表单字段

或者生成一个 PPT:

创建一个 Agent Skill 的演示文稿

可以看到它调用了/document-skills:pptx:

开始生成:

随后它会告诉你生成文件的位置:


Agent Skills 相关资源

资源说明 Link
Skill 聚合入口 https://skills.sh/
Skills 市场(中文界面) https://skillsmp.com/zh
Offizielle Standard-Website für Agent Skills https://agentskills.io
Offizieller Engineering-Artikel von Anthropic (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
Ausgewählte Claude Skills Liste (Awesome-Serie) https://github.com/ComposioHQ/awesome-claude-skills
Sammlung von Skills für automatisierte Workflows in der Softwareentwicklung https://github.com/obra/superpowers
Skill, der automatisch Skills generiert (Offizielles Beispiel) https://github.com/anthropics/skills/tree/main/skills/skill-creator
Andere Erweiterungen