mdskills
← Dokumentation

So installierst du Agenten-Skills

Skills sind einfach Ordner mit einer SKILL.md-Datei. Einen zu installieren bedeutet, diesen Ordner an die richtige Stelle für deinen Agenten zu legen. Hier erfährst du, wo das für jedes Tool ist.

Der universelle Ansatz

Jeder Agent liest Skills aus einem bestimmten Verzeichnis. Es gibt zwei Geltungsbereiche:

Projekt-Skills

Liegen in deinem Repository. Werden in die Versionskontrolle eingecheckt. Stehen allen zur Verfügung, die an dem Projekt arbeiten.

Persönliche Skills

Liegen in deinem Home-Verzeichnis. Stehen in all deinen Projekten zur Verfügung. Nur du kannst sie nutzen.

Manuell herunterladen und speichern

Der einfachste Ansatz — keine CLI-Tools nötig:

  1. Finde einen Skill auf mdskills.ai und klicke auf der Detailseite auf den Download-Button.
  2. Erstelle den Skill-Ordner in deinem Projekt. Zum Beispiel für Claude Code:
    mkdir -p .claude/skills/my-skill
  3. Speichere die Datei als SKILL.md in diesem Ordner:
    mv ~/Downloads/SKILL.md .claude/skills/my-skill/
  4. Starte deinen Agenten neu (oder beginne eine neue Sitzung). Der Skill ist jetzt verfügbar.

Der Ordnername wird zum Skill-Namen. Ein Ordner namens review-pr wird zum /review-pr-Befehl in Agenten, die Slash-Commands unterstützen.

Wo speichern? Schau in die agentenspezifische Anleitung weiter unten für den genauen Verzeichnispfad deines Tools. Kurzfassung: Die meisten Agenten nutzen .{agent}/skills/{name}/SKILL.md im Projektstammverzeichnis.

Schnellinstallation per CLI

Der schnellste Weg, einen Skill aus einem GitHub-Repository zu installieren:

# Install from mdskills.ai
npx mdskills install <skill-name>
# Or use the Vercel CLI
npx skills add <owner>/<repo>
# Or install manually — just clone and copy
git clone https://github.com/owner/skills-repo.git
cp -r skills-repo/my-skill .claude/skills/

CLI-Tools erkennen deine installierten Agenten und legen Skills automatisch in die richtigen Verzeichnisse. Aber du brauchst kein CLI — den Ordner manuell zu kopieren funktioniert genauso gut.

Einrichtung pro Agent

Claude Code

Dokumentation
Projekt:.claude/skills/<skill-name>/SKILL.md
Persönlich:~/.claude/skills/<skill-name>/SKILL.md

Claude Code hat die umfassendste Skill-Unterstützung. Skills erscheinen als Slash-Commands — ein Skill namens review-pr wird zu /review-pr. Claude lädt Skills auch automatisch, wenn deine Anfrage zur Beschreibung eines Skills passt.

Wenn du bereits Dateien in .claude/commands/ hast, funktionieren diese weiterhin. Skills sind das neuere Format und unterstützen zusätzliche Features wie gebündelte Skripte und Frontmatter-Konfiguration.

Claude Code unterstützt auch Plugins, die mehrere Skills zusammen mit MCP Servern und anderen Erweiterungen bündeln können. Installiere Plugins über /plugins in der Kommandozeile.

Projekt:.cursor/skills/<skill-name>/SKILL.md
Persönlich:~/.cursor/skills/<skill-name>/SKILL.md

Cursor hat seinen Marketplace im Februar 2026 mit Unterstützung für Skills als Teil seines Plugin-Systems gestartet. Skills sind eine von fünf Plugin-Grundbausteinen neben MCP Servern, Subagenten, Hooks und Regeln.

Du kannst Skills auch in .agents/skills/ ablegen — dieser Pfad wird von mehreren Agenten erkannt und ist eine gute Wahl, wenn dein Team verschiedene Tools nutzt.

VS Code (Copilot)

Dokumentation
Projekt:.github/skills/<skill-name>/SKILL.md
Persönlich:~/.copilot/skills/<skill-name>/SKILL.md

VS Code unterstützt Agenten-Skills über GitHub Copilot. Skills kommen für Projekt-Skills in .github/skills/, was bedeutet, dass sie automatisch zusammen mit deinem Code in der Versionskontrolle verfolgt werden.

VS Code erkennt auch .claude/skills/ und .agents/skills/. Du kannst zusätzliche Suchpfade mit der Einstellung chat.agentSkillsLocations konfigurieren.

Tippe / im Copilot-Chat, um verfügbare Skills zu sehen und sie direkt aufzurufen.

OpenAI Codex

Dokumentation
Projekt:.agents/skills/<skill-name>/SKILL.md
Persönlich:~/.agents/skills/<skill-name>/SKILL.md

Codex verwendet standardmäßig das Verzeichnis .agents/skills/. Dies ist der herstellerneutrale Pfad, den mehrere Agenten erkennen, was ihn zur sicheren Wahl macht, wenn du Skills veröffentlichst, die mit verschiedenen Tools funktionieren sollen.

Gemini CLI

Dokumentation
Projekt:.gemini/skills/<skill-name>/SKILL.md
Persönlich:~/.gemini/skills/<skill-name>/SKILL.md

Gemini CLI liest ebenfalls aus .agents/skills/ als Fallback. Wenn du speziell Gemini CLI ansprichst, verwende den Pfad .gemini/skills/. Für agentenübergreifende Kompatibilität nutze .agents/skills/.

Agentenübergreifende Kompatibilität

Wenn du einen Skill veröffentlichst und möchtest, dass er überall funktioniert, verwende den Pfad .agents/skills/. Die meisten Agenten prüfen dieses Verzeichnis als Fallback. Für projektspezifische Skills, bei denen dein Team alle das gleiche Tool nutzt, verwende den herstellerspezifischen Pfad.

Tipp: Du kannst den gleichen Skill in mehreren Verzeichnissen haben. Manche Teams verlinken ihre Skills per Symlink über verschiedene Pfade, damit sie unabhängig vom verwendeten Agenten funktionieren. Ein einfaches ln -s genügt.

Überprüfen, ob es funktioniert hat

Nach der Installation eines Skills prüfe, ob dein Agent ihn sehen kann:

  • Claude Code: Frage "Welche Skills sind verfügbar?" oder tippe /, um Skills im Autocomplete-Menü zu sehen.
  • VS Code: Tippe / im Copilot-Chat-Bereich.
  • Jeder Agent: Frage "Hast du einen Skill für [Aufgabe]?" und schau, ob er die Beschreibung erkennt.

Wenn der Skill nicht angezeigt wird, überprüfe die Ordnerstruktur. Das Verzeichnis muss eine SKILL.md-Datei enthalten (Groß-/Kleinschreibung beachten).