Communitygithub.com

donotdonuts/claude-workflow-skills

Richtet eine persönliche Portfolio-Website von der donotdonuts.github.io-Vorlage ein. Sammelt Name, Foto, Lebenslauf, soziale URLs und visuelle Stilpräferenzen, generiert Zeitleiste, Projektkarten und Chatbot-Wissen aus dem Lebenslauf und setzt ein passendes Farbschema um. Optionaler DeepSeek-Chatbot hinter einem Cloudflare Worker. Deployment über GitHub Pages.

Was ist claude-workflow-skills?

Dieses Skill wurde für Claude Code (oder vergleichbare KI-Agenten) entwickelt, die Nutzer durch den Aufbau einer personalisierten Portfolio-Website unter `https://<nutzername>.github.io` führen. Es automatisiert die gesamte Einrichtung: Sammlung von Benutzerinformationen, Klonen einer vorgefertigten, aber anpassbaren Vorlage, Generierung von Zeitleiste und Projektkarten aus einem Lebenslauf und optionales Hinzufügen eines DeepSeek-basierten KI-Chatbots. Das Skill generiert eine statische Einzelseite mit Contributor-Profil, Zeitstrahl und Projektkarten. Es passt das Farbschema aus einer Referenz-URL oder einer Textbeschreibung an und erstellt einen optionalen Chatbot mit benutzerdefiniertem Namen und Avatar-Emoji. Der gesamte Code wird auf GitHub Pages bereitgestellt, wobei der Chatbot über einen separaten Cloudflare Worker mit API-Schlüssel geschützt wird. Der Agent muss die Details interaktiv über `AskUserQuestion` und direkte Aufforderungen sammeln, die Vorlage anpassen und die Änderungen in die HTML-, CSS- und JavaScript-Dateien der Vorlage einfügen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/donotdonuts/claude-workflow-skills/tree/HEAD/skills/random-skills/personal-site-setup

In Ihrer bevorzugten KI fragen

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

Dokumentation

Persönliche Website einrichten

Begleite einen neuen Nutzer dabei, sein eigenes Portfolio unter https://<ihr-benutzername>.github.io zu veröffentlichen. Die Architektur ist festgelegt; das Aussehen, die Texte und die Chatbot-Persönlichkeit werden alle an den jeweiligen Nutzer angepasst.

Was sie bekommen

  • Statische Einzelseite, kein Bundler. GitHub Pages serviert main aus dem Repository-Stammverzeichnis.
  • Hero-Bereich — ihr Porträt + Name + einzeiliger Standort + einzeiliger Slogan.
  • Projekte-Bereich mit einer abgeblendeten vertikalen Zeitleiste im Bereichskopf (Schraubenschlüssel-Symbole für Arbeit, Buch-Symbole für Ausbildung, Glitzer-Symbole für Vibe / Nebenprojekt-Stationen; jede Station zeigt Firma, Rolle, Datum, Ort) und einem Raster aus Projektkarten im Hauptteil – beide werden aus dem Lebenslauf des Nutzers generiert.
  • Zeitleisten-↔Karten-Filter — Bewege die Maus über eine Zeitleisten-Station oder fokussiere sie mit der Tastatur, um nicht verwandte Projektkarten auszublenden; klicke, um den Filter zu fixieren (erneutes Klicken hebt ihn auf). Nur Stationen, die mit mindestens einer Karte verknüpft sind, werden interaktiv; andere bleiben inaktiv.
  • Gefaltete Karten — Jede Projektkarte zeigt standardmäßig nur ihre Kategorie + Titel + Tool-Tags; die Zusammenfassung und die Metrikzeile erscheinen beim Darüberfahren / Fokussieren, sodass das Raster gut scanbar bleibt.
  • Chatbot (optional) — Ein schwebender Starter unten rechts + ein Pop-out-Panel (kein Inline-Bereich), unterstützt von DeepSeeks OpenAI-kompatibler API hinter einem Cloudflare-Worker, der den API-Schlüssel hält. Der Nutzer wählt den Namen des Bots; der Agent schlägt einen passenden Emoji-Avatar vor. Bot-Antworten rendern Markdown. Zweistufige Ratenbegrenzung.
  • Connect-Bereich — E-Mail + die sozialen URLs des Nutzers.

