Claude Chat ‐ Setup Onboarding Help - roger-infanger-weibel/cas-hzw-ai-innovation GitHub Wiki

Ich schaue kurz in die aktuelle Dokumentation, damit ich dir keine veralteten Feature-Namen nenne.Gute Frage – die Steuerung ist auf mehrere Ebenen verteilt, und die meisten Leute nutzen nur eine davon. Hier die Landkarte, danach ein konkreter Einrichtungsvorschlag.

Die Ebenen (Chat, also claude.ai / App)

Ebene Wo Wofür
Profil-Präferenzen Einstellungen → Profil Deine Dauer-Standing-Order: wer du bist, wie du Antworten willst. Lädt in jedes Gespräch.
Memory Einstellungen → Capabilities Was ich mir automatisch aus Gesprächen merke; du kannst Einträge ansehen, ergänzen, löschen
Projekte Sidebar → Projekte Instruktionen + Dateien pro Vorhaben (z.B. PLS-Forecasting). Überschreibt/ergänzt das Profil im jeweiligen Kontext.
Styles "Search and tools" → Use style Nur die Ausgabeform (Tonalität, Länge), umschaltbar pro Chat
Skills Einstellungen → Capabilities → Skills Wiederverwendbare Arbeitsanweisungen für wiederkehrende Aufgaben
Connectors / MCP Einstellungen → Connectors Zugriff auf externe Systeme (bei dir aktuell Google Calendar)

Zu Skills: Sie sind auf allen Plänen verfügbar, brauchen aber "Code execution and file creation" aktiviert, dann schaltest du unter Customize → Skills die Beispiel-Skills ein oder lädst eigene hoch. Der description-Block im SKILL.md ist dabei das Entscheidende – daran erkenne ich, wann ein Skill geladen wird. Und: Skills funktionieren über claude.ai, Claude Code und die API hinweg – das ist dein zentraler Ablageort, wenn du dieselbe Regel überall willst.

Die Ebenen (Claude Code / Terminal, IDE)

Hier ist alles Dateien im Repo bzw. in ~/.claude:

  • CLAUDE.md – Projektkontext und Konventionen, wird bei jeder Session geladen. Ziel: unter 200 Zeilen; längere Dateien laden zwar vollständig, aber die Befolgung sinkt.
  • ~/.claude/CLAUDE.md – deine persönlichen Präferenzen über alle Projekte
  • .claude/rules/*.md – themenspezifische Regeln, optional per paths:-Glob nur geladen, wenn passende Dateien im Kontext sind. Wenn CLAUDE.md gegen 200 Zeilen geht, splittest du in Rules.
  • .claude/settings.json – Permissions und Hooks. Wichtiger Unterschied: CLAUDE.md ist Guidance, die ich lese; Permissions und Hooks werden erzwungen, unabhängig davon, ob ich mich daran halte.
  • .claude/skills/, agents/ – eigene /befehle und spezialisierte Subagenten

Vorschlag fürs Vorgehen

Ich würde nicht alles auf einmal aufsetzen, sondern in drei Schritten:

  1. Profil-Präferenzen schreiben (30 Min., grösster Hebel). Deutsch, direkte Prosa, keine Verwaltungssprache, Zurich-Kontext, technisches Niveau – das gilt dann überall.
  2. Ein Projekt "PLS-Prognose" anlegen mit Instruktionen: Datenquelle, 15-Minuten-Polling-Eigenheit, Europe/Zurich inkl. DST-Regeln, Stack, Definition of Done.
  3. CLAUDE.md + eine rules/timeseries.md im Repo, sobald du in Claude Code arbeitest.

Was mir dabei hilft: Der Skill-Creator kann Skills für dich bauen, statt dass du YAML von Hand schreibst – du beschreibst die Aufgabe, ich strukturiere sie.

Womit willst du anfangen – soll ich dir zuerst einen Entwurf für die Profil-Präferenzen schreiben, oder direkt die CLAUDE.md fürs PLS-Projekt?

Was direkt aus GitHub läuft

Claude Code: Ein Repo mit einer .claude-plugin/marketplace.json im Root ist ein Plugin-Marketplace. Registrieren mit:

/plugin marketplace add roger/meine-regeln
/plugin install pls-forecasting@meine-regeln

Als Quelle gehen GitHub-Repos im owner/repo-Format, beliebige Git-URLs (auch GitLab, Bitbucket, self-hosted), lokale Pfade und direkte URLs auf eine gehostete marketplace.json. Ein Plugin bündelt Skills, MCP-Connectors, Subagenten, Slash-Commands und Hooks in einem Paket.

Dazu kommt: CLAUDE.md, .claude/rules/*.md und .claude/settings.json liegen ohnehin im Repo und sind damit automatisch versioniert.

Cowork (Desktop-App): Unter Customize → Plugins kannst du per Add marketplace eine Repo-URL eintragen und mit Update die neuste Version ziehen.

Was nicht aus GitHub läuft

  • Chat auf claude.ai nutzt keine Plugins – Plugins sind für Cowork und Code.
  • Profil-Präferenzen und Projekt-Instruktionen haben keine Git-Anbindung. Die pflegst du im UI.
  • Skills im Chat kannst du zwar als .zip hochladen, aber ohne Auto-Sync. GitHub-Sync gibt es auf Organisations-Ebene (Admin-Settings), nicht für Einzelaccounts.

Praktikables Setup für dich

Ein privates Repo, z.B. roger-claude-config, als Single Source of Truth:

.claude-plugin/marketplace.json
plugins/
  pls-forecasting/
    .claude-plugin/plugin.json
    skills/
      timeseries-hygiene/SKILL.md    # Zeitzonen, Lücken, Row-Loss-Checks
      pls-datamodel/SKILL.md
docs/
  profil-praeferenzen.md             # Klartext, den du ins UI kopierst

Code und Cowork ziehen direkt aus dem Repo. Für den Chat kopierst du die Präferenzen einmalig ins UI und lädst bei Bedarf ein Skill-Zip hoch – die Textquelle bleibt aber im Repo, damit du nur eine Stelle pflegst.

Ein Hinweis noch: bei mehreren Marketplace-Einträgen, die sich einen skills/-Ordner teilen, musst du in der marketplace.json die Unterverzeichnisse explizit auflisten, sonst lädt jeder Eintrag alle Skills.

Soll ich dir das Repo-Gerüst aufsetzen – marketplace.json, plugin.json und ein erster Skill für die Zeitreihen-Hygiene deines PLS-Projekts?

⚠️ **GitHub.com Fallback** ⚠️