Codebase to Course (Claude Skill) — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Einzeldatei-HTML-Ausgabe — keine Build-Pipeline
Architekturübersicht aus realem Code generiert (nicht dem README)
Pro-Modul-Abschnitte: Warum es existiert und wie es funktioniert
Request-Flow-Walkthroughs, die echten Einstiegspunkten folgen
Annotierte Code-Blöcke mit zeilenweisen Erklärungen
Konzipiert für Nicht-Ingenieure (PMs, Designer, neue Mitarbeiter)

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": {
    "codebase-to-course-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/zarazhangrui/codebase-to-course",
        "~/.claude/skills/codebase-to-course"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "codebase-to-course-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/zarazhangrui/codebase-to-course",
        "~/.claude/skills/codebase-to-course"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "codebase-to-course-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/zarazhangrui/codebase-to-course",
        "~/.claude/skills/codebase-to-course"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codebase-to-course-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/zarazhangrui/codebase-to-course",
        "~/.claude/skills/codebase-to-course"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "codebase-to-course-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/zarazhangrui/codebase-to-course",
        "~/.claude/skills/codebase-to-course"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "codebase-to-course-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/zarazhangrui/codebase-to-course",
          "~/.claude/skills/codebase-to-course"
        ]
      }
    }
  }
}

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

claude mcp add codebase-to-course-skill -- git clone https://github.com/zarazhangrui/codebase-to-course ~/.claude/skills/codebase-to-course

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

Anwendungsfälle

Praxisnahe Nutzung: Codebase to Course

Einen selbstgesteuerten Onboarding-Kurs für einen neuen Mitarbeiter generieren

👤 Engineering-Manager / Tech Leads ⏱ ~45 min beginner

Wann einsetzen: Freitag nach Angebotsannahme: ein echtes Onboarding-Artefakt statt "Lies den Code" erstellen.

Voraussetzungen

Skill installiert — git clone https://github.com/zarazhangrui/codebase-to-course ~/.claude/skills/codebase-to-course
Repository ausgecheckt — Standard git clone

Ablauf

Repository scannen

codebase-to-course: ./our-app scannen. Erst die vorgeschlagene Kursstruktur ausgeben — Abschnittsliste — bevor geschrieben wird.✓ Kopiert

→ Konkretes Inhaltsverzeichnis: Architektur, Module, Request-Flows
Kurs generieren

Passt. Das vollständige HTML nach /onboarding/course.html generieren. Zielgruppe: neuer Full-Stack-Entwickler, der React + Node kennt, aber unsere Domain nicht.✓ Kopiert

→ HTML-Datei generiert; öffnet sich im Browser
Genauigkeit prüfen

Stichprobe: Stimmt der "Auth-Flow"-Walkthrough mit dem überein, was tatsächlich in src/auth/ steht? Echten Code zitieren.✓ Kopiert

→ Walkthrough zitiert echte Dateipfade und aktuellen Code

Ergebnis: Ein echtes Onboarding-Artefakt, das dem Team 2 Wochen Erklärungen erspart.

Fallstricke

Kurs ist zu lang, um ihn tatsächlich zu lesen — Maximale Abschnitte angeben; Qualität über Vollständigkeit
Code-Ausschnitte veralten — Nach größeren Refactorings neu generieren; der Skill ist schnell

Kombinieren mit: filesystem · git-mcp-idosal

Ein komplexes Feature einem nicht-technischen PM erklären

👤 Tech Leads ⏱ ~20 min beginner

Wann einsetzen: Die PM fragt immer wieder: Warum dauert das 3 Sprints? Ein konkretes Artefakt soll erstellt werden.

Ablauf

Auf Feature begrenzen

codebase-to-course: auf src/payments/ begrenzen. Zielgruppe: PM ohne Ingenieurshintergrund. Diagramme und Analogien bevorzugen, wenig Code.✓ Kopiert

→ Kurs ist hochrangig; Code-Blöcke minimal

Ergebnis: PM geht mit einem mentalen Modell davon.

Fallstricke

Analogien vereinfachen zu stark — Stichprobe; der Skill bevorzugt Genauigkeit, wenn gefordert

Eine "Wie es funktioniert"-Seite für ein Open-Source-Projekt generieren

👤 OSS-Maintainer ⏱ ~30 min intermediate

Wann einsetzen: Das README hat Features, aber keine Architekturerklärung.

Ablauf

Als Dokumentationsseite generieren

codebase-to-course: Main-Branch scannen. ARCHITECTURE.html für die Docs-Site ausgeben. Zielgruppe: erfahrene Entwickler, die das Projekt evaluieren.✓ Kopiert

→ Ausgabe liest sich wie ein durchdachter Contributor-Guide

Ergebnis: Bessere Developer-Experience für Evaluatoren und Beitragende.

Fallstricke

Kurs wirkt generisch (ohne Marke) — Projektname + Stil-Hinweise im Prompt übergeben

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

codebase-to-course-skill + filesystem

Lokales Repository lesen und Kurs schreiben

codebase-to-course: ./our-app scannen, /onboarding/course.html schreiben.✓ Kopiert

codebase-to-course-skill + git-mcp-idosal

Ein externes Repository bearbeiten ohne es zu klonen

GitMCP für owner/repo verwenden. Dann codebase-to-course darauf.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
scan_repo	path	Immer zuerst
propose_toc	scan_result, audience	Nach dem Scan, vor der Generierung
generate_course	scan_result, toc, target_html_path	Letzter Schritt
scope_to_subdir	subdir_path	Großes Monorepo oder Feature-Fokus

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: N/A
Tokens pro Aufruf: Erheblich — der Skill liest das gesamte Repository (typischerweise 10k–50k Token)
Kosten in €: Kostenlos; eigene Modell-Tokens gelten
Tipp: Für Monorepos scope_to_subdir verwenden; nicht alles auf einmal bearbeiten

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: filesystem-read filesystem-write

Credential-Speicherung: Keine

Datenabfluss: Keine — nur lokales Lesen/Schreiben

Generierter Kurs kann Code-Ausschnitte enthalten; vor externer Freigabe prüfen, wenn das Repository Secrets enthält

Fehlerbehebung

Häufige Fehler und Lösungen

Kurs ist zu generisch / referenziert keinen echten Code

Prompt spezifischer machen; file:line-Zitate anfordern

Repository zu groß; Kontext läuft über

scope_to_subdir verwenden; Pro-Modul-Kurse erstellen und verknüpfen

HTML-Formatierung kaputt

Den Skill die Ausgabe validieren lassen; bei Bedarf neu generieren

Alternativen

Codebase to Course vs. andere

Alternative	Wann stattdessen	Kompromiss
Repomix + manueller Prompt	Volle Kontrolle über die Übermittlung des Codebases an Claude gewünscht	Mehr Setup; kein meinungsstarkes Ausgabeformat
DocsGPT / Mintlify	Gehostete Docs gewünscht	Völlig anderes Produkt; keine Einzeldatei-HTML
absolutely-skilled / autodoc	Automatisch generierte API-Docs gewünscht	API-Referenz ≠ Tutorial

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen