Claude Code Best Practice (Claude Skill) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Plan-then-execute-Vorlagen (kein 'schreib einfach den Code')
Validierungs-Hook-Muster zum Auffangen von Regressionen
Postmortem- und Review-Vorlagen
Refactoring-/Migrations-Checklisten
Funktioniert mit Claude Code, Codex, OpenCode

Live-Demo

In der Praxis

bereit

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-best-practice-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-best-practice-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-best-practice-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/shanraisshan/claude-code-best-practice",
          "~/.claude/skills/claude-best-practice"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add claude-best-practice-skill -- git clone https://github.com/shanraisshan/claude-code-best-practice ~/.claude/skills/claude-best-practice

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Claude Code Best Practice

Einen Plan-then-execute-Flow bei einer nicht-trivialen Änderung erzwingen

👤 Devs, die es leid sind, dass Agents ohne Nachdenken loslegen ⏱ ~30 min intermediate

Wann einsetzen: Die Änderung berührt mehr als 3 Dateien oder hat unklaren Umfang.

Ablauf

Planen

Use claude-best-practice. Write a plan for refactoring auth: scope, sequence, risks, rollback. Do not write code yet.✓ Kopiert

→ Plan-Dokument; kein Code
Kritisieren

Critique your own plan as if you were the senior reviewer. What's missing?✓ Kopiert

→ Kritik mit konkreten Korrekturen
Ausführen

Now execute step 1 of the revised plan. Stop after that step.✓ Kopiert

→ Schritt 1 erledigt; wartet auf Freigabe

Ergebnis: Refactoring landet sauber, weil es durchdacht wurde.

Fallstricke

Plan zu abstrakt — Auf Datei-Granularität im Plan bestehen

Ein Postmortem nach einem Incident mit Hilfe des Agents durchführen

👤 On-Call / SREs ⏱ ~45 min intermediate

Wann einsetzen: Etwas ist schiefgelaufen und du musst es dokumentieren.

Ablauf

Sammeln

Use the postmortem template. Pull the timeline from /logs and recent commits.✓ Kopiert

→ Timeline automatisch erstellt
Five Whys

Walk through five-whys on the root cause. Distinguish proximate from contributing.✓ Kopiert

→ Gestufte Ursachen
Action Items

Generate action items with owners and due dates.✓ Kopiert

→ Liste mit Owner-Vorschlägen zur Überprüfung markiert

Ergebnis: Postmortem-Dokument, das beim nächsten Mal hilft, keine Schuldzuweisungen.

Fallstricke

Automatisch zugewiesene Owner sind falsch — Owner-Zuweisungen immer vor der Veröffentlichung überprüfen

Kombinieren mit: filesystem

Die Migrations-Checkliste für ein Framework-Upgrade verwenden

👤 Devs bei einem großen Upgrade (z. B. React 18 → 19) ⏱ ~60 min intermediate

Wann einsetzen: Migration erstreckt sich über viele Dateien; kein Schritt soll vergessen werden.

Ablauf

Übernehmen

Apply the migration template to React 18→19. Customize for our codebase.✓ Kopiert

→ Angepasste Checkliste
Verfolgen

Walk through the checklist, marking done/blocked for each item.✓ Kopiert

→ Fortschrittsprotokoll

Ergebnis: Keine 'wir haben X vergessen zu aktualisieren'-Überraschungen nach der Migration.

Fallstricke

Checkliste veraltet — Für jede Hauptversion aktualisieren; der Skill liefert das Grundgerüst

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

claude-best-practice-skill + everything-claude-code-skill

Zwei meinungsstarke Kits kombinieren — Best-Practice-Prompting + Research-first-Defaults

Use claude-best-practice for plan-then-execute; everything-claude-code for research-first.✓ Kopiert

claude-best-practice-skill + filesystem

Pläne und Postmortems neben dem Code persistieren

Save the plan to /docs/plans/auth-refactor.md before executing.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
make_plan	task description	Vor jeder nicht-trivialen Änderung	tokens
critique_plan	plan	Nach Plan, vor Ausführung	tokens
postmortem_draft	logs, commits, summary	Nach Incidents	tokens

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: N/A
Tokens pro Aufruf: Fügt Planungskosten hinzu, reduziert aber Redo-Schleifen
Kosten in €: Kostenlos
Tipp: Planungsschritt bei wirklich trivialen Änderungen überspringen

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Read access to logs/commits for postmortems

Credential-Speicherung: Keine

Datenabfluss: Keine

Fehlerbehebung

Häufige Fehler und Lösungen

Plans are too generic

Konkreten Repo-Kontext geben; der Skill verankert sich an dem, was du gibst

Conflicts with team's existing process

Selektiv übernehmen — Postmortem-Vorlage allein hat hohen Wert

Alternativen

Claude Code Best Practice vs. andere

Alternative	Wann stattdessen	Kompromiss
everything-claude-code-skill	Du willst ein vollständigeres Bundle (Memory, Security, Instincts)	Größere Oberfläche zum Erlernen
Hand-rolled CLAUDE.md rules	Hochgradig maßgeschneiderte Workflows	Mehr zu pflegen

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen