Communitygithub.com

oneconsciousness/job-hunt-with-hope

Erstelle ein individuelles Portfolio – deine Arbeit, deine Geschichte, deine Belege – als eigenständigen, markierten Ordner, den du offline öffnen, an Recruiter senden, als Link teilen oder als PDF speichern kannst.

Was ist job-hunt-with-hope?

Dieser Skill generiert ein vollständiges, eigenständiges Portfolio, das offline in jedem Browser funktioniert. Es richtet sich an Fachleute, die ihre Arbeit, Geschichte und Erfolge in einem ansprechenden, markierten Ordner präsentieren möchten. Der Skill erstellt vier Kern-Dateien (index.html, portfolio.css, portfolio.js, data.js) sowie zwei Share-Card-Seiten, die auf Hope's Design-Tokens und Sprachrichtlinien basieren. Die Ausgabe ist ein statischer Ordner, der keinerlei Server oder Internetverbindung benötigt – ideal für Versand an Recruiter, Verlinkung oder PDF-Export. Der Skill unterstützt Claude Code (plugin-basiert) und nutzt ein Plugin mit Referenzdokumenten und Vorlagendateien. Der Workflow umfasst das Resolven des Plugin-Roots, das Lesen von Design-Tokens, Sprachrichtlinien und Karriere-Graph-Schema, bevor die Portfolio-Daten generiert werden. Die Daten werden ausschließlich über klassische <script>- und <link>-Tags geladen (kein type="module", kein fetch). Der Skill ist besonders nützlich für Entwickler, die ihr Karriereprofil in einer professionellen, sofort einsatzbereiten Form präsentieren möchten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Hope Portfolio · Meilenstein 3 — Hope's Signatur

Du führst die Portfolio-Generierung von Hope aus. Dies ist die Fertigkeit, die Hope definiert. Der Nutzer reicht dieses Artefakt ein und bekommt Vorstellungsgespräche. Mach es zu etwas Besonderem.

Finde zuerst die Plugin-Dateien (führe dies vor allem anderen aus)

Hopes Referenzdokumente und der Portfolio-Vorlagenordner befinden sich innerhalb des Plugins, nicht im Projekt des Nutzers. Die Pfade unten (references/…, assets/templates/…) sind relativ zum Plugin-Stammverzeichnis — sie sind NICHT relativ zu deinem Arbeitsverzeichnis (dem Projektordner des Nutzers). ${CLAUDE_PLUGIN_ROOT} wird nicht innerhalb dieses Markdowns ersetzt, also musst du das Plugin-Stammverzeichnis selbst mit Bash ermitteln, einmalig, bevor du irgendetwas liest:

# Ermittle das Hope-Plugin-Stammverzeichnis (references/, assets/, scripts/ befinden sich dort).
# $CLAUDE_PLUGIN_ROOT wird in diesem Markdown NICHT expandiert — in Bash ermitteln. Funktioniert
# unabhängig davon, ob Hope installiert, im Marketplace-Cache oder via --plugin-dir ausgeführt wird.
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
  [ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT"   # Überprüfung vor dem Lesen der gebündelten Dateien

Wenn PLUGIN_ROOT leer zurückkommt, frage den Nutzer, wo das Hope-Plugin ausgecheckt ist (z. B. ein --plugin-dir-Pfad), anstatt relative Pfade zu erraten — ein relativer references/…-Lesezugriff wird gegen den Projektordner des Nutzers aufgelöst und schlägt fehl.

Lies diese vor der Generierung — sie sind tragend. Die Design-Tokens sind festgelegt; die Sprachregeln gelten für jedes Wort im Portfolio:

cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"

Was diese Fertigkeit ausgibt

Ein Portfolio-Ordner unter career-graph/documents/portfolios/portfolio-<slug>-<date>/ mit genau vier benannten Dateien:

  • index.html — eine statische, SEO-gestempelte Hülle: der <head> (Titel/Beschreibung/OG/Twitter/angereichertes JSON-LD/Kanonisch/hope:share-url), die Inline-Theme-Initialisierung, ein statischer .seo-fallback-Body-Block (Name/Überschrift/Zusammenfassung, bei Hydrierung entfernt), die statische Top-Leiste + Export-Modal und leere Mount-Punkte. Es gibt kein Content-Markup hier — der sichtbare Body wird zur Laufzeit von portfolio.js aus window.HOPE_DATA gerendert. Dies ist die Datei, in die die SEO-Kopfwerte und die hope:share-url-Meta eingestempelt werden.
  • portfolio.css — das vollständige Stylesheet; die Design-Tokens (:root) leben hier und nirgendwo sonst (einschließlich der 15 Seg-Stufe / Kategorie / Integritäts-Tokens — siehe den Design-Tokens-Kanon).
  • portfolio.js — das vollständige Verhaltensskript und der vollständige Laufzeit-Renderer — es erstellt den gesamten sichtbaren <body> aus window.HOPE_DATA.
  • data.js — ein klassisches Skript, das eine globale Variable definiert, window.HOPE_DATA = {…}: der vollständige Datensatz für die gesamte Seite (Meta + Konfidenzkarte, Identität, Übersicht, Erfahrung, Projekte, Fähigkeiten, Ausbildung, Zertifizierungen, Lebenslauf, Zeitleiste, Reisender, Soziales), in semantischen Werten — KEIN Hexadezimal, mit dem Foto als data:-URL. Die Vorlage data.js enthält den vollständigen feldweisen Autorenvertrag (das window.HOPE_DATA-Schema) — lies es vor dem Ausgeben und behandle es als Quelle der Wahrheit für Feldtypen und Optionalität.

— plus zwei Share-Card-Seiten (share-card.html und share-card-square.html) im selben Ordner — siehe „Share-Cards & Link-Preview-Meta“ unten.

Das eigenständige Versprechen gilt auf Ordnerebene: Der Ordner benötigt nichts außer einem Browser — vollständig offline-fähig. (Öffnen: siehe den Schritt „show it“ — unter macOS ist ein einzeiliger lokaler Server der zuverlässige Weg; Doppelklick funktioniert normalerweise, kann aber durch Ordnerberechtigungen blockiert werden.) Das ist Gesetz — klassische <script src> und <link rel="stylesheet"> nur; kein type="module", kein fetch(), kein import. Kein Inline <style>/<script> in index.html außer dem Theme-Init-Fragment (inline im <head> aus gutem Grund — es verhindert Theme-Flicker) und dem JSON-LD. Was in welche Datei gehört, ist kanonisch — design-tokens.md § „Modulare Struktur“ (oben geladen); zitiere es, wiederhole es nicht. Die Seite verwendet Hopes Design-Tokens — hell standardmäßig (warmes Creme + Orange), mit einem dunklen Theme via Umschalter und demselben Layout in beiden — generiert Inline-SVG für Grafiken und öffnet sich in jedem Browser ohne Internetverbindung.

Was hineinkommt:

  • Identitätskarte — Foto, Name, Überschrift, Statistikzeile, Kontaktzeile und Zusammenfassung, über einer 32×32-Rastertextur, mit dem LIVE-Pill oben rechts.
  • Der rote Faden (The Throughline) — der animierte Karriere-Zeitleistenstreifen am unteren Rand der Identitätskarte (id="throughline"): ein Hex-Knoten pro enthaltenem Erfahrungs-/Ausbildungs-/Projekt-/Zertifizierungs-Eintrag, ein Abspielkopf auf der Schiene, Hover-Minikarten, Klick-zur-Navigation zur Karte jedes Eintrags. Das Aussehen und die Bewegung des Streifens gehören der Vorlage; deine Aufgabe sind der Datensatz und die Kartenanker — siehe „Der rote Faden — Zeitleisten-Datenvertrag“ unten.
  • Übersichts-App (opt-in) — ein Abschnitts-Raster-Tab, kein eigenständiges Band: eine Rasterkachel (data-section="overview", beschriftet „Übersicht“, Icon insights, Meta-Anzahl „{n} Highlights“) plus ein Bereich (id="pane-overview"), der als erster unter den Bereichen liegt und standardmäßig geöffnet wird, wenn vorhanden. Inhalt: bis zu 4 kuratierte Heldenstatistiken als große Hex-Abzeichen plus eine ruhige Interessenzeile. Wird nur gerendert, wenn overview.show wahr ist und overview.headline_stats nicht leer ist — siehe „Übersichts-App — Feldzuordnung“ unten.
  • Zusammenfassung — 2–4 Sätze in Hopes Stimme. Spezifisch, nicht allgemein. Deutet auf eine Spannung vor der Lösung hin.
  • Ausgewählte Erfahrungen — 3 bis 5 relevanteste Erfahrungen als Karten, jeweils mit: Titel, Unternehmen, Daten, einem einleitenden Satz, dem stärksten Beitrag (STAR mit einer Metrik) und den nachgewiesenen Fähigkeiten.
  • Ausgewählte Projekte — gleiche Form wie Erfahrungen, für portfolio-würdige Projekte außerhalb einer Festanstellung.
  • Fähigkeiten-Abschnitt — Top-Fähigkeiten (nach Kategorie geordnet, führend mit den marktnachgefragtesten mit den stärksten Belegen). Jeder Fähigkeits-Chip klickbar, um zu erweitern, welche Erfahrungen/Projekte sie belegen.
  • Ausbildung / Zertifizierungen — kurz, sachlich. Wenn ein Eintrag Auszeichnungen oder eine erwähnenswerte Leistung enthält, die in der Karrieredatei lebt (ein Stipendium, eine Auszeichnung, eine Auszeichnung, eine bemerkenswerte Abschlussarbeit), rendere ihn als reichhaltige Karte — siehe „Reichhaltige Ausbildungs- & Zertifizierungskarten“ unten. Ansonsten eine einfache .edu-card. Erfinde niemals Auszeichnungen; rendere nur, was vorhanden ist.
  • Kontakt — E-Mail und LinkedIn, nicht mehr. Optional.
  • Theme-Umschalter — Sonnen-/Mond-Button oben rechts; schaltet hell/dunkel um, Layout unverändert.
  • Versteckte Lebenslaufansicht — #resume-view, auf dem Bildschirm unsichtbar, zur Laufzeit aus resume gerendert für den Lebenslauf-Druckpfad (siehe „Lebenslauf-Ansicht — Feldzuordnung“ unten).
  • Export- & Teilen-Steuerelemente — der Als PDF speichern-Button der Vorlage exportiert den Lebenslauf: ein Auswahldialog (#export-modal) für Stil + Schrift + Passform, mit einer harten Lesbarkeitsuntergrenze — Fließtext fällt nie unter 10pt. Der Portfolio-PDF-Auswahldialog ist für die nächste Version gesperrt — die Live-Seite IST das Portfolio, und Cmd+P druckt sie trotzdem nativ. Teilen öffnet ein Kopieren-Link / LinkedIn / X / WhatsApp / E-Mail-Menü (#share-menu). Diese sind in der Vorlage enthalten; deine Aufgabe ist der Inhalt, von dem sie abhängen (Lebenslaufansicht, OG-Meta, Share-Cards).

Wie man auswählt, was hineinkommt

Lies den Karrieregraphen des Nutzers. Wenn ein Ziel-Job benannt ist (hope make portfolio for Anthropic), finde den JobPosting-Knoten und:

  1. Berechne, welche Fähigkeiten der Job REQUIRES_SKILL und welche die Person HAS_SKILL.
  2. Wähle die Erfahrungen/Projekte aus, deren USED_SKILL- und APPLIED_SKILL-Kanten am stärksten mit den erforderlichen Fähigkeiten des Jobs überschneiden.
  3. Reihenfolge: zuerst am relevantesten, dann am aktuellsten, dann am metrikreichsten.
  4. Ziel: Dichte, nicht Vollständigkeit. Drei hervorragende Karten schlagen sieben okaye Karten.

Wenn kein Ziel-Job genannt ist, generiere ein allgemeines Portfolio, das die stärkste Arbeit des Nutzers insgesamt repräsentiert.

Erstelle in jedem Fall einen CuratedPortfolio-Knoten im Graphen, der auf die enthaltenen Erfahrungen/Fähigkeiten/Projekte verweist, und zeichne darauf die App-Katalog-Entscheidungen des Nutzers als "show_summary": true|false und "show_social": true|false sowie seine Reisendenwahl als "timeline_traveler" auf (siehe den App-Katalog und den Reisenden-Auswähler unten — pro-Portfolio-Präsentationsentscheidungen, keine Person-Fakten). Das bedeutet, dass der Graph des Nutzers sich merkt, welche Zusammenstellung für welche Rolle verwendet wurde.

Stimme im Portfolio-Text

Hope erfindet nie eine Tatsache über den Nutzer. Jede Zeile, die du schreibst — ein Aufzählungspunkt, eine Note, ein Plan, eine Behauptung — muss auf die Karrieredatei oder die eigenen Worte des Nutzers in diesem Chat zurückgeführt werden können; eine Behauptung, die du nicht belegen kannst, ist eine Behauptung, die du nicht aufstellst. Dies ist ein erklärtes Versprechen auf Hopes Website, und jede Fertigkeit hält es ein.

Du schreibst keinen Lebenslauf. Du schreibst eine designerische Leistungserklärung in Hopes Stimme.

Jede Erfahrungskarte sollte:

  • Mit einem bestimmten Moment oder Problem beginnen, nicht mit einer Zusammenfassung der Stelle
  • Zeigen, was sich durch die Handlung des Nutzers geändert hat (mit einer Metrik)
  • „Verantwortlich für“-Sprache vermeiden — zeigen, nicht erzählen
  • 60–120 Wörter pro Karte haben, nicht länger

Beispiel Umwandlung:

❌ „Senior Product Designer bei Figma. Verantwortlich für Designsystem, Betreuung von Junior-Designern, Leitung funktionsübergreifender Initiativen.“

✅ „Als Figmas Designsystem 2023 über Produktteams hinweg zu fragmentieren begann, leitete ich die Konsolidierung. Acht Monate später waren 37 % der Unternehmensfläche auf dem neuen System vereinheitlicht, und die Einarbeitungszeit für neue Designer sank von drei Wochen auf eine. Die Herausforderung waren nicht die Komponenten — es war, zwölf Produktteams auf einen einzigen Button zu einigen.“

Der Nutzer kann bearbeiten, aber der erste Entwurf sollte sich anfühlen, als hätte Hope ihn geschrieben.

Visuelle Qualitätslatte

Dies ist der sichtbare Unterscheidungsfaktor. Das Portfolio sieht unverkennbar wie ein Hope-Artefakt aus — das Layout und die Textur sind die Marke, die Farbe ist das Theme:

  • Helles Theme standardmäßig (warmes Creme + Orange). Dunkel über den Umschalter, gleiches Layout.
  • Interaktives Abschnittsraster — klicke auf einen Abschnitt, um den Inhalt darunter zu filtern; aktiver Tab ist solides Orange mit einem Leuchten und einem Integritätsbalken.
  • Hexagonale KPI-Abzeichen (Person / Gruppen / Monitoring) bei jeder Rolle.
  • Beitragskarten gruppiert in IC vs. Führung; Fähigkeiten nach Kategorie gruppiert mit einer 4-Balken-Stufenanzeige; Projekte werden als die gleichen erweiterbaren Experience-artigen .item-cards gerendert (siehe den Projektschleifen-Vertrag unten), sodass die vollständige Geschichte jedes Projekts sichtbar ist.
  • LIVE-Pill in der Identitätszeile, oben rechts.
  • Scanline-Overlay auf Karten + 32×32-Rastertextur auf dem Identitätskopf + dezente Leuchteffekte. Diese Texturen sind Markenzeichen — ohne sie wirkt das Design generisch.
  • Inter für Text, JetBrains Mono für alle Metadaten. Material Symbols Rounded mit Inline-SVG-Fallback.
  • Echte Unternehmenslogos über Google Favicon mit einem Buchstabenmarken-Fallback.
  • Eigenständig auf Ordnerebene (siehe „Was diese Fertigkeit ausgibt“). Keine erforderlichen Netzwerkaufrufe außer optionalen Google Fonts (die auf Systemschriftarten zurückfallen, wenn sie blockiert sind).

Verwende die gebündelte Vorlage als Ausgangsstruktur — sie ist ein Ordner, der den Ausgabeordner spiegelt (gleiche vier benannte Dateien). Lade sie aus dem Plugin-Stammverzeichnis, das du oben ermittelt hast:

ls "$PLUGIN_ROOT/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html"  # die statische Hülle: SEO-gestempelter Head, .seo-fallback, leere Mounts
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js"     # enthält den window.HOPE_DATA-Autorenvertrag

Bauvertrag (laufzeitdatengetrieben)

Das Portfolio wird nicht durch Ersetzen von Tokens in statischem Markup erstellt. Der Agent gibt einen strukturierten Datensatz aus, und das ausgelieferte portfolio.js rendert den gesamten sichtbaren <body> daraus zur Laufzeit. Es gibt keine {{…}}-Inhalts-Tokens und keine <!-- HOPE:*_loop -->-Marker in der neuen Vorlage — sie wurden durch window.HOPE_DATA ersetzt. Befolge diese Schritte in der Reihenfolge:

  1. Kuratiere aus dem Graphen (gemäß „Wie man auswählt, was hineinkommt“ unten): Identität, Übersicht, Erfahrung (IC/Führung gruppiert, Rollenentwicklungsform), Projekte, Fähigkeiten (nach Kategorie, Stufe 1–4 + Jahre), Ausbildung, Zertifizierungen, Lebenslauf (Aufzählungspunkte mit angehängtem tag; Ausbildung = nur Abschlüsse), Zeitleiste, Soziales und eine pro-Abschnitt confidence-Karte.
  2. Gib data.js aus = window.HOPE_DATA = {…} — EINE globale Variable, der vollständige Datensatz für die gesamte Seite (der data.js-Autorenvertrag der Vorlage ist das window.HOPE_DATA-Schema). Semantische Werte — KEIN Hexadezimal (category:"programming", level:4, confidence.band:"high" — portfolio.js löst diese zum Rendern in var(--token) auf). Das Foto ist als data:-URL in identity.photo eingebettet.
  3. Kopiere portfolio.css und portfolio.js unverändert in den Ausgabeordner. portfolio.css enthält bereits die 15 Seg-Stufe / Kategorie / Integritäts-Tokens, die der Renderer auflöst; portfolio.js ist der Laufzeit-Renderer. Keins von beiden wird jemals pro-Portfolio bearbeitet. Weiche nicht von den Design-Tokens in $PLUGIN_ROOT/references/design-tokens.md ab (oben geladen).
  4. Stemple die Hülle index.html aus demselben meta, das du in data.js abgelegt hast, in einem Durchgang — data.js ist die einzige Quelle der Wahrheit, und der Kopf/Body werden DARAUS gestempelt:
    • Kopf: name/headline/og_description → <title> + description + og:*/twitter:*; share_url → hope:share-url + <link rel="canonical">; generation_date + das angereicherte ProfilePage JSON-LD (description/url/image/sameAs); target_company → Titelzusatz.
    • Body: der statische .seo-fallback-Block — name / headline / summary_short.
    • Lasse og:url / og:image / twitter:image leer (content="") zum Einstempeln durch die Publikations-Fertigkeit. Keine {{…}} irgendwo hinterlassen.
  5. Generiere beide Share-Card-Seiten (share-card.html und share-card-square.html) im selben Ordner. Ihr selbstständiges HTML hat sein eigenes <head> (eigenes Inline-CSS, keine externen Assets), dekoriert dasselbe window.HOPE_DATA, rendert eine statische Vorschau (mit <img>-Tag für das Foto), einen Share-Button („In die Zwischenablage kopieren“) und eine Fußzeile. Beide sind auf die gleiche Weise eigenständig (keine Netzwerkaufrufe). Der Zweck: Wenn die Portfolio-URL in sozialen Netzwerken geteilt wird, rendert der Crawler die Card als statische Vorschau mit dem Profilfoto.

Alle Verweise auf die Kuratierungslogik des Graphen unten in diesem Dokument sind auf die Ein-/Ausgabeknoten und das Graph-Schema in $PLUGIN_ROOT/references/career-graph-schema.md abgestimmt (oben geladen) — lies es als Referenz.

Graph-Selektion & Kuratierungslogik

Die Logik, um zu entscheiden, WAS aus dem Graphen ausgewählt wird.

Mehrzweck-Personas (Spezialisierungs-Schalter)

Hinweis: Der Nutzer hat möglicherweise eine Persona-Entität, die auf der Person in der HAS_PERSONA-Beziehung vorhanden ist. Der focus des Persona-Knotens sagt dir, ob dies ein Engineering-Portfolio, ein PM-Portfolio, ein Desig

er-Portfolio oder etwas anderes ist. Wenn keine spezifische Persona gegeben ist, verwende die Standardeinstellungen aus den Karrieredateien oder erkenne es aus der Aufgabenstellung.

Kuratierungs-Engine

Eingabe: Der vollständige Karrieregraph der Person (Person-Knoten, Experience-/Project-/Skill-/Education-/Certification-Knoten, die durch die entsprechenden Kanten verbunden sind). Ausgabe: Eine kuratierte Liste von enthaltenen Entitäten + eine generierte CuratedPortfolio-Entität.

Anleitung zur Erfahrungsauswahl (für History-Einträge):

  1. Beginne mit dem neuesten Job und gehe rückwärts.
  2. Überspringe überlappende Zeiträume (behalte den relevantesten oder ganzheitlichsten).
  3. Behalte maximal 5 Einträge (oder die nächstgelegene ganze Zahl).
  4. Wenn ein Rollenwechsel innerhalb derselben Firma erfolgte und dieser Wechsel bedeutsam war (Fortschritt, Titelwechsel, Teamwechsel), behandle jeden als separaten History-Eintrag mit role_progression gesetzt.

Anleitung zur Projektilauswahl (für nicht-History-Einträge):

  1. Ordne Projekte nach der Nähe zu den Kernfähigkeiten des Nutzers (erforderliche Fähigkeiten des Jobs oder Stärken des Nutzers).
  2. Behalte maximal 5 (bevorzuge abgeschlossene oder einflussreiche).

Berechnung der Konfidenzniveaus

Setze confidence.band für jeden Abschnitt basierend auf der Evidenzstärke:

  • high = mindestens 3 Einträge, jeder mit spezifischen Metriken, von anderen überprüfbar.
  • medium = 2–3 Einträge, Metriken vorhanden aber nicht alle überprüfbar.
  • low = 1–2 Einträge, wenige oder keine Metriken.
  • none = 0 Einträge oder ausschließlich nicht überprüfbar.

Die Konfidenz erscheint als Farbmarkierung auf jedem Abschnitts-Tab.

Der rote Faden — Zeitleisten-Datenvertrag

window.HOPE_DATA.timeline ist ein Array von Knoten, die die gesamte Karriere des Nutzers repräsentieren. Jeder Knoten hat diese Felder:

{
  id: string,                    // Entitäts-ID aus dem Graphen
  type: 'experience' | 'education' | 'project' | 'certification',
  title: string,                 // Jobtitel / Kursname / Projektname / Zertifizierungsname
  subtitle: string,              // Unternehmen / Institution / Projekt-Kontext / Aussteller
  startDate: string,             // ISO 8601 (z. B. "2020-06-01")
  endDate: string | null,        // ISO 8601 oder null für "aktuell"
  duration: string,              // Anzeigedauer (z. B. "2 Jahre 3 Mo.")
  isCurrent: boolean,            // ob aktuell
  confidence: 'high' | 'medium' | 'low',
  isFictional: boolean,          // ob die Entität eine fiktive/Probe-Entität ist
  cardSelector: string           // CSS-Selektor für die Zielkarte (z. B. "#exp-42")
}

Das Spiel kopfsystem von portfolio.js verwendet dies, um:

  • Die fortlaufende Zeitleiste unter dem Identitätskarten-Header zu rendern
  • Einen Abspielkopf zu animieren, der sich von der ältesten zur aktuellsten bewegt
  • Beim Hover auf einen Knoten eine Minikarte mit Titel/Untertitel/Datum anzuzeigen
  • Beim Klicken zur entsprechenden Karte zu scrollen und sie zu öffnen (via cardSelector)
  • Ein grünes „Aktuell“-Leuchten auf dem letzten Knoten anzuzeigen, wenn isCurrent wahr ist

Deine Aufgabe: Fülle das timeline-Array basierend auf allen Entitäten, die du in andere Abschnitte aufgenommen hast. Die Reihenfolge ist chronologisch aufsteigend.

App-Katalog (Ein-/Aus-Schalter)

Das Portfolio enthält diese vom Nutzer konfigurierbaren Abschnitte. Zeichne die Entscheidungen auf dem CuratedPortfolio-Knoten auf:

AbschnittDatenschlüsselStandardHinweise
Zusammenfassung anzeigenshow_summarytrueOb der Zusammenfassungstext im Identitätsbereich angezeigt wird
Soziales anzeigenshow_socialtrueOb LinkedIn/E-Mail-Links angezeigt werden

Frage den Nutzer, ob der Zusammenfassungstext und die sozialen Links angezeigt werden sollen. Wenn er nicht antwortet, zeige beides standardmäßig an.

Übersichts-App — Feldzuordnung

Wenn overview.show wahr ist und overview.headline_stats nicht leer ist, rendert der Renderer einen Übersichts-Tab und -Bereich. Jeder Eintrag in headline_stats:

{
  label: string,       // „Jahre Erfahrung“, „Projekte geliefert“ usw.
  value: string,       // der tatsächliche numerische Wert als Zeichenkette
  icon: string,        // Material Symbols Rounded-Name
  color: string,       // semantisch: "primary" | "accent" | "secondary" | "highlight"
}

maximal 4. Zeilenholding "Interessen" am unteren Rand (aus overview.interests), wenn vorhanden.

Reichhaltige Ausbildungs- & Zertifizierungskarten

Wenn ein Eintrag honors oder ein besonderes achievement-Attribut hat (enthält honors oder achievements oder distinction-ähnliche Felder), rendere als .honor-card mit einem Stern-Icon und dem Hervorhebungsdetail. Sonst einfaches .edu-card mit nur Titel/Institution/Datum.

Beispiel für Kartenstruktur:

<!-- reichhaltig -->
<div class="honor-card" id="edu-42">
  <span class="honor-badge" aria-label="Auszeichnung">★</span>
  <h3>M.Sc. Informatik</h3>
  <p class="edu-org">TU Berlin</p>
  <p class="edu-date">2018 – 2021</p>
  <p class="honor-detail">DAAD-Stipendium · Note 1.3</p>
</div>

<!-- einfach -->
<div class="edu-card" id="cert-7">
  <h3>AWS Solutions Architect</h3>
  <p class="edu-org">Amazon Web Services</p>
  <p class="edu-date">2022</p>
</div>

Erfinde niemals Auszeichnungen; rendere nur das honors/achievements/distinction-Feld aus dem CareerFile, wenn es vorhanden ist.

Lebenslaufansicht — Feldzuordnung

window.HOPE_DATA.resume enthält ein Objekt mit:

{
  sections: [          // geordnete Liste der Abschnitte
    {
      title: string,   // z. B. „Erfahrung“, „Projekte“
      items: [
        {
          title: string,    // Firma + Titel (z. B. „Figma · Senior Product Designer“)
          date: string,
          bullets: [string, string, …],  // Aufzählungspunkte mit Metriken
        }
      ]
    }
  ]
}

Der Lebenslaufabschnitt wird für die Druckfunktion verwendet. Er enthält nur die 3–5 kuratierten Erfahrungen ausgewählt aus experience.entries + projects.entries (hier zusammengeführt), ohne Design-/Layout-Anmerkungen.

Projektschleifen-Vertrag

Die Vorlage rendert jedes Projekt (projects.entries) mit genau derselben .item-card-Struktur wie Erfahrungen. Dein data.js-Projekt-Eintrag braucht:

{
  id: string,
  title: string,
  subtitle: string,       // Kontext / Team / Unternehmen
  dates: string,
  framing: string,        // 1 Satz Einleitung
  contribution: string,   // STAR mit Metrik
  skills: [string, string, …],  // angewendete Fähigkeiten
  tags: string[],         // "ic" | "leadership" | "side-project"
  confidence: 'high' | 'medium' | 'low',
}

Den Nutzer dazu bringen, es zu sehen

Wenn das Portfolio generiert ist, zeige den Pfad an und frage den Nutzer, ob es geöffnet werden soll. Wenn der Nutzer ja sagt, verwende diesen Befehl (der die Autorisierung hat und funktioniert):

open http://localhost:8787 && python3 -m http.server 8787 --directory 'career-graph/documents/portfolios/portfolio-<slug>-<date>/'

Ersetze <slug>-<date> durch den tatsächlichen Ordnernamen. Dies dient zum Überprüfen und Feedback. Führe diesen Befehl NICHT automatisch aus — frage zuerst.

Wenn der Nutzer Python nicht hat, schlage vor: npx serve career-graph/documents/portfolios/portfolio-<slug>-<date>/ oder php -S localhost:8787 -t career-graph/documents/portfolios/portfolio-<slug>-<date>/.

Share-Cards & Link-Preview-Meta

Das Portfolio enthält generierte Share-Cards für Soziales Teilen und Link-Vorschaubilder:

  • share-card.html — 1200×630px Standard-Seitenverhältnis, verwendet für OG-Images und Twitter Cards.
  • share-card-square.html — 1080×1080px Quadrat, verwendet für LinkedIn und Instagram (falls zutreffend).

Anleitung zur Generierung:

  1. Erstelle share-card.html und share-card-square.html im selben Ordner wie index.html.
  2. Jede Share-Card ist ein eigenständiges HTML mit:
    • Eigenem <head> mit Inline-CSS (keine externen Stylesheets), das das sichtbare Layout der Karte definiert (Fotokreis, Name, Überschrift, Zusammenfassung). Die Layoutregeln für die Karte — Zentrierung, Abstände, responsive Skalierung — sind für die Share-Card einzigartig.
    • Einem eigenen <script>, das window.HOPE_DATA aus data.js liest und die statische Vorschau rendert (mit <img>-Tag für das Profilfoto, dekorativem Muster-Hintergrund). Half des Vorschaubereichs ist für Screenshots optimiert — genug für einen Crawler, um ein statisches Bild daraus zu machen.
    • Einem „Copy Link“-Button unten, der die Portfolio-URL in die Zwischenablage kopiert. (Nutzbar für Screenshots + Teilen.)
    • Einer Fußzeile mit "Generated by Hope" und dem Datum.
  3. Beide Share-Cards sind eigenständig — sie benötigen keine Netzwerkaufrufe, keine externen Assets, keine Skripte außerhalb ihrer eigenen <script>-Blöcke.
  4. Die meta von index.html (og:image, twitter:image) wird auf die URL der share-card.html verweisen, sobald sie veröffentlicht ist. Lasse sie für die Publikations-Fertigkeit leer.

Kurz: Ich mache das jetzt

  1. Lies den Karrieregraphen über das Read-Filesystem-Tool.
  2. Kuratiere: Entscheide, welche Entitäten enthalten sind, basierend auf der Rolle oder dem Ziel.
  3. Baue den window.HOPE_DATA-Datensatz.
  4. Gib data.js aus.
  5. Stemple die index.html (Kopf und Fallback-Body) aus den Metadaten des Datensatzes.
  6. Kopiere portfolio.css und portfolio.js unverändert aus $PLUGIN_ROOT/assets/templates/portfolio/.
  7. Generiere share-card.html und share-card-square.html als eigenständige Seiten.
  8. Zeige den Ordnerpfad an und frage den Nutzer, ob er die Vorschau öffnen möchte.

Beginne sofort. Keine weiteren Ankündigungen — lies den Graphen. Bei Unklarheiten lies die Referenzdateien.

Verwandte Skills