Voraussetzungen

Erforderlich fürWerkzeugInstallation
Allesgitnormalerweise bereits installiert
AllesGitHub-Konto + gh CLIbrew install gh dann gh auth login
Allespython3 (lokale Vorschau)normalerweise bereits installiert
ChatbotCloudflare-Konto (kostenlose Stufe)https://dash.cloudflare.com
Chatbotwrangler CLInpm install -g wrangler dann wrangler login
ChatbotDeepSeek API-Schlüsselhttps://platform.deepseek.com/ → API keys
Porträt-VerschiebungNode.jsbrew install node

Schritt-für-Schritt-Anleitung

1. Eingaben vom Nutzer sammeln

Führe dies aus, bevor du irgendwelche Dateien anfasst. Sammle alles auf einmal, damit spätere Schritte automatisierte Bearbeitungen sind. Mische AskUserQuestion für Multiple-Choice und direkte Aufforderungen für Freitext.

Hole jeden dieser Punkte vom Nutzer:

EingabeWie fragenBeispiel
GitHub-Benutzernamedirektjane (das Repository wird jane.github.io sein)
AnzeigenamedirektJane Doe oder Jane "JD" Doe
Standortangabedirekt, kurzBallungsraum NYC, Remote, Tokio
Slogandirekt, ein SatzIch baue ML-Systeme und liebe es, Dinge auszuliefern.
LebenslaufText einfügen oder Pfad zu einer Dateivollständiger Lebenslauf — wird verwendet, um Zeitleiste, Projektkarten und Chatbot-Wissen zu füllen
FotoPfad zu einem quadratischen Bild auf der Festplatte/Users/jane/Desktop/headshot.jpg. Der Nutzer kann es nach dem Klonen als raw.jpg im Repository-Stammverzeichnis ablegen.
Soziale URLsdirekt, jeweils optionalLinkedIn / GitHub-Profil / Medium / persönliche E-Mail
Chatbot?AskUserQuestionja / nein
Chatbot-Name (falls ja)direktPot, Nova, Echo, etc.
Visueller StilAskUserQuestion"Füge eine URL ein, die mir gefällt" ODER "Beschreibe es in Worten"

Nachdem du den Chatbot-Namen gesammelt hast, schlage 2–3 Emoji-Avatare vor, die thematisch passen, und lass den Nutzer auswählen. Beispiele:

NameVorgeschlagene Avatare
Pot🫖 (Teekanne) · 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

Wenn nichts Offensichtliches passt, biete Neutrale an: 🤖, 💬, 🪄. Speichere das ausgewählte Emoji + den Namen – du wirst sie später in den Code einfügen.

2. GitHub-Repository erstellen

gh repo create <benutzername>.github.io --public --description "Persönliche Website"

GitHub Pages-Benutzerseiten MÜSSEN unter <benutzername>.github.io liegen.

3. Vorlage klonen

git clone https://github.com/donotdonuts/donotdonuts.github.io meine-site
cd meine-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<benutzername>/<benutzername>.github.io.git

4. Einen visuellen Stil auswählen

Die Vorlage standardmäßig auf eine cremefarbene + IBM Plex Mono-Ästhetik. Überschreibe sie basierend auf der Antwort des Nutzers aus Schritt 1.

4a. Wenn der Nutzer eine URL angegeben hat

Hole das CSS der Seite und extrahiere die Tokens:

curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-pfad>" -o /tmp/ref-1.css

# tatsächlich auf body angewendete Schriftart
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# alle CSS-Custom-Property-Definitionen
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

