Beste Agent Skills für Claude Code und Codex: Was installieren, Repo vorher prüfen und warum ein neuer Skill nicht ausgelöst wird

Name

Soren Atelier

Aktualisiert am 15.11.2026

Die Kurzfassung: Installieren Sie einzelne Skills, kein ganzes Repository. Drei Regeln:

1. Nach Aufgabe auswählen. Beginnen Sie mit einem kleinen, reinen Text-Paket wie obra/superpowers (15 Skills) oder einem einzelnen Skill wie socratic-tutor von Jane Street. Kataloge wie google/skills (203 Skills) und NVIDIA/skills (452) lassen Sie liegen, bis Sie einen bestimmten Skill daraus brauchen.
2. Erst lesen, dann installieren. Ein Skill besteht aus Anweisungen und optionalen Skripten, die mit den Berechtigungen Ihres Agents laufen. Das Audit-Skript weiter unten (Schritt 1) listet auf, welche Skills Code mitbringen und welche Dateien Sie zuerst öffnen sollten. Es liest nur Dateien.
3. Nach der Installation das Listing prüfen. Claude Code zeigt dem Modell eine Liste mit Namen und Beschreibungen der Skills und begrenzt diese Liste. Auf einem Rechner, der bereits 98 Skills hatte, wurde ein neu installierter Skill nur mit seinem Namen gelistet. Das Modell hatte also keine Beschreibung, mit der es eine Anfrage abgleichen konnte. Führen Sie /skill-doctor aus und schaffen Sie dann mit skillOverrides Platz im Budget oder erhöhen Sie es mit skillListingBudgetFraction.

Was getestet wurde: Jede Zahl hier stammt aus Shallow Clones vom 15. November 2026 und aus Claude Code 2.1.325 unter macOS. Das Audit-Skript, claude plugin validate, /skill-doctor und das Debug-Log wurden tatsächlich ausgeführt. Ob das Modell einen Skill danach von sich aus auswählt, wurde nicht getestet, ebenso wenig SkillSpector, der Installer npx skills und Codex. Die Tabelle gegen Ende („Getestet vs. dokumentiert“) trennt beides.

Zehn Skill-Repos im Vergleich

Agent Skills sind Ordner mit einer SKILL.md-Datei, die Claude Code, Codex und andere Agents bei Bedarf laden. Wenn es Ihnen um das Format selbst geht: Codex vs Claude Code Skills behandelt Pfade, Frontmatter und das Teilen eines Skills zwischen beiden Tools. Auf dieser Seite geht es darum, die Skills anderer auszuwählen und zu installieren.

Das Interesse an Skill-Repos ist Anfang November sprunghaft gestiegen. Jane Street veröffentlichte am 3. November ein Repository mit einem einzigen Skill, das auf Hacker News 712 Punkte erreichte. GoogleChrome/modern-web-guidance erschien am 10. November in Version 1.0.0. anthropics/skills legte in einer Woche um etwa 6.200 Sterne zu.

Die Tabelle zählt jede SKILL.md im jeweiligen Repository. „Zeichen Beschreibung“ ist die Gesamtlänge der description-Texte, also das, was ein Agent für jeden Skill in jedem Turn lädt. Die letzte Spalte setzt das ins Verhältnis zum Listing-Budget von 30.000 Zeichen, das Claude Code auf dem Testrechner gemeldet hat.

Drei Dinge fallen auf.

• Die Größe unterscheidet sich um zwei Größenordnungen. Wer google/skills oder NVIDIA/skills komplett installiert, sprengt das Listing um ein Mehrfaches. Beide READMEs erlauben die Installation einzelner Skills: NVIDIA mit --skill, Google über die Auswahl im Installer.
• Die meisten Skills sind reines Markdown. 552 der 782 Skills bringen überhaupt keinen Code mit. Die Skills mit Code konzentrieren sich auf Dokumente, Medien und Cloud, wo ein Skript den deterministischen Teil übernimmt.
• Vorab freigegebene Tools sind außerhalb eines einzigen Katalogs selten. 126 Skills in NVIDIA/skills und 2 in google/skills deklarieren allowed-tools. Keines der anderen acht Repositories tut das.

Welches Repo für welche Aufgabe

• obra/superpowers ist eine vollständige Arbeitsmethode: Brainstorming, Plan schreiben, Plan ausführen, systematisch debuggen, verifizieren, bevor etwas als fertig gilt. Gemessen am Kontext ist es das günstigste große Paket.
• addyosmani/agent-skills ähnelt eher einer Sammlung von Engineering-Checklisten: Code-Review, API-Design, CI, Observability, Security-Härtung. Die Beschreibungen sind länger, deshalb kosten 25 Skills etwa viermal so viel wie Superpowers.
• mattpocock/skills setzt auf kurze Befehle, die Sie selbst aufrufen (/grill-me, /tdd, /to-spec). Es enthält acht in-progress-Skills.
• anthropics/skills ist das Referenz-Set. Wer mit Daten arbeitet, will meist die Skills xlsx, pdf, docx und pptx, die die Skripte mitliefern, mit denen die Dateien tatsächlich erzeugt werden. Wenn Ihre Analyse in Notebooks lebt, deckt ein Agent, der direkt in Jupyter arbeitet, etwa RunCell (opens in a new tab), den Teil ab, den diese Datei-Skills nicht abdecken.
• GoogleChrome/modern-web-guidance besteht aus zwei Skills mit einer CLI dahinter, die einen Guide-Index durchsucht. Ziel ist, Agents von veralteten Frontend-Mustern fernzuhalten.
• kajisho5/ffmpeg-skill ist ein großer Skill mit 107 Code-Dateien, der an zwei Stellen gespiegelt vorliegt, dazu 14 eigene Projekt-Skills des Autors unter .claude/skills. Installieren Sie ihn mit seinem Installer, nicht durch Kopieren des Repositorys.

Schritt 1: Ein Skill-Repo prüfen, bevor Sie es installieren

Die Anweisungen eines Skills landen im Kontext Ihres Agents, und seine Skripte laufen mit den Berechtigungen Ihrer Sitzung. Das Repository vorher zu lesen ist der einzige Schutz. Also sollte das Lesen schnell gehen.

Dieses Skript durchläuft einen Ordner, findet jede SKILL.md und gibt aus, welche Skills Code mitbringen und welche Muster enthalten, die einen Blick wert sind. Es nutzt nur die Python-Standardbibliothek und führt nie etwas aus dem Ordner aus, den es scannt.

#!/usr/bin/env python3
"""Read-only audit of SKILL.md folders. Runs nothing from the repo it scans."""
import os, re, sys
 
RISKY = {
    "pipe-to-shell": r"(curl|wget)[^\n|]*\|\s*(sudo\s+)?(ba|z)?sh",
    "reads-secrets": r"\.ssh/|\.aws/credentials|\.env\b|id_rsa|\.netrc|keychain",
    "sudo": r"\bsudo\s",
    "rm-rf": r"\brm\s+-[a-zA-Z]*r[a-zA-Z]*f|\brm\s+-[a-zA-Z]*f[a-zA-Z]*r",
    "skip-permissions": r"dangerously-skip-permissions|bypassPermissions|--yolo",
    "hidden-unicode": r"[\u200b\u200c\u200d\u2060\u202a-\u202e\U000e0000-\U000e007f]",
}
CODE = (".py", ".sh", ".js", ".mjs", ".ts", ".rb", ".ps1")
 
def frontmatter(text):
    m = re.match(r"^---\n(.*?)\n---\n?", text, re.S)
    if not m:
        return None, text
    fields, key = {}, None
    for line in m.group(1).splitlines():
        k = re.match(r"^([A-Za-z_-]+):\s*(.*)$", line)
        if k:
            key = k.group(1)
            fields[key] = k.group(2).strip().strip("\"'")
        elif key and line.startswith((" ", "\t")):
            fields[key] += " " + line.strip()
    return fields, text[m.end():]
 
def audit(root):
    rows = []
    for folder, dirs, files in os.walk(root):
        dirs[:] = [d for d in dirs if d not in (".git", "node_modules")]
        if "SKILL.md" not in files:
            continue
        text = open(os.path.join(folder, "SKILL.md"), encoding="utf-8", errors="replace").read()
        fields, body = frontmatter(text)
        everything, code_files = text, 0
        for sub, _, names in os.walk(folder):
            for n in names:
                if n.endswith(CODE):
                    code_files += 1
                if n.endswith(CODE + (".md",)) and n != "SKILL.md":
                    try:
                        everything += open(os.path.join(sub, n), encoding="utf-8", errors="replace").read()
                    except OSError:
                        pass
        flags = [name for name, pat in RISKY.items() if re.search(pat, everything)]
        if fields is None:
            flags.append("no-frontmatter")
            fields = {}
        if fields.get("allowed-tools"):
            flags.append("allowed-tools")
        if "hooks" in fields:
            flags.append("hooks")
        if re.search(r"!`[^`]+`|```!", body):
            flags.append("shell-injection-block")
        desc = (fields.get("description", "") + " " + fields.get("when_to_use", "")).strip()
        rows.append((os.path.relpath(folder, root), len(desc), len(body), code_files, flags))
    return rows
 
if __name__ == "__main__":
    rows = audit(sys.argv[1])
    listing = sum(d for _, d, _, _, _ in rows)
    print(f"{len(rows)} skills, {listing:,} description chars (~{listing // 4:,} tokens if all are listed)")
    print(f"{sum(1 for r in rows if r[3])} skills ship code files, {sum(r[3] for r in rows)} code files in total")
    for path, desc, body, code, flags in sorted(rows, key=lambda r: (-len(r[4]), r[0])):
        if flags or "-v" in sys.argv:
            print(f"  {path}: desc={desc} body={body} code={code} flags={','.join(flags) or '-'}")

Klonen Sie das Repository an einen Ort außerhalb Ihres Projekts und richten Sie das Skript darauf.

git clone --depth 1 https://github.com/obra/superpowers /tmp/superpowers
python3 audit_skills.py /tmp/superpowers

Die Ausgabe für Superpowers am 15. November:

15 skills, 2,317 description chars (~579 tokens if all are listed)
3 skills ship code files, 6 code files in total
  skills/brainstorming: desc=213 body=14933 code=3 flags=rm-rf
  skills/subagent-driven-development: desc=85 body=19484 code=0 flags=rm-rf
  skills/systematic-debugging: desc=91 body=9366 code=2 flags=reads-secrets

So lesen Sie die Flags

Ein Flag bedeutet „diese Datei öffnen“, nicht „dieser Skill ist bösartig“. Jedes Flag, das in diesen zehn Repositories von Hand geprüft wurde, war harmlos. Der rm-rf-Treffer in Superpowers ist rm -rf "$SESSION_DIR" in einem Skript, das seinen eigenen Temp-Ordner aufräumt. Der hidden-unicode-Treffer in ffmpeg-skill ist ein Zero-Width Joiner in einer Anmerkung zu Hindi-Ligaturen. reads-secrets schlägt bei jeder Erwähnung von .env an, auch bei dem Rat, keine einzuchecken.

Die letzten drei sind in Claude Code am wichtigsten. allowed-tools gibt Tools ohne Nachfrage frei, und zwar für den Turn, der den Skill aufruft. Ein hooks-Eintrag läuft für den Rest der Sitzung weiter. Ein !`command`-Block wird ausgeführt, wenn der Skill geladen wird.

Zwei weitere Prüfungen

Claude Code kann das Frontmatter für Sie validieren. Für einen Ordner mit 91 installierten Skills lief das fehlerfrei durch. Bei einem Repository, das nicht als Plugin verpackt ist, schlägt es mit No manifest found fehl. Daran erkennen Sie, dass sich das Repository nur kopieren lässt.

claude plugin validate .claude/skills

Für einen tieferen Scan gibt es SkillSpector (opens in a new tab) von NVIDIA, einen spezialisierten Scanner mit 71 Mustern und einem Risiko-Score von 0 bis 100. Das README nennt Folgendes als schnellen Einstieg; für diesen Artikel wurde es nicht ausgeführt.

uv tool install git+https://github.com/NVIDIA/skillspector.git
skillspector scan ./my-skill/ --no-llm

Schritt 2: Nur installieren, was Sie brauchen

Einen einzelnen Ordner zu kopieren ist die Installationsmethode mit den wenigsten beweglichen Teilen, und es ist die, die hier getestet wurde.

git clone --depth 1 https://github.com/janestreet/agent_skills /tmp/agent_skills
mkdir -p .claude/skills
cp -R /tmp/agent_skills/socratic-tutor .claude/skills/

Das Zielverzeichnis entscheidet, wo der Skill geladen wird.

Nehmen Sie für alles, was Sie nur ausprobieren, den Projektordner. So bleibt der Skill aus Ihren anderen Sitzungen heraus, und wenn Sie den Ordner löschen, ist er wieder weg.

Die beiden anderen Wege stammen aus dem README des jeweiligen Projekts und wurden hier nicht ausgeführt.

• Plugins installieren ein ganzes Paket und werden über /plugin aktualisiert. Zum Beispiel /plugin marketplace add anthropics/skills, danach /plugin install document-skills@anthropic-agent-skills. Superpowers installieren Sie mit /plugin install superpowers@claude-plugins-official.
• Die skills-CLI von Vercel Labs kopiert Dateien für viele Agents auf einmal ins Projekt: npx skills add addyosmani/agent-skills --skill test-driven-development -a claude-code. Mit --list können Sie vorher stöbern.

Ein Vorbehalt aus der Claude-Code-Dokumentation: skillOverrides gilt nicht für Plugin-Skills. Ist ein Plugin-Paket zu groß, deaktivieren Sie das Plugin, nicht einzelne Skills.

Schritt 3: Prüfen, ob der neue Skill wirklich gelistet ist

Dieser Schritt deckt eine Ursache für „installiert, wird aber nie ausgelöst“ auf, die keine Fehlermeldung erzeugt.

Claude Code gibt dem Modell ein Listing mit Name und Beschreibung jedes Skills. Das Listing hat ein Budget, standardmäßig 1 % des Kontextfensters. Läuft es über, behält Claude Code jeden Namen, streicht aber Beschreibungen, und zwar zuerst bei den Skills, die Sie am seltensten nutzen. Ein frisch installierter Skill hat null Nutzungen. Die Claude-Code-Dokumentation beschreibt den Mechanismus im Abschnitt „Skill descriptions are cut short“ (Skill-Beschreibungen werden gekürzt) (opens in a new tab); die Zahlen unten zeigen, wie das in der Praxis aussieht.

So sah das auf einem Rechner aus, der bereits 84 persönliche Skills und 14 Plugin-Skills hatte. Nach dem Kopieren eines einzigen neuen Skills stand im Debug-Log:

[WARN] Skill listing over budget: 112 skills, 37491 chars > 30000 budget — descriptions will be truncated.

Und /skill-doctor zeigte den neuen Skill nur mit Namen gelistet:

Kosten von < 20 sind für sich genommen kein Beweis, denn auch ein Skill mit einer einzeiligen Beschreibung kostet weniger als 20. Vergleichen Sie den Wert mit der Länge der Beschreibung. Die Zahlen unten berücksichtigen nur Skills, deren Beschreibungen lang genug sind, um das zu unterscheiden.

