Company Brief

Was macht Company Brief?

Verwandle einen Firmennamen oder eine URL in ein tiefgehendes, quellenbasiertes, gestaltetes PDF, das dem Leser alles mitgibt, was er für ein Bewerbungsgespräch, ein Angebotsgespräch, einen Kunden-Pitch oder das erste Projekt mit einer neuen Marke braucht: was das Unternehmen ist, wie es läuft, wer es führt, wie es ist, dort zu arbeiten, wie Marke und Marketing funktionieren, wer die Wettbewerber sind und wie man mit ihm spricht. Das PDF verwendet die eigenen Farben und Schriftarten des Unternehmens, sodass es sich anfühlt, als gehöre es ihm.

Verwendung

/company-brief <Unternehmensname oder URL> [for <Rolle>] [brand kit] [shareable]

Beispiele: /company-brief linear.app, /company-brief Figma for Senior Brand Designer, /company-brief patagonia.com brand kit, /company-brief Notion shareable. Auch einfache Anfragen funktionieren: „Mach mir einen Company Brief über Notion vor meinem Vorstellungsgespräch“ oder „Wir haben gerade Oatly als Kunden gewonnen – ich muss mich schnell ins Branding einarbeiten.“

• Unternehmen: Eine URL legt die Identität fest. Ein bloßer Name reicht möglicherweise nicht (Schritt 1).
• for : Fokussiert Einstellungen, wichtige Ansprechpartner und die Gesprächsvorbereitung auf diese Rolle und ihr Team. Ohne Angabe wird auf Design, Brand, Marketing und kreative Führungsebene standardisiert, oder auf das, was der Hintergrund der Person nahelegt.
• Persönlicher Modus (Standard): Geschrieben für die fragende Person. Nutze das, was du über sie weißt (Speicher, vergangene Chats, dieses Gespräch, ein angehängter Lebenslauf oder ein Portfolio) für „Dein Blickwinkel“, den Pitch und „Passung für dich“. Liegt ein Angebot vor, füge „Bevor du unterschreibst“ hinzu. Wenn du nichts über sie weißt, schreibe diese Teile generisch und biete im Antworttext an, sie anzupassen.
• Brand-Arbeit („brand kit“ oder die Person sagt, sie gestaltet für die Marke, pitched sie oder beginnt als Designer, Stratege, Agentur- oder Inhouse-Partner mit ihr): Die Abschnitte Brand identity und Brand Kit erhalten die meiste Sorgfalt, und das Kit enthält die vollständige Assetliste und den Hinweis „Beim Kunden anfragen“ (references/brand-extraction.md, Abschnitt 4). In Teil fünf wird „Gesprächsvorbereitung“ zu „Kickoff-Vorbereitung“ (was das Brand-Team erwarten wird, was mitbringen, wahrscheinliche Fragen), „Fragen, die du stellen solltest“ richten sich an das Brand-Team, und „Passung für dich“ und „Bevor du unterschreibst“ entfallen. Halte „Einstellungen“ auf einen kurzen Absatz.
• Shareable („shareable“, „für einen Freund“, „zum Weitergeben an jemanden“): Nichts über die Person. Kein „Erstellt für“-Label, kein Passung-Score, kein „Bevor du unterschreibst“. Teil fünf wird zu „Wie man mit ihnen spricht“ und „Dein Blickwinkel“ wird zu „Blickwinkel, die verfangen“.

Halte nicht inne, um Fragen zu stellen, es sei denn, die Identität des Unternehmens ist wirklich mehrdeutig. Beginne mit der ersten Antwort: ein Satz darüber, was du tust, die Aufgabenliste, dann die Recherche.

Skill-Dateien

Die folgenden Pfade verwenden ${CLAUDE_SKILL_DIR}. Falls dieser Text nicht durch einen echten Pfad ersetzt wird, finde den Ordner einmalig mit find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1 und verwende seinen absoluten Pfad in jedem Befehl (Shell-Variablen bleiben möglicherweise nicht zwischen Befehlen erhalten).

Datei	Wofür sie da ist
assets/brief.css	Basis-Stylesheet. Kopieren, nicht bearbeiten.
assets/brief-template.html	Gerüst des gesamten Briefs mit {{placeholders}}
scripts/fonts.py	Installiert kostenlose Schriftarten von Fontsource und gibt <link>-Tags aus
scripts/tokens.py	Wandelt Markenfarben in den Token-<style>-Block um, mit Kontrastkorrekturen
scripts/render.cjs	Rendert das PDF mit Node Playwright und prüft Schriftarten, Kontrast, Platzhalter
scripts/render.py	Gleiches in Python, mit Fallback auf Chrome CLI, dann WeasyPrint
scripts/audit.js	Die Prüfung, die beide Renderer innerhalb der Seite ausführen
scripts/contact_sheet.py	Ein Bild jeder Seite für die Layoutprüfung
references/research-playbook.md	Wo du für jeden Abschnitt suchen solltest und die effiziente Reihenfolge
references/brand-extraction.md	Echte Farben, Schriftarten und Logobeschreibung von der Live-Website extrahieren
references/components.md	Markup für jede Komponente, Abschnittsreihenfolge, Schreibregeln

Harte Regeln

• Zuerst disambiguieren. Viele Unternehmen teilen sich Namen, und Finanzdatenbanken sowie Jobbörsen vermischen sie oft. Bestätige, dass jede Finanz- und Einstellungsinformation zum richtigen Unternehmen gehört (gleiche Domain, Gründer, Hauptsitz). Falls es eine Kollision gibt, eröffne die Zusammenfassung mit einem Namenscheck-Hinweis.
• Jede Zahl erhält eine Quelle, ein Datum und ein Konfidenztag: Verified (Primärquelle: Einreichungen, die eigene Website oder Karriereseite), Reported (glaubwürdige Presse), Company claim (Eigenmarketing), Estimate (Drittanbieter oder deine Schlussfolgerung; gib an, woraus), Unknown (gesucht, nicht gefunden; gib an, wo).
• Schreibe Erkenntnisse während der Arbeit in research-notes.md. Suchergebnisse gehen in langen Recherchen aus dem Kontext verloren. Alles, was nicht notiert ist, ist verloren.
• Aktualität: Verwende das heutige Datum; setze die Jahreszahl in die Nachrichtensuche; markiere alles, das älter als 18 Monate ist, als veraltet.
• Personen: Öffentlichkeitswirksame Führungskräfte und für die Rolle relevante Personen, nur mit öffentlichen, beruflichen Informationen. Keine privaten Kontaktdaten, Wohnorte, Familienmitglieder oder Fotos von Personen.
• Marken-Assets sind Links, niemals Kopien. Beschreibe das Logo in Worten und verlinke auf die eigenen Logodateien und Richtlinien der Marke. Zeichne, verfolge, bette oder lade keine Logos, Maskottchen, Schriftarten oder Werbebilder in den Brief oder den Arbeitsordner herunter. Bevorzuge das Pressekit, das Markenportal oder die Richtlinien der Marke gegenüber Drittanbieter-Logoseiten, kennzeichne, was was ist, bestätige das Format jeder Datei durch Öffnen und verlinke die Nutzungsbedingungen, die für die Dateien gelten. Farbfelder, Schriftproben und abstrakte markenfarbige Muster sind in Ordnung.
• Zitate: Mitarbeiterbewertungsauszüge mit max. 25 Wörtern, insgesamt maximal 4, mit Angabe von Plattform und Datum. Fasse Artikel zusammen; kopiere sie nicht.
• Kennzeichne es als unabhängig: Das Cover trägt den Hinweis „Unabhängiges Research-Briefing. Nicht verbunden mit oder unterstützt von .“
• Sage, was fehlt in einer Zeile, anstatt einen Abschnitt stillschweigend wegzulassen.
• Behaupte nie eine Prüfung, die du nicht durchgeführt hast („Für dieses Briefing wurde nur Glassdoor ausgewertet“).
• Shareable Briefings enthalten nichts Privates über die fragende Person, selbst wenn du es weißt.

Arbeitsablauf

Erstelle diese Aufgabenliste und hake die Punkte ab, sobald du sie erledigt hast:

1. Identifiziere das Unternehmen und prüfe auf Namenskollisionen
2. Richte den Arbeitsordner und die Notizendatei ein
3. Lies die eigene Website und die Karriereseiten des Unternehmens
4. Recherchiere alles Weitere in parallelen Batches
5. Extrahiere Markenfarben und Schriftarten; erstelle Token und Schriftarten
6. Baue das Brand Kit: Logodateien, Richtlinien, Schriftarten, Farbspezifikationen
7. Synthetisiere: Fazit, Scorecard, Gesprächsstrategie
8. Schreibe brief.html
9. Rendere und prüfe
10. Überprüfe Fakten, Links und Layout
11. Liefere aus

1. Identifizieren

• URL gegeben: Öffne die Startseite und die Über-uns-Seite. Name gegeben: Suche "<name>" Unternehmen und "<name>" offizielle Website.
• Ermittle Marken- und Rechtsname, Domain, Hauptsitz, Gründungsjahr, Gründer, börsennotiert oder privat (Ticker), Muttergesellschaft.
• Suche "<name>" -<domain> nach gleichnamigen Unternehmen.
• Falls zwei oder mehr reale Unternehmen plausibel passen und in der Anfrage nichts sie unterscheidet, stelle eine Frage mit den Kandidaten. Ansonsten wähle die beste Übereinstimmung und nenne sie am Anfang deiner Antwort.
• Im persönlichen Modus durchsuche auch vergangene Chats und den Speicher (falls verfügbar) nach dem Firmennamen: Eine Bewerbung, ein Recruiter-Thread oder ein Angebot ändert, was wichtig ist.