Suche nach: Hintergrund-Hex, Vordergrund-/Text-Hex, Rahmen-Hex, Akzent-Hex, Schriftfamilie, die auf body angewendet wird, @font-face URLs.

4b. Wenn der Nutzer eine Beschreibung gegeben hat

Übersetze die Beschreibung in konkrete Tokens. Heuristiken:

WörterImplikation
"minimal", "redaktionell", "papier"Cremefarbener / gebrochen weißer Hintergrund, dunkle Schrift, dünne Trennlinien
"dunkel", "terminal", "IDE"Fast schwarzer Hintergrund (#0f1115), helle Schrift, dezente graue Rahmen
"warm", "analog"Leicht gelbliches Cremeweiß (#faf5e8), braunschwarze Schrift
"brutalistisch"Reines Weiß oder reines Schwarz, 2px+ durchgezogene Rahmen
"technisch", "daten"Monospace (IBM Plex Mono, JetBrains Mono), kühle Grautöne
"magazin", "redaktionell"Serife (EB Garamond, Fraunces), großzügiger Zeilenabstand
"verspielt"Ein gesättigter Akzent, ansonsten gedämpft

4c. Vorschlagen + anwenden

Stelle 13 Tokens + einen Schriftstapel zusammen. Zeige die vorgeschlagene Palette als Code-Block und hole die Genehmigung ein, bevor du Dateien bearbeitest.

:root {
  --bg:             <hex>;   /* Seitenhintergrund */
  --bg-soft:        <hex>;   /* Unterpanels — normalerweise --bg gemischt mit ~3% zu --ink */
  --bg-hover:       <hex>;   /* Tag-/Chip-Hover */
  --card-bg:        <hex>;   /* undurchsichtige Kartenfüllung (weiß, wenn helles Thema) */
  --ink:            <hex>;   /* primärer Text */
  --ink-soft:       <hex>;   /* ~80% von --ink */
  --ink-mute:       <hex>;   /* ~60% */
  --ink-faint:      <hex>;   /* ~40% */
  --border:         <hex>;   /* dezente Trennlinien */
  --border-strong:  <hex>;   /* tragende Trennlinien */
  --up:             <hex>;   /* positive Metriken (standardmäßig grünlich) */
  --down:           <hex>;   /* negative Metriken (standardmäßig rötlich) */
  --accent-ink:     <hex>;   /* Links */
  --font-mono:      "<Familie>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

Dann:

  1. Öffne css/styles.css, finde den :root-Block, ersetze die Werte.
  2. Öffne index.html, aktualisiere den Google Fonts <link> im <head> mit der neuen Schriftfamilie + den Gewichten.

5. Inhalt aus Lebenslauf + Eingaben generieren

Verwende den Lebenslauf und die anderen Eingaben aus Schritt 1, um index.html zu füllen:

  1. <head> — <title> = <Anzeigename> — <erste-Rolle-aus-Lebenslauf>; <meta name="description"> aus dem Slogan.

  2. Hero-Bereich:

    • <h1 class="hero-title"> ← Anzeigename
    • <p class="hero-location"> ← Standortangabe
    • <p class="hero-tagline"> ← Slogan
  3. Zeitleiste — Analysiere den Lebenslauf in Stationen. Ein <li class="tl-stop"> pro Rolle, pro Abschluss UND pro laufender persönlicher Nebenprojekt-Kategorie, die der Nutzer hervorheben möchte. Reihenfolge Gegenwart → Vergangenheit (oben nach unten im DOM). Wähle einen kurzen data-experience-Slug für jede (z.B. mars, vibe, coach, gatech) – danach filtert der Filter, um Stationen mit Karten zu verknüpfen. Füge tabindex="0" nur bei Stationen hinzu, die mindestens eine zugehörige Projektkarte haben (andere bleiben inaktiv).

    <li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0">
      <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe   (eines auswählen) -->
      <svg class="tl-icon tl-icon-work" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>Firma / Schule</strong>
        <span>Rolle / Abschluss</span>
        <em>Start — Ende</em>
        <i class="tl-loc">Stadt, Bundesland</i>
      </div>
    </li>
    

    Entferne tabindex="0" bei Bildungs-/Alt-Rollen-Stationen, die keine zugehörigen Projektkarten haben – js/main.js erkennt diese automatisch beim Laden und lässt sie nicht interaktiv.

  4. Projekte — ~sechs <article class="project-card">-Blöcke, generiert aus bemerkenswerten Projekten/Errungenschaften im Lebenslauf. Jede Karte MUSS einen data-experience-Slug tragen, der mit der Station übereinstimmt, aus der sie stammt, sonst nimmt sie nicht am Filter teil:

    <article class="project-card" data-experience="<slug>">
      <header class="project-head">
        <span class="project-tag">Kategorie</span>
        <h3>Projekttitel</h3>
      </header>
      <p>1–2 Sätze Zusammenfassung, aus dem Lebenslauf-Aufzählungspunkt gezogen.</p>
      <dl class="project-metrics">
        <div><dt>Metrik</dt><dd class="up">+wert</dd></div>
        <div><dt>Metrik</dt><dd>wert</dd></div>
      </dl>
      <ul class="tag-list small"><li>Werkzeug</li><li>Werkzeug</li></ul>
    </article>
    

    Verwende <dd class="up"> / <dd class="down">, um Metriken einzufärben. Karten werden standardmäßig gefaltet dargestellt – nur der Tag, der Titel und die Tool-Tags sind sichtbar, bis Hover / Fokus-innerhalb die Zusammenfassung + Metriken enthüllt. Halte Zusammenfassungen kurz; sie existieren nur, um einen Hover zu belohnen.

  5. Chat-Begrüßung — Die erste Nachricht des Bots ist Inline-HTML innerhalb von #chat-panel in index.html (innerhalb des <div class="chat-log"> des Panels), sodass sie sofort gerendert wird, wenn der Nutzer das Pop-out zum ersten Mal öffnet. Schreibe sie mit dem gewählten Bot-Namen + Avatar-Emoji um. Format:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<Bot-Name>">EMOJI</span>
      <div class="chat-bubble">
        <p>Hallo, ich bin <strong><Bot-Name></strong> — <Anzeigename>s KI-Assistent, <ge-verb> aus <seinem/ihrem> Lebenslauf.</p>
        <p>Frag mich nach:</p>
        <ul>
          <li>Unternehmen / Rollen</li>
          <li>Methoden / Ansätze</li>
          <li>Projekte / Fähigkeiten / Ausbildung</li>
        </ul>
        <p>Was möchtest du wissen?</p>
      </div>
    </div>
    
  6. Connect — E-Mail + jede angegebene soziale URL als <li> in .connect-list. Lösche Zeilen für jede nicht bereitgestellte Plattform.

6. Porträt hinzufügen

Frage, wo das Foto ist. Kopiere es in das Repository-Stammverzeichnis als raw.jpg, dann ändere die Größe:

cp <nutzer-foto-pfad> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

Wenn der Hintergrund des Fotos nicht zum neuen --bg passt, verschiebe ihn mit dem mitgelieferten Skript:

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <dieses-skill-verzeichnis>/scripts/shift-portrait.js \
  /pfad/zu/meine-site/raw.jpg \
  /pfad/zu/meine-site/assets/portrait.jpg \
  "#<dein-bg-hex>"

Standardmäßig auf #fbf7eb, wenn das dritte Argument weggelassen wird. raw.jpg ist in .gitignore.

7. Chatbot konfigurieren (überspringen, wenn der Nutzer nein gesagt hat)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

ALLOWED_ORIGIN = "https://<benutzername>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL          = "deepseek-chat"

worker/worker.js → SYSTEM_PROMPT — schreibe aus dem Lebenslauf des Nutzers um. Behalte die Abschnittsstruktur bei (Über / Aktuelle Rolle / Frühere Rollen / Ausbildung / Werkzeugkiste). Schreibe auch den einleitenden Persönlichkeitssatz mit dem Bot-Namen + Avatar um:

const SYSTEM_PROMPT = `Du bist "<Bot-Name>" <EMOJI> — ein freundlicher, präziser KI-Assistent, der auf <Anzeigename>s persönlicher Website eingebettet ist. …`;

Deploy:

wrangler deploy

7b. Client

js/config.js:

window.SITE_CONFIG = {
  chatWorkerUrl: "https://<worker>.workers.dev",
};

js/chatbot.js — aktualisiere die Konstanten am Anfang:

const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Bot-Name>";

8. Vorschau + Pushen

python3 -m http.server 8000       # http://localhost:8000

Klicke dich durch jeden Abschnitt. Teste den Chat. Ändere die Größe auf mobile Breite. Dann:

git add .
git commit -m "initial: persönliche Website"
git push -u origin main

Live unter https://<benutzername>.github.io/ innerhalb von ~60 Sekunden.

Vorlagenarchitektur (nicht ändern)

Abschnittslayout

Jeder Abschnitt verwendet .section-grid: 280px 1fr. Die 280px-Spalte passt für das längste Zeitleisten-Label. Verkleinere auf 240px, wenn alle Labels kurz sind, vergrößere auf 320px, wenn sie lang sind.

Zeitleiste

  • Befindet sich innerhalb des Projekt-section-head, direkt unter dem Titel, bei opacity: 0.45. Hover, Fokus oder ein aktiver Filter erhöht sie auf 0.95.
  • DOM-Reihenfolge = visuelle Reihenfolge von oben nach unten. Gegenwart → Vergangenheit. NICHT proportional zur Zeit – gleichmäßig verteilt über flex gap.
  • Drei Symbolarten sind standardmäßig verfügbar: #icon-wrench (Arbeit, .tl-stop-work), #icon-book (Bildung, .tl-stop-edu), #icon-sparkle (Vibe / Nebenprojekt, .tl-stop-vibe). Alle drei <symbol>-Definitionen leben im SVG-Sprite direkt nach <header>. Um eine neue Symbolkategorie hinzuzufügen:
    1. Füge ein <symbol id="icon-foo"> mit deinem SVG-Pfad hinzu
    2. Füge .tl-icon-foo { color: var(--ink-mute); } hinzu
    3. Referenziere mit <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
  • Jede Station trägt data-experience="<slug>"; Stationen, deren Slug mit mindestens einer Projektkarte übereinstimmt, erhalten auch tabindex="0", damit js/main.js sie filter-interaktiv machen kann.

Projektfilter (Klick + Hover)

Wird vollständig von js/main.js gesteuert, keine Konfiguration – es scannt das DOM beim Laden und verdrahtet Handler nur dort, wo sie zutreffen.

  • Beim Laden erhält jede Station, deren data-experience-Slug auf mindestens einer .project-card vorhanden ist, .tl-stop-has-projects + role="button" + aria-pressed="false". Stationen ohne zugehörige Karten bleiben inaktiv.
  • Hover / Fokus auf eine interaktive Station → temporärer Filter: nicht übereinstimmende Karten erhalten .is-dim (das Raster fügt .is-filtering hinzu, was CSS in display: none für abgedunkelte Karten übersetzt – sie werden aus dem Layout entfernt, nicht nur abgeblendet).
  • Klick (oder Enter / Leertaste) → fixieren: Station erhält .is-locked, volle Deckkraft, mit Tintenfarbe gefärbtes Symbol, unterstrichener Firmenname. Klicke dieselbe Station erneut, um sie zu löschen; klicke eine andere, um zu wechseln.
  • Während sie fixiert ist, zeigt das Darüberfahren einer anderen Station eine Vorschau ihrer Karten an; mouseleave auf der Schiene (oder focusout davon) stellt den vorherigen fixierten Filter wieder her oder löscht ihn, falls keiner fixiert war.

Verwandte Skills