Mehr Skills machten es für alle anderen schlimmer. Mit 91 installierten Projekt-Skills wurden 76 gelistet, und 70 davon hatten eine Beschreibung von 80 Zeichen oder mehr verloren. Mit 289 stieg die Zahl der persönlichen Skills, die ihre Beschreibung verloren hatten, von 6 auf 39: Die Neuzugänge verdrängten die Beschreibungen von Skills, die bis dahin funktioniert hatten.

Die Prüfung ausführen

/skill-doctor gibt pro Skill eine Zeile mit seinen Listing-Kosten aus. Der Befehl braucht Claude Code 2.1.252 oder neuer und funktioniert im -p-Modus.

claude -p "/skill-doctor"

Um die Budget-Warnung selbst zu sehen, schreiben Sie ein Debug-Log und durchsuchen es.

claude --debug-file /tmp/cc-debug.log -p "hello"
grep "Skill listing over budget" /tmp/cc-debug.log

Das Problem beheben

Schalten Sie zuerst ab, was Sie nicht nutzen. Das gehört in .claude/settings.json für das Projekt oder in ~/.claude/settings.json für jedes Projekt.

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

"name-only" hält einen Skill als /name aufrufbar und entfernt seine Beschreibung aus dem Listing. "off" blendet ihn vollständig aus. In einer interaktiven Sitzung schreibt /skills dieselbe Einstellung: Drücken Sie auf einer Zeile Space, um ihren Zustand zu wechseln, und speichern Sie dann mit Esc.

Wenn Sie wirklich alles nutzen, erhöhen Sie stattdessen das Budget. Das kostet in jedem Turn Kontext.

{
  "skillListingBudgetFraction": 0.02
}

Codex hat denselben Mechanismus mit anderen Zahlen. Laut Dokumentation nutzt die anfängliche Skill-Liste höchstens 2 % des Kontextfensters oder 8.000 Zeichen, wenn das Fenster unbekannt ist. Sie kürzt zuerst Beschreibungen und kann Skills mit einer Warnung ganz aus der Liste weglassen. skills.max_context_tokens ändert das Budget, und ein [[skills.config]]-Eintrag mit enabled = false in ~/.codex/config.toml deaktiviert einen einzelnen Skill.

Schritt 4: Einen Skill unbeaufsichtigt laufen lassen

Claude Code 2.1.325, veröffentlicht am 13. November, hat ein Verhalten geändert, das geplante Aufgaben betrifft. Geplante Aufgaben (Scheduled Tasks) und /loop fragen jetzt nach, bevor sie einen Skill ausführen, der allowed-tools oder Hooks deklariert. Damit ein solcher Skill ohne Abfrage läuft, erlauben Sie ihn namentlich.

{
  "permissions": {
    "allow": ["Skill(release-notes)"]
  }
}

Umgekehrt geht es auch. Eine Deny-Regel wie Skill(deploy *) hindert das Modell daran, einen Skill aufzurufen, und ein Deny auf Skill ohne Argument schaltet alle ab. Beides stammt aus der Claude-Code-Dokumentation. Claude Code Berechtigungen absichern behandelt die übrigen Berechtigungseinstellungen, die es wert sind, in ein Repository eingecheckt zu werden.

Schritt 5: Einen Skill entfernen

• Kopierter Skill: Löschen Sie seinen Ordner unter .claude/skills/ oder .agents/skills/.
• Plugin-Skill: /plugin uninstall <plugin>@<marketplace>, oder deaktivieren Sie ihn in /plugin.
• Behalten, aber nicht mehr automatisch nutzen: Setzen Sie ihn in skillOverrides auf "name-only" oder "off", oder ergänzen Sie disable-model-invocation: true im Frontmatter, wenn die Datei Ihnen gehört.

Getestet vs. dokumentiert

Das Budget von 30.000 Zeichen ist der Wert, den ein einzelner Rechner gemeldet hat. Ihres hängt vom Kontextfenster des Modells ab. Lesen Sie also Ihr eigenes Debug-Log, bevor Sie sich auf die Prozentspalte verlassen.

FAQ

Welche Agent Skills sollte ich in Claude Code zuerst installieren?

