a2ngerer/claude_onboarding_agent

Einrichtung der Inhaltsstimme

Dieser Skill konfiguriert Claude so, dass er in Ihrer Markenstimme auf den von Ihnen ausgewählten Plattformen schreibt. Er erzeugt eine kleine CLAUDE.md-Zeigerdatei sowie eine .claude/rules/content-voice-<platform>.md-Datei pro ausgewählter Plattform. Er konfiguriert KEINE Veröffentlichungswerkzeuge, Analysen, Medien-Pipelines oder Terminplanung – das liegt außerhalb des Umfangs und ist bewusst so.

Kontextübergabe: Lesen Sie skills/_shared/consume-handoff.md und führen Sie es mit dem Handoff-Block aus (falls vorhanden). Der Helfer garantiert die folgenden lokalen Variablen: detected_language, existing_claude_md, inferred_use_case, repo_signals, graphify_candidate. Verwenden Sie detected_language für alle benutzerseitigen Texte; generierte Dateiinhalte bleiben auf Englisch.

Bestehende CLAUDE.md: Wenn existing_claude_md: true ist, überschreiben Sie diese NICHT. Fügen Sie am Ende der Datei einen neuen, abgetrennten Abschnitt ein:

<!-- onboarding-agent:start setup=content-voice skill=content-voice-setup section=claude-md -->
## Claude Onboarding Agent — Content Voice Setup
...generierter Inhalt...
<!-- onboarding-agent:end -->

Wenn der abgetrennte Block bereits aus einem vorherigen Durchlauf existiert, ersetzen Sie nur den Inhalt zwischen den Markierungen; lassen Sie den Rest unberührt. Umschließen Sie generierte .gitignore-Einträge mit # onboarding-agent: content-voice — start / — end Markierungen, damit /upgrade-setup sie zerstörungsfrei aktualisieren kann.

Unterstützende Dateien

Lesen Sie diese bei Bedarf, wenn der Schritt sie aufruft. Lesen Sie nicht vorher.

• skills/_shared/consume-handoff.md — Orchestrator-Handoff-Parsing + integrierter Fallback (Präambel, vor Schritt 1)
• skills/_shared/offer-superpowers.md — kanonische Superpowers-Opt-in (Schritt 1)

Schritt 1: Abhängigkeiten installieren

Lesen Sie skills/_shared/offer-superpowers.md und führen Sie es mit skill_slug: content-voice-setup, mandatory: false, capability_line: "Eine weit verbreitete, kostenlose Claude Code Skills-Bibliothek. Der Brainstorming-Skill ist nützlich, um Blickwinkel auszuloten, bevor Sie sich für eine Stimme für ein bestimmtes Stück entscheiden." aus. Der Helfer fragt den Benutzer, delegiert bei yes an skills/_shared/installation-protocol.md und setzt superpowers_installed, superpowers_scope, superpowers_method.

Schritt 2: Kontextfragen

Stellen Sie eine Frage nach der anderen:

1. "Für welche Plattformen erstellen Sie stimmgetriebene Inhalte? (Mehrfachauswahl — Komma-getrennte Buchstaben, mindestens eine) A) YouTube (Langform-Video / Skripte) B) Kurzform-Video (Instagram Reels / TikTok / Shorts) C) Newsletter / Blog (schriftliche Langform) D) Podcast (gesprochenes Audio)"

   Parsen Sie die Antwort in eine Liste von Buchstaben. Erfordern Sie mindestens eine Auswahl — fragen Sie bei leerer Eingabe einmal erneut nach. Speichern Sie als selected_platforms. Mapping zu Slugs:

   • A → youtube
   • B → shortform
   • C → newsletter
   • D → podcast

2. "Wie würden Sie Ihre Markenstimme beschreiben? Seien Sie so spezifisch wie möglich – je mehr Details, desto besser kann Claude Ihren Stil treffen. Beispiele: 'lehrreich, aber locker, wie einem klugen Freund etwas erklären', 'professioneller Vordenker im Fintech-Bereich', 'lustiger und respektloser Tech-Kommentar', 'warme und persönliche Wellness-Inhalte'"

   Speichern Sie die Antwort wörtlich als brand_voice. Die plattformspezifischen Regeln-Dateien setzen sie in ihren Header ein.