2. Arbeitsordner

mkdir -p briefs/<unternehmens-slug> && cd briefs/<unternehmens-slug>
cp "${CLAUDE_SKILL_DIR}/assets/brief.css" . && cp "${CLAUDE_SKILL_DIR}/assets/brief-template.html" brief.html

Verwende das aktuelle Arbeitsverzeichnis oder einen temporären Ordner, falls es nicht beschreibbar ist. Erstelle research-notes.md mit einer Überschrift pro Brief-Abschnitt und füge Erkenntnisse als - <Fakt> | <Tag> | <Quellentitel> | <URL> | <Datum> an.

3. Die eigene Website des Unternehmens zuerst

Die Live-Website und die Karriereseiten beantworten ein Drittel des Briefs und sind die zuverlässigste Quelle für Mission, Werte, Produkte, Kunden, Standorte, offene Stellen, Gehälter, Einstellungsprozess, Social-Media-Profile und Marken-Token.

• Falls du ein Browser-Tool hast (Claude in Chrome, ein In-App-Browser oder ein Cloud-Browser), verwende es für die Domain des Unternehmens; stimme der gesamten Seite einmal zu, wenn du gefragt wirst. Lies Seiten als Text, nicht als Screenshots, außer für das Logo und den Hero-Bereich.
• Besuche in dieser Reihenfolge: Startseite (Positionierung, Kundenlogos, Footer-Links) → Über uns → Karriere (zähle Stellen nach Abteilung und Standort) → 2–4 Stellenanzeigen, die der Zielrolle am nächsten kommen (Gehalt, Bewerbungsschritte, Berichtslinie, Tools) → Presse/Newsroom (Zeitleiste, Pressekit, Logodateien, Markenrichtlinien) → Blog/Changelog (letzte 3 Monate) → Events → Kunden.
• Führe das Brand-Extraktionsskript auf der Startseite aus, während du dort bist (references/brand-extraction.md, Abschnitt 1).
• Kein Browser: Rufe dieselben Seiten mit dem Fetch-Tool ab.
• Die Karriereseite schlägt Jobbörsen-APIs, die oft veraltet sind. Verwende die ATS-API-Liste aus dem Playbook nur als Fallback.

Details: references/research-playbook.md, Abschnitte 1–2.

4. Alles Weitere

Befolge references/research-playbook.md, Abschnitte 3–6. Sende unabhängige Suchanfragen zusammen in einem Durchgang (Finanzierung, Umsatz, Nachrichten, Bewertungen, Wettbewerber, Kampagnen, Events, Podcasts). Verwende zuerst die Standardsuche und die erweiterte Suche für aktuelle Nachrichten, Einstellungs- und Bewertungsdaten oder alles, was dünn ist. Falls ein Fetch-Tool eine von dir eingegebene URL ablehnt, suche danach und rufe das Ergebniss ab, oder öffne es im Browser. Connectors für Jobseiten (Indeed, ZipRecruiter, LinkedIn), falls vorhanden, sind gut für Bewertungen und Stellen.

40–80 Abfragen sind für ein mittelgroßes Unternehmen normal. Wenn ein Abschnitt nach zwei guten Suchdurchgängen dünn bleibt, markiere ihn als Unknown und mache weiter.

5. Marken-Token und Schriftarten

Aus der Extraktion (references/brand-extraction.md):

python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<Anzeigeschrift>:400,500,600" "<Textschrift>:400,600" "<Etikettenschrift>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
  --font-display "<Anzeigeschrift>" --font-body "<Textschrift>" --font-label "<Etikettenschrift>" \
  --display-weight 600 --tracking -0.02em --radius 8px \
  --footer "<Unternehmen> · Company Brief · <Mon JJJJ>" [--cover-stops "#…,#…,#…"] > tokens.html

• Füge die <link>-Zeilen von fonts.py an der Markierung FONT LINKS und tokens.html an der Markierung TOKENS in brief.html ein.
• Jede Zeile des tokens.py-Berichts sollte ok anzeigen. Ein WARNING bedeutet, wähle andere Farben (für eine helle Signaturfarbe, mache die dunkle zu --brand).
• Proprietäre Markenschriftart: Führe den Ersatztest in brand-extraction.md, Abschnitt 2 durch und sage im Brief, welche freie Schriftart als Ersatz dient.
• Falls npm keine Schriftarten installieren kann, verwende eine installierte Familie (fc-list : family) und erwähne dies im Abschnitt „Schriftarten“.

6. Brand Kit

Befolge references/brand-extraction.md, Abschnitt 4. Finde in jedem Modus das primäre Logo als Vektordatei (SVG, EPS, AI oder Vektor-PDF) und die aktuellsten öffentlichen Markenrichtlinien; im Brand-Work-Modus auch Schriftarten, Farbspezifikationen, Bildmaterial, Vorlagen, Standardtexte und Nutzungsbedingungen. Sende die Suchanfragen zusammen. Notiere für jedes Element den Link, das Format, das du durch Öffnen bestätigt hast, die Quelle (offiziell oder Drittanbieter), sein Datum und einen Status: Current, Dated, Outdated, Request access oder Not found. Überprüfe, ob die Logodatei mit dem Logo auf der Live-Website von heute übereinstimmt.

7. Synthetisieren

Lies die gesamte Notizendatei, entscheide dann über das Fazit, die drei wichtigsten Dinge, die Scorecard, ihre Sprache, Prioritäten → Gesprächsthemen, den 30-Sekunden-Pitch, den Blickwinkel, die Gesprächsvorbereitung, Fragen, die du stellen solltest, Dos und Don‘ts, bevor du unterschreibst (nur bei Angebot) und die Kontaktaufnahme. Anleitung hierzu: references/research-playbook.md, Abschnitt 7.

8. brief.html schreiben

Ersetze jeden {{placeholder}} in der Vorlage, füge Zeilen und Elemente nach Bedarf hinzu und lösche nur die Abschnitte, die die Vorlage als bedingt markiert. Markup- und Schreibregeln: references/components.md. Halte das CSS pro Brief klein und im Überschreibungsblock der Vorlage. Ziel: 14–20 Seiten.

9. Rendern und prüfen

node "${CLAUDE_SKILL_DIR}/scripts/render.cjs" brief.html "<Unternehmen>-Company-Brief-<JJJJ-MM>.pdf" \
  || python3 "${CLAUDE_SKILL_DIR}/scripts/render.py" brief.html "<Unternehmen>-Company-Brief-<JJJJ-MM>.pdf"

• Der Node-Renderer beendet sich mit Code 2, wenn Playwright fehlt, was den Python-Renderer auslöst. render.py versucht Playwright, dann ein Chrome-Binary, dann WeasyPrint (pip install weasyprint).
• Korrigiere jede FAIL-Zeile (Schriftart nicht geladen, Text unter 4.5:1 Kontrast, übrig gebliebener Platzhalter) und rendere erneut.
• Falls du auf dem eigenen Computer von jemandem arbeitest und nichts rendert, frage vor der Installation eines Renderers (pip install playwright && python -m playwright install chromium).

10. Überprüfen

• Layout: python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png, dann sieh dir das Bild an. Das Cover ist randlos ohne Footer; die Zusammenfassung passt auf Seite 2; jeder Teil beginnt auf einer neuen Seite; nichts wird abgeschnitten; keine Tabelle läuft über; keine fast leeren Seiten; keine Überschrift ist am Seitenende gestrandet. Rendere eine fragwürdige Seite größer mit pdftoppm -r 150 -f N -l N -png <pdf> seite und sieh noch einmal hin.
• Fakten: Jede Zahl im PDF stimmt mit der Notizendatei überein, trägt ein Tag und erscheint in den Quellen. Daten sind absolut. Das andere gleichnamige Unternehmen ist nicht eingemischt.
• Text: Lies die Schreibregeln aus references/components.md noch einmal gegen den Text.
• Links: Öffne 5 oder mehr Quellenlinks, um zu bestätigen, dass sie auflösen, und öffne jeden Brand-Kit-Link, um zu bestätigen, dass er zum angegebenen Format führt.

11. Ausliefern

• Sende das PDF als Datei. Im Brand-Work-Modus sende auch <Unternehmen>-Brand-Kit.md: die Kit-Tabelle als einfache Links, bereit zum Einfügen in ein Projektdokument oder einen Channel. Falls die Person Briefings in einem Ordner auf ihrem Computer ablegt und du darauf zugreifen kannst, speichere es auch dort.
• Antworte in wenigen Zeilen: das Fazit in zwei Sätzen, die 2–3 schärfsten Gesprächsthemen, alles Wichtige, das du nicht finden konntest, und ein sinnvoller nächster Schritt (ein maßgeschneidertes Anschreiben, eine Kontaktaufnahme-Notiz, Übungsfragen für ein Vorstellungsgespräch, eine Kickoff-Agenda oder eine teilbare Version). Im Brand-Work-Modus teile mit, welche Logo- und Richtliniendateien du gefunden hast und was das Team anfragen muss.