Communitygithub.com

Yukiniro/skills

Konvertieren Sie Lebensläufe in interaktive, animierte einseitige HTML-Websites mit unverwechselbaren visuellen Stilen.

Was ist skills?

Diese Fähigkeit verwandelt Lebensläufe in eigenständige, animationsreiche HTML-Seiten, die vollständig im Browser laufen – ohne Abhängigkeiten von npm oder Build-Tools. Der Benutzer lädt eine Bewerbungsdatei (PDF, DOCX, Markdown, Plain Text, JSON Resume) hoch oder gibt den Text direkt ein. Das Tool extrahiert und strukturiert die Daten in Abschnitte wie Berufserfahrung, Ausbildung, Fähigkeiten und Projekte. Der entscheidende Vorteil liegt in der visuellen Stilfindung: Statt den Benutzer eine Vorlage auswählen zu lassen, generiert die Fähigkeit drei Vorschaubilder basierend auf den Präferenzen des Nutzers (z. B. „Modern/Technisch“ oder „Kreativ/Unverwechselbar“). Der Nutzer wählt dann seinen bevorzugten Stil aus einer Reihe von unverwechselbaren Presets wie „Midnight Architect“, „Neon Terminal“ oder „Brutalist Mono“. Die fertige HTML-Datei enthält integrierte CSS-Animationen, ist druckfreundlich und barrierefrei (semantisches HTML, Tastaturnavigation, reduziert Bewegung, WCAG AA).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

In Ihrer bevorzugten KI fragen

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

Dokumentation

Frontend Lebenslauf

Erstellen Sie abhängigkeitsfreie, animationsreiche HTML-Lebenslauf-Seiten, die vollständig im Browser laufen. Helfen Sie Benutzern, ihre bevorzugte Ästhetik durch visuelle Erkundung zu entdecken, und generieren Sie dann produktionsreife interaktive Lebensläufe.

Kernphilosophie

  1. Keine Abhängigkeiten — Einzelne HTML-Dateien mit inline CSS/JS. Kein npm, keine Build-Tools.
  2. Zeigen, nicht erzählen — Generieren Sie visuelle Vorschauen, lassen Sie Benutzer auswählen, was ihnen gefällt.
  3. Unverwechselbares Design — Vermeiden Sie generische "KI-Müll"-Ästhetik. Jeder Lebenslauf sollte maßgeschneidert wirken.
  4. Druckfreundlich — JEDER Lebenslauf MUSS @media print-Stile für saubere PDF-Ausgabe enthalten.
  5. Barrierefrei — Semantisches HTML, Tastaturnavigation, Unterstützung für reduzierte Bewegung, WCAG-AA-Kontrast.

Phase 0: Modus erkennen

Ermitteln, was der Benutzer möchte:

Modus A: Aus Datei — Benutzer stellt eine Lebenslauf-Datei bereit (.pdf, .docx, .md, .txt, .json) → Phase 1 Modus B: Aus Text — Benutzer stellt Lebenslauf-Inhalt als Text bereit → Phase 1 Modus C: Verbesserung — Benutzer hat einen vorhandenen HTML-Lebenslauf zu verbessern → Datei lesen, dann Phase 2


Phase 1: Inhaltsextraktion und -strukturierung

Schritt 1.1: Dateiextraktion (nur Modus A)

Führen Sie scripts/extract_resume.py mit der Lebenslauf-Datei des Benutzers aus:

python [skill-dir]/scripts/extract_resume.py <resume_file>

Unterstützte Formate und Abhängigkeiten:

FormatErweiterungenPython-AbhängigkeitHinweise
PDF.pdfpdfplumber (bevorzugt) oder PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
Markdown.mdKeineAnalysiert Überschriften, Listen, Fett/Kursiv
Nur Text.txtKeineZeilen in GROSSBUCHSTABEN werden als Überschriften interpretiert
JSON Resume.jsonKeine (integriertes json)jsonresume.org Schema; bereits strukturiert – Schritt 1.2 kann übersprungen werden

Wenn eine erforderliche Abhängigkeit fehlt, gibt das Skript Installationsanweisungen aus.

Präsentieren Sie dem Benutzer den extrahierten Inhalt zur Bestätigung. Bei JSON-Resume-Dateien sind die Daten bereits strukturiert – präsentieren Sie die zugeordneten Abschnitte direkt und fahren Sie mit Schritt 1.3 fort, es sei denn, der Benutzer möchte Anpassungen vornehmen.

Schritt 1.2: Inhalt strukturieren

Analysieren Sie Rohtext in strukturierte Abschnitte:

  • header: Name, Titel/Slogan, Standort, Kontakt (E-Mail, Telefon, LinkedIn, GitHub, Portfolio)
  • about: Berufliche Zusammenfassung
  • experience[]: Unternehmen, Rolle, Daten, Standort, Aufzählungspunkte
  • education[]: Schule, Abschluss, Daten, Auszeichnungen/NOTE
  • skills{}: Gruppiert nach Kategorie mit optionalen Kenntnisstufen (0-100)
  • projects[]: Name, Beschreibung, Tech-Stack, Link
  • certifications[]: Name, Aussteller, Datum (optional)
  • languages[]: Sprache, Kenntnisse (optional)

Präsentieren Sie dem Benutzer den strukturierten Inhalt zur Überprüfung. Fragen Sie: "Sieht das korrekt aus? Sollen Abschnitte hinzugefügt, entfernt oder geändert werden?"

Schritt 1.3: Abschnittspriorität

Fragen Sie per AskUserQuestion:

  • Header: "Layout"
  • Frage: "Welche Abschnitte sollten am prominentesten sein?"
  • Optionen:
    • "Erfahrungslastig" — Berufserfahrung steht im Mittelpunkt (erfahrene Fachleute)
    • "Fähigkeitenfokussiert" — Technische Fähigkeiten im Vordergrund (Entwickler/Ingenieure)
    • "Projektgetrieben" — Portfolio/Projekte im Fokus (Designer/Freiberufler)
    • "Ausgewogen" — Alle Abschnitte haben gleiches Gewicht

Phase 2: Stilfindung

Schritt 2.0: Stilpfad

Fragen: "Wie möchten Sie Ihren Lebenslauf-Stil auswählen?"

  • "Zeig mir Optionen" — Generieren Sie 3 visuelle Vorschauen (empfohlen) → Schritt 2.1
  • "Ich weiß, was ich will" — Direkt aus einer voreingestellten Liste auswählen → Voreinstellungsauswahl unten anzeigen

Verfügbare Voreinstellungen:

VoreinstellungStimmungAm besten geeignet für
Midnight ArchitectAnspruchsvoll, PremiumFührungskräfte, Berater
Neon TerminalHacker-Chic, EntwicklerSoftwareentwickler, DevOps
Dark LuxeElegant, RedaktionellKreativdirektoren, Marketing
Cosmic DepthKühn, futuristischTech-Gründer, KI/ML-Ingenieure
Clean SlateMinimalistisch, SchweizerischDesigner, Produktmanager
Paper CraftWarm, haptischAutoren, Pädagogen, Akademiker
Soft BlueprintTechnisch, zugänglichIngenieure, Datenwissenschaftler
Brutalist MonoRoh, Anti-DesignMarkenstrategen, Suchende nach Auffälligkeit
Sage GardenNaturinspiriert, beruhigendHR, Wellness, Pädagogen
Retro InkVintage, redaktionellJournalisten, persönliche Marken

Wenn der Benutzer direkt eine auswählt, springen Sie zu Phase 3.

Schritt 2.1: Geführte Entdeckung

Frage 1 — Stimmung (multiSelect bis zu 2):

  • "Professionell/Authoritativ" — Etabliert, vertrauenswürdig
  • "Kreativ/Unverwechselbar" — Einzigartig, designorientiert
  • "Modern/Technisch" — Sauber, entwicklerorientiert
  • "Warm/Zugänglich" — Freundlich, persönlich

Frage 2 — Ton:

  • "Hell" — Sauber, druckbar
  • "Dunkel" — Kühn, bildschirmoptimiert
  • "Egal" — Der Stil entscheidet

Schritt 2.2: Generieren Sie 3 Vorschauen

Basierend auf Stimmung + Ton wählen Sie 3 Voreinstellungen aus. Lesen Sie references/STYLE_PRESETS.md für vollständige Voreinstellungsdefinitionen.

Zuordnung Stimmung zu Voreinstellung:

StimmungDunkelHellSpezialität
ProfessionellMidnight Architect, Dark LuxeClean Slate, Soft Blueprint—
KreativDark Luxe, Cosmic DepthPaper CraftBrutalist Mono, Retro Ink
Modern/TechnischNeon Terminal, Cosmic DepthSoft BlueprintBrutalist Mono
WarmDark LuxePaper Craft, Sage GardenRetro Ink

Generieren Sie 3 Mini-HTML-Vorschauen in .claude-design/resume-previews/:

.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html

Jede Vorschau: in sich geschlossen (~80-120 Zeilen), zeigt Heldenabschnitt + einen Erfahrungseintrag + Fähigkeitsbalken. Genug, um die Ästhetik zu vermitteln.

Verwenden Sie NIEMALS diese generischen Muster:

  • Inter, Roboto, Arial als Anzeigeschriftarten
  • Lila Farbverläufe auf Weiß, generisches Indigo #6366f1
  • Alles zentriert ohne Abwechslung
  • Überflüssiger Glassmorphismus

Schritt 2.3: Auswählen

Präsentieren Sie Vorschauen, bitten Sie den Benutzer, eine auszuwählen oder Elemente zu mischen.


Phase 3: Lebenslauf generieren

Lesen Sie diese Referenzdateien für die gewählte Voreinstellung:

  • references/STYLE_PRESETS.md — Vollständige CSS-Variablen, Schriftart-URLs, Farbpalette, Animationsstil
  • references/RESUME_COMPONENTS.md — CSS/JS-Muster für interaktive Komponenten
  • references/HTML_ARCHITECTURE.md — Basis-HTML-Vorlage, obligatorisches CSS, JS-Architektur, Druckstile, Barrierefreiheits-Checkliste

Ausgabe

Generieren Sie eine einzelne in sich geschlossene HTML-Datei:

  • Alles CSS inline in <style>
  • Alles JS inline in <script>
  • Google Fonts / Fontshare via <link> (anmutige Degradierung)
  • Semantische HTML5-Struktur

Erforderliche Funktionen

  1. Scroll-ausgelöste Einblendungen — Elemente animieren via IntersectionObserver
  2. Schwebende Navigation — Feste Navigation mit aktiver Abschnittsverfolgung
  3. Animierte Fähigkeitsbalken — Füllen beim Scrollen in den Viewport
  4. Scrollfortschrittsbalken — Dünner Balken oben
  5. Zurück-nach-oben-Button — Erscheint nach dem Scrollen
  6. Druck-Stylesheet — @media print mit weißem Hintergrund, keine Animationen, sichtbare URLs
  7. Reduzierte Bewegung — @media (prefers-reduced-motion: reduce) deaktiviert Animationen
  8. Responsiv — Alle Größen verwenden clamp(), funktioniert von Mobil bis Desktop

Überprüfungs-Checkliste

Vor der Auslieferung überprüfen:

  • Alle Typografie verwendet clamp(min, preferred, max)
  • Alle Abstände verwenden clamp() oder Viewport-Einheiten
  • Semantisches HTML (<header>, <main>, <section>, <nav>)
  • Druckstile enthalten und funktionsfähig
  • Reduzierte Bewegung wird beachtet
  • ARIA-Labels auf Navigation, Buttons, Fortschrittsbalken
  • Farbkontrast erfüllt WCAG AA
  • Externe Links haben target="_blank" rel="noopener"

Phase 4: Lieferung

  1. Aufräumen — Löschen Sie .claude-design/resume-previews/, falls vorhanden
  2. Öffnen — Im Browser starten: open [filename].html
  3. Zusammenfassung:
Ihr interaktiver Lebenslauf ist fertig!

Datei: [filename].html
Stil: [Style Name]
Abschnitte: [list]

Funktionen:
- Scroll-ausgelöste Animationen
- Animierte Fähigkeitsbalken
- Interaktive Zeitleiste
- Schwebende Navigation
- Druckfreundlich (Strg+P)
- Responsive auf allen Bildschirmgrößen

Zum Anpassen:
- Farben: Bearbeiten Sie :root CSS-Variablen oben
- Schriftarten: Ändern Sie den Font-Import-Link
- Animationen: Modifizieren Sie .reveal-Klassen-Timings
- Inhalt: Bearbeiten Sie Text direkt im HTML

Möchten Sie, dass ich Anpassungen vornehme?

Fehlerbehebung

PDF-Extraktion liefert wenig Text: PDF könnte bildbasiert (gescannt) sein. Bitten Sie den Benutzer, den Text direkt bereitzustellen.

DOCX-Extraktion fehlende Struktur: Einige DOCX-Dateien verwenden keine Standard-Überschriftenstile (Überschrift 1/2/3). Der Extrahierer greift auf Schriftgröße aus einzelnen Läufen zurück. Wenn die Struktur weiterhin unklar ist, bitten Sie den Benutzer zu bestätigen, welche Zeilen Abschnittsüberschriften sind.

Fehlende JSON-Resume-Felder: Das JSON kann optionale Abschnitte (Projekte, Zertifikate usw.) auslassen. Präsentieren Sie, was verfügbar ist, und fragen Sie den Benutzer, ob er fehlende Abschnitte manuell hinzufügen möchte.

Störung durch Markdown-Frontmatter: YAML-Frontmatter-Begrenzer (---) werden automatisch übersprungen. Wenn der Lebenslauf-Inhalt selbst --- als horizontale Linien verwendet, werden diese ebenfalls übersprungen – dies ist in der Regel harmlos.

Schriftarten werden nicht geladen: Überprüfen Sie die Schriftart-URL. Stellen Sie sicher, dass die font-family-Deklaration einen Systemschriftart-Fallback enthält.

Animationen werden nicht ausgelöst: Überprüfen Sie, ob IntersectionObserver initialisiert ist. Überprüfen Sie, ob die Klasse .visible hinzugefügt wird.

Druckausgabe sieht falsch aus: Stellen Sie sicher, dass der @media print-Block existiert. Überprüfen Sie, ob Animationen deaktiviert und Hintergründe weiß sind.

Verwandte Skills