3. "Wer ist Ihre Zielgruppe? (z. B. 'Entwickler im Alter von 25–40, die sich für KI-Tools interessieren', 'Kleinunternehmer ohne technischen Hintergrund', 'Fitness-Enthusiasten, die nach schnellen Workouts suchen')"

   Speichern Sie als target_audience.

Schritt 3: Plattformspezifische Voice-Regeln ausgeben

Für jeden Slug in selected_platforms schreiben Sie eine Regeldatei unter .claude/rules/content-voice-<slug>.md. Wenn die Datei bereits existiert, überspringen Sie das Schreiben und protokollieren Sie Skipped .claude/rules/content-voice-<slug>.md (already exists) — überschreiben Sie NICHT Benutzerbearbeitungen.

Jede Regeldatei ist in sich geschlossen (≤ 40 Zeilen) und setzt brand_voice und target_audience in den Header ein. Verwenden Sie die folgenden Vorlagen und ersetzen Sie [brand_voice] und [target_audience] durch die erfassten Antworten.

content-voice-youtube.md

# Content Voice — YouTube (Langform-Video)

Voice-Profil: [brand_voice]
Zielgruppe: [target_audience]

## Formatregeln
- Jedes Skript beginnt mit einem Hook in den ersten 30 Sekunden: Versprechen Sie einen konkreten Nutzen, den der Zuschauer am Ende erhält.
- Struktur: Hook → Aufbau (welches Problem / welche Frage) → Nutzen (die Antwort, Geschichte oder Demo) → CTA.
- Der CTA nennt eine einzige Aktion. Verketten Sie keine Listen wie „liken, abonnieren, kommentieren, mitmachen".
- Halten Sie Sätze vorlesbar — standardmäßig ≤ 20 Wörter pro gesprochener Zeile.

## Tonfallregeln
- Passen Sie das Voice-Profil oben in jedem Entwurf an. Wenn ein Entwurf wie generischer KI-Kommentar klingen würde, schreiben Sie die Eröffnungszeile um, bis sie sich wie [brand_voice] anhört.
- Sprechen Sie die Zielgruppe direkt an. Gehen Sie von ihrem Grundwissen aus; erklären Sie nicht, was sie bereits weiß.

## Nicht tun
- Schreiben Sie keinen Titel-Köder, den die Einleitung nicht einlöst — der Hook muss ein wahrheitsgemäßer Aufbau für den Nutzen sein.

content-voice-shortform.md

# Content Voice — Kurzform-Video (Reels / TikTok / Shorts)

Voice-Profil: [brand_voice]
Zielgruppe: [target_audience]

## Formatregeln
- Zeile 1 IST der Hook. Der Scroll-Stopp erfolgt in den ersten zwei Sekunden.
- Eine einzige Idee pro Beitrag. Wenn eine zweite Idee wichtig ist, ist es ein separater Beitrag.
- Enden Sie mit einer Frage, einem CTA oder einem konkreten Ergebnis — nie auslaufen lassen.
- Halten Sie die Gesamtwortzahl knapp (≈ 30–60 gesprochene Wörter für einen 30-Sekunden-Schnitt).

## Tonfallregeln
- Das Voice-Profil entspricht genau [brand_voice] — Kurzform verstärkt die Stimme, daher ist generischer Ton der Standardfehlermodus.
- Zielen Sie auf [target_audience]; machen Sie es nicht für ein breiteres Publikum weicher.

## Nicht tun
- Vergraben Sie den Hook nicht hinter Zeile 1. Beginnen Sie nicht mit einem räuspernden „Also, heute möchte ich über … sprechen".

content-voice-newsletter.md

# Content Voice — Newsletter / Blog (schriftliche Langform)

Voice-Profil: [brand_voice]
Zielgruppe: [target_audience]

## Formatregeln
- Die Betreffzeile ist spezifisch, nicht klug — nennen Sie das Ergebnis oder die Frage, die der Leser beantwortet bekommt.
- Der Einstieg ist persönlich oder geschichtenbasiert (1–3 Sätze); dann eine Kernidee; dann ein klares Ergebnis; dann ein einfacher CTA.
- Abschnittswechsel sind erlaubt, aber nicht erforderlich — tendieren Sie zu einem prägnanten Argument statt einem Listenartikel.
- Schließen Sie mit einem Satz, den der Leser an einen Kollegen weiterleiten könnte.

## Tonfallregeln
- Das Voice-Profil entspricht durchgehend [brand_voice] — kein Abschnitt sollte klingen, als hätte ihn ein anderer Autor geschrieben.
- Sprechen Sie [target_audience] mit ihrer tatsächlichen Situation an, nicht mit Rollenbezeichnungen.

## Nicht tun
- Versenden Sie keine Ausgabe ohne ein spezifisches Ergebnis, auf das der Leser reagieren oder das er sich merken kann.

content-voice-podcast.md

# Content Voice — Podcast (gesprochenes Audio)

Voice-Profil: [brand_voice]
Zielgruppe: [target_audience]

## Formatregeln
- Kalter Einstieg mit einem Hook — einer Szene, einer Frage oder einem konkreten Moment aus der Folge. Die Intromusik kommt danach.
- Übergänge werden gesprochen, nicht geschnitten: Benennen Sie den Wechsel („Kommen wir gleich darauf zurück — zuerst …").
- Bereiten Sie Fragen im Voraus vor, lassen Sie aber Raum für Nachfragen; ein vorformuliertes Skript liest sich wie ein vorformuliertes Skript.
- Beenden Sie mit dem CTA des Gasts (falls vorhanden), dann einem einzelnen Host-CTA.

## Tonfallregeln
- Das Voice-Profil [brand_voice] gilt für Host-Zeilen; passen Sie die Energie der Gäste an, anstatt sie hineinzuzwingen.
- Halten Sie Fachjargon auf dem Niveau von [target_audience]; übersetzen Sie bei der ersten Verwendung.

## Nicht tun
- Dozieren Sie nicht — bleiben Sie gesprächig. Wenn ein Abschnitt wie ein Monolog liest, kürzen Sie ihn oder formulieren Sie ihn als Frage um.

Sammeln Sie die Liste der tatsächlich geschriebenen Dateien (abzüglich derer, die aufgrund vorhandener Dateien übersprungen wurden) als emitted_voice_files für die Abschlusszusammenfassung.

Schritt 4: Artefakte generieren

CLAUDE.md

# Claude Instructions — Content Voice

## Marke
Plattformen: [Komma-getrennt aus selected_platforms]
Markenstimme: [brand_voice]
Zielgruppe: [target_audience]

## Umfang
Diese Einrichtung deckt nur die Stimme ab — nicht Veröffentlichung, Analysen oder Medien-Pipelines. Für längere Content-Workflows fügen Sie zusätzliche Skills oder Tools hinzu.

## Voice-Regeln (pro Plattform)
[Für jeden Slug in selected_platforms einen Aufzählungspunkt ausgeben, der auf die Regeldatei verweist:]
- YouTube: `.claude/rules/content-voice-youtube.md`
- Kurzform-Video: `.claude/rules/content-voice-shortform.md`
- Newsletter / Blog: `.claude/rules/content-voice-newsletter.md`
- Podcast: `.claude/rules/content-voice-podcast.md`

## Richtlinien
- Schreiben Sie immer in der oben definierten Markenstimme — klingen Sie nie generisch oder wie eine typische KI.
- Konsultieren Sie vor dem Entwurf die relevante `.claude/rules/content-voice-<platform>.md`-Datei für die Zielplattform.
- Wenn Sie nach plattformübergreifenden Anpassungen gefragt werden, wenden Sie die Regeldatei jeder Plattform einzeln an — kopieren Sie nicht zwischen Formaten.

[Nur einschließen, wenn superpowers_installed true ist]
## Superpowers
Superpowers ist installiert. Verwenden Sie für Ideenfindungssitzungen und Planung von Inhaltsreihen `superpowers:brainstorming`, um Blickwinkel auszuloten, bevor Sie sich auf eine Richtung festlegen.

.gitignore

# Große Mediendateien
*.mp4
*.mov
*.avi
*.psd
*.ai
*.sketch
*.fig

# Betriebssystem
.DS_Store
Thumbs.db

# Claude lokale Einstellungen
.claude/settings.local.json

Schritt 5: Upgrade-Metadaten schreiben

Setzen Sie setup_slug: content-voice, skill_slug: content-voice-setup. Ermitteln Sie plugin_version aus der plugin.json des Plugins. Folgen Sie dann skills/_shared/write-meta.md, um ./.claude/onboarding-meta.json zu erstellen oder zusammenzuführen.

Schritt 6: Anker-Abschnitte rendern

Lesen Sie skills/_shared/anchor-mapping.md. Finden Sie die Zeile für setup_type: content-voice. Rufen Sie für jeden Anker-Slug in dieser Zeile:

1. skills/_shared/render-anchor-section.md auf mit:
   • setup_type: content-voice
   • skill_slug: content-voice-setup
   • anchor_slug: <slug>
   • target_file: ./CLAUDE.md
   • fallback_content: <eingebetteter Fallback aus skills/anchors/SKILL.md für diesen Slug>
2. Wenn eine ./AGENTS.md-Datei früher in diesem Skill generiert wurde, wiederholen Sie den Aufruf mit target_file: ./AGENTS.md.

Brechen Sie nicht ab, wenn ein einzelner render-anchor-section.md-Aufruf placeholder zurückgibt. Sammeln Sie gerenderte / Platzhalter-Slugs für die Abschlusszusammenfassung.

Erfassen Sie für jeden Aufruf auch render_freshness. Wenn dieser etwas anderes als network oder cache ist (d. h. fallback oder embedded), notieren Sie das Paar (anchor_slug, render_freshness) in anchor_freshness_notes. Die Zeile Anchor freshness in der Abschlusszusammenfassung verwendet diese Liste.

Schritt 7: Abschlusszusammenfassung

✓ Einrichtung der Inhaltsstimme abgeschlossen!

Umfang: Markenstimme + plattformspezifische Tonfallregeln. Veröffentlichung, Analysen und
Medien-Pipelines sind NICHT abgedeckt — dieser Skill ist bewusst eng gefasst.

Erstellte Dateien:
  CLAUDE.md                                    — Marke, Umfang, Verweise auf Voice-Regeln
  .claude/rules/content-voice-<slug>.md        — eine Datei pro ausgewählter Plattform [emitted_voice_files auflisten; übersprungene als "(bereits vorhanden — unberührt gelassen)" vermerken]
  .gitignore                                   — Regeln für große Mediendateien
  .claude/onboarding-meta.json                 — Setup-Markierung für /upgrade-setup

Externe Skills:
  [✓ Superpowers installiert über superpowers_method (superpowers_scope)]
  [übersprungen — später installieren mit: /plugin install superpowers@claude-plugins-official]
  [⚠ Superpowers-Installation fehlgeschlagen — manuell installieren: https://github.com/obra/superpowers]

Anchor-Aktualität:
  [gesamten Block weglassen, wenn anchor_freshness_notes leer ist; andernfalls eine Zeile pro Eintrag:
   Anchor <anchor_slug> bereitgestellt von <render_freshness> — führen Sie /anchors zum Aktualisieren aus.]

Nächste Schritte:
  Starten Sie eine neue Claude-Sitzung und sagen Sie: "Erstelle ein [YouTube-Skript | Kurzform-Hook | Newsletter-Ausgabe | Podcast-Cold-Open] zu [Thema] in meiner Markenstimme"
  Oder: "Passe diesen Blogbeitrag für Instagram Reels an, befolge meine Kurzform-Voice-Regeln"
  - Führen Sie jederzeit `/anchors` aus, um die von Ankern abgeleiteten Abschnitte zu aktualisieren. Wenn ein Abschnitt aufgrund des Offline-Modus als Platzhalter gerendert wurde, führen Sie `/anchors` erneut aus, sobald Sie wieder online sind.