Fangen Sie klein an. obra/superpowers liefert einen vollständigen Workflow aus Planen, Testen, Debuggen und Review in 15 Skills. addyosmani/agent-skills ergänzt 25 Engineering-Checklisten. Für Tabellen, PDFs und Präsentationen installieren Sie das Plugin document-skills aus anthropics/skills. Aus großen Katalogen installieren Sie einzelne Skills statt des Ganzen.

Warum wird mein neuer Claude Code Skill nicht ausgelöst?

Auf einem Rechner mit vielen Skills liegt das Listing vermutlich über dem Budget, und der neue Skill ist nur mit Namen gelistet. Führen Sie /skill-doctor aus. Kontextkosten unter 20 bei einem Skill mit langer Beschreibung bedeuten, dass die Beschreibung gestrichen wurde. Schalten Sie ungenutzte Skills mit skillOverrides ab oder erhöhen Sie skillListingBudgetFraction.

Wie prüfe ich, ob ein Skill sicher ist, bevor ich ihn installiere?

Klonen Sie ihn außerhalb Ihres Projekts und lesen Sie ihn. Achten Sie auf mitgelieferte Skripte, allowed-tools, hooks und !`command`-Blöcke. Das Audit-Skript oben listet sie für jede SKILL.md auf, ohne etwas auszuführen.

Wie viele Skills sind zu viele für Claude Code?

Das hängt von der Länge der Beschreibungen ab, nicht von der Anzahl. Zwanzig Skills aus anthropics/skills belegen etwa 9.500 Zeichen eines Budgets von 30.000 Zeichen. google/skills braucht komplett etwa 107.600.

Was macht /skill-doctor?

Der Befehl gibt jeden geladenen Skill mit Quelle, Listing-Kosten, Token-Verbrauch der letzten 7 Tage und Zahl der Aufrufe aus und markiert die nie genutzten. Er braucht Claude Code 2.1.252 oder neuer.

Wo lege ich einen Skill ab, damit Claude Code und Codex ihn beide nutzen können?

.claude/skills/ für Claude Code und .agents/skills/ für Codex, im Projekt oder in Ihrem Home-Verzeichnis. Behalten Sie eine Kopie und verlinken Sie die andere per Symlink.

Kann ich einen Skill deaktivieren, ohne ihn zu löschen?

Ja: mit skillOverrides in den Einstellungen von Claude Code oder mit [[skills.config]] und enabled = false in Codex. Plugin-Skills verwalten Sie über /plugin.

Warum fragt ein Scheduled Task in Claude Code 2.1.325 nach, bevor er meinen Skill ausführt?

Scheduled Tasks und /loop fragen jetzt nach, bevor sie einen Skill ausführen, der allowed-tools oder Hooks deklariert. Ergänzen Sie Skill(name) unter permissions.allow.

Quellen

• Extend Claude with skills (opens in a new tab) und die Settings-Referenz (opens in a new tab), Claude-Code-Dokumentation
• Claude Code Changelog (opens in a new tab), Version 2.1.325
• Build skills (opens in a new tab), Codex-Dokumentation
• Agent-Skills-Spezifikation (opens in a new tab)
• READMEs von vercel-labs/skills (opens in a new tab) und NVIDIA/SkillSpector (opens in a new tab)
• Socratic Tutor auf Hacker News (opens in a new tab)

Verwandte Guides

• Codex vs Claude Code Skills: Einrichtung, Einstellungen und wie man Skills in beiden Tools gemeinsam nutzt
• Claude Code Berechtigungen absichern: Schreibzugriffe außerhalb des Repos blockieren, ablehnen statt nachfragen, settings.local.json prüfen
• Claude Code Mods Tutorial: Eigenen Mod erstellen, testen und installieren
• OpenCode nutzen: Schnellstart, 7 praktische Tipps und wann Oh My OpenCode sinnvoll ist
• Codex nutzen: Einstieg, 5 praktische Tipps und Best Practices