Communitygithub.com

donotdonuts/claude-workflow-skills

Crée un site portfolio personnel à partir du template donotdonuts.github.io. Collecte le nom, la photo, le CV, les URL sociales et les préférences visuelles de l’utilisateur, puis génère la frise chronologique, les fiches projets et les connaissances du chatbot à partir du CV, en appliquant une palette de couleurs adaptée. Un chatbot DeepSeek optionnel est déployé via Cloudflare Worker. Publication statique sur GitHub Pages.

Qu'est-ce que claude-workflow-skills ?

Ce skill automatise la création d’un site portfolio statique et moderne, hébergé sur GitHub Pages, en partant d’un template éprouvé. Il guide l’utilisateur pas à pas : collecte des informations personnelles (nom, photo, CV, URL sociales, préférences de style visuel), génération dynamique d’une frise chronologique interactive des expériences et des fiches projets, et configuration optionnelle d’un chatbot basé sur DeepSeek, intégré via un Cloudflare Worker pour sécuriser la clé API. Le système propose également de personnaliser le thème visuel (couleurs, polices) à partir d’une URL de référence ou d’une description textuelle, garantissant un rendu unique pour chaque utilisateur. Le site final est déployé automatiquement sur GitHub Pages, prêt à être partagé. Ce workflow est idéal pour les développeurs souhaitant créer rapidement un portfolio professionnel sans réinventer la roue, avec une architecture claire et modulaire.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Configuration du site personnel

Accompagnez un nouvel utilisateur dans la création de son portfolio à l’adresse https://<son-nom-utilisateur>.github.io. L’architecture est fixe ; l’apparence, le contenu et le personnage du chatbot sont entièrement personnalisés pour l’utilisateur.

Ce qu’il obtient

  • Site statique d’une seule page, sans bundler. GitHub Pages sert main à la racine du dépôt.
  • Hero — son portrait + nom + une ligne de localisation + une ligne d’accroche.
  • Section Projets avec une frise chronologique verticale estompée dans l’en-tête de section (icônes de clé pour le travail, de livre pour les études, d’étincelle pour les projets annexes ; chaque étape montre l’entreprise, le rôle, la date, le lieu) et une grille de fiches projets dans le corps — le tout généré à partir du CV de l’utilisateur.
  • Filtre frise ↔ fiches — survolez ou mettez au clavier une étape de la frise pour masquer les fiches projets non liées ; cliquez pour verrouiller le filtre (recliquez pour effacer). Seules les étapes ayant au moins une fiche liée deviennent interactives ; les autres restent inertes.
  • Fiches pliables — chaque fiche projet n’affiche par défaut que sa catégorie + titre + étiquettes d’outils ; le résumé et la ligne de métriques apparaissent au survol/focus, ce qui rend la grille facile à parcourir.
  • Chatbot (optionnel) — un lanceur flottant en bas à droite + un panneau contextuel (pas une section de page en ligne) alimenté par l’API compatible OpenAI de DeepSeek derrière un Cloudflare Worker qui détient la clé API. L’utilisateur choisit le nom du bot ; l’agent propose un avatar emoji correspondant. Les réponses du bot interprètent le Markdown. Limitation de débit à deux niveaux.
  • Section Contact — email + les URL sociales de l’utilisateur.

Prérequis

Nécessaire pourOutilInstallation
Toutgitgénéralement déjà installé
ToutCompte GitHub + CLI ghbrew install gh puis gh auth login
Toutpython3 (aperçu local)généralement déjà installé
ChatbotCompte Cloudflare (gratuit)https://dash.cloudflare.com
ChatbotCLI wranglernpm install -g wrangler puis wrangler login
ChatbotClé API DeepSeekhttps://platform.deepseek.com/ → API keys
Changement de portraitNode.jsbrew install node

Étapes

1. Recueillir les entrées de l’utilisateur

Faites ceci avant de toucher aux fichiers. Rassemblez tout en une fois pour que les étapes suivantes soient des modifications automatisées. Mélangez AskUserQuestion pour les choix multiples et les invites directes pour le texte libre.

Récupérez chacun de ces éléments auprès de l’utilisateur :

EntréeComment demanderExemple
Nom d’utilisateur GitHubdirectjane (le dépôt sera jane.github.io)
Nom affichédirectJane Doe ou Jane "JD" Doe
Phrase de localisationdirecte, courteRégion parisienne, À distance, Tokyo
Accrochedirecte, une phraseJe construis des systèmes de ML et j’adore livrer.
CVcoller du texte ou chemin d’un fichierCV complet — utilisé pour peupler la frise, les fiches projets, les connaissances du chatbot
Photochemin d’une image carrée sur le disque/Users/jane/Desktop/portrait.jpg. L’utilisateur peut la déposer à la racine du dépôt en tant que raw.jpg après le clonage.
URL socialesdirectes, chacune facultativeProfil LinkedIn / GitHub / Medium / email personnel
Chatbot ?AskUserQuestionoui / non
Nom du chatbot (si oui)directPot, Nova, Echo, etc.
Style visuelAskUserQuestion"Collez une URL que j’aime" OU "Décrivez-le avec des mots"

Après avoir collecté le nom du chatbot, proposez 2–3 avatars emoji qui correspondent thématiquement et laissez l’utilisateur choisir. Exemples :

NomAvatars proposés
Pot🫖 (théière) · 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

Si rien d’évident ne correspond, proposez des neutres : 🤖, 💬, 🪄. Stockez l’emoji + le nom choisis — vous les écrirez dans le code plus tard.

2. Créer le dépôt GitHub

gh repo create <nom-utilisateur>.github.io --public --description "Site personnel"

Les sites utilisateurs GitHub Pages DOIVENT être à <nom-utilisateur>.github.io.

3. Cloner le template

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

4. Choisir un style visuel

Le template a par défaut une esthétique crème + IBM Plex Mono. Remplacez-la en fonction de la réponse de l’utilisateur de l’étape 1.

4a. Si l’utilisateur a donné une URL

Récupérez le CSS de la page et extrayez les tokens :

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

# police réellement appliquée au body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# toutes les définitions de propriétés personnalisées CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

Cherchez : hex d’arrière-plan, hex de premier plan/encre, hex de bordure, hex d’accentuation, police appliquée au body, URL @font-face.

4b. Si l’utilisateur a donné une description

Traduisez la description en tokens concrets. Heuristiques :

MotsImplication
"minimal", "éditorial", "papier"Fond crème/blanc cassé, encre foncée, séparateurs fins
"sombre", "terminal", "IDE"Fond quasi noir (#0f1115), encre claire, bordures grises subtiles
"chaud", "analogique"Crème légèrement jaune (#faf5e8), encre brun-noir
"brutaliste"Blanc pur ou noir pur, bordures pleines de 2px+
"technique", "données"Monospace (IBM Plex Mono, JetBrains Mono), gris froids
"magazine", "éditorial"Serif (EB Garamond, Fraunces), interlignage généreux
"ludique"Une accentuation saturée, sinon atténuée

4c. Proposer + appliquer

Compilez 13 tokens + une pile de polices. Montrez la palette proposée sous forme de bloc de code et obtenez l’approbation avant de modifier les fichiers.

:root {
  --bg:             <hex>;   /* arrière-plan de la page */
  --bg-soft:        <hex>;   /* sous-panneaux — généralement --bg mélangé à ~3% de --ink */
  --bg-hover:       <hex>;   /* survol d’étiquette/chip */
  --card-bg:        <hex>;   /* remplissage opaque des fiches (blanc si thème clair) */
  --ink:            <hex>;   /* texte principal */
  --ink-soft:       <hex>;   /* ~80% de --ink */
  --ink-mute:       <hex>;   /* ~60% */
  --ink-faint:      <hex>;   /* ~40% */
  --border:         <hex>;   /* séparateurs subtils */
  --border-strong:  <hex>;   /* séparateurs porteurs */
  --up:             <hex>;   /* métriques positives (verdâtre par défaut) */
  --down:           <hex>;   /* métriques négatives (rougeâtre par défaut) */
  --accent-ink:     <hex>;   /* liens */
  --font-mono:      "<Famille>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

Ensuite :

  1. Ouvrez css/styles.css, trouvez le bloc :root, remplacez les valeurs.
  2. Ouvrez index.html, mettez à jour le <link> Google Fonts dans <head> avec la nouvelle famille de polices + poids.

5. Générer le contenu à partir du CV + entrées

Utilisez le CV et les autres entrées de l’étape 1 pour remplir index.html :

  1. <head> — <title> = <Nom affiché> — <premier-rôle-du-CV> ; <meta name="description"> à partir de l’accroche.

  2. Hero :

    • <h1 class="hero-title"> ← nom affiché
    • <p class="hero-location"> ← phrase de localisation
    • <p class="hero-tagline"> ← accroche
  3. Frise chronologique — analysez le CV en étapes. Un <li class="tl-stop"> par rôle, par diplôme, ET par catégorie de projet personnel en cours que l’utilisateur souhaite mettre en avant. Ordre présent → plus ancien (haut en bas dans le DOM). Choisissez un slug court data-experience pour chacun (par exemple mars, vibe, coach, gatech) — c’est ce que le filtre utilise pour lier les étapes aux fiches. Ajoutez tabindex="0" uniquement sur les étapes qui ont au moins une fiche projet liée (les autres restent inertes).

    <li class="tl-stop tl-stop-travail" data-experience="<slug>" tabindex="0">
      <!-- tl-stop-travail | tl-stop-edu | tl-stop-vibe   (choisissez un) -->
      <svg class="tl-icon tl-icon-travail" aria-hidden="true">
        <use href="#icon-cle"/>       <!-- #icon-cle | #icon-livre | #icon-eticelle -->
      </svg>
      <div class="tl-info">
        <strong>Entreprise / École</strong>
        <span>Rôle / Diplôme</span>
        <em>Début — Fin</em>
        <i class="tl-loc">Ville, État</i>
      </div>
    </li>
    

    Supprimez tabindex="0" sur les étapes d’études/anciens rôles qui n’ont pas de fiches projets liées — js/main.js les détecte automatiquement au chargement et les laisse non interactives.

  4. Projets — environ six blocs <article class="project-card">, générés à partir des projets/réalisations notables du CV. Chaque fiche DOIT porter un slug data-experience correspondant à l’étape dont elle provient, sinon elle ne participera pas au filtre :

    <article class="project-card" data-experience="<slug>">
      <header class="project-head">
        <span class="project-tag">Catégorie</span>
        <h3>Titre du projet</h3>
      </header>
      <p>Résumé en 1–2 phrases tiré de la puce du CV.</p>
      <dl class="project-metrics">
        <div><dt>Métrique</dt><dd class="up">+valeur</dd></div>
        <div><dt>Métrique</dt><dd>valeur</dd></div>
      </dl>
      <ul class="tag-list small"><li>Outil</li><li>Outil</li></ul>
    </article>
    

    Utilisez <dd class="up"> / <dd class="down"> pour colorer les métriques. Les fiches s’affichent plissées par défaut — seuls la balise, le titre et les étiquettes d’outils sont visibles jusqu’au survol/focus-within qui révèle le résumé + les métriques. Gardez les résumés concis ; ils n’existent que pour récompenser un survol.

  5. Message d’accueil du chat — le message d’ouverture du bot est du HTML en ligne à l’intérieur de #chat-panel dans index.html (dans le <div class="chat-log"> du panneau), donc il s’affiche instantanément lorsque l’utilisateur ouvre le panneau contextuel pour la première fois. Réécrivez-le en utilisant le nom du bot choisi + l’avatar emoji. Format :

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<Nom du Bot>">EMOJI</span>
      <div class="chat-bubble">
        <p>Bonjour, je suis <strong><Nom du Bot></strong> — l’assistant IA de <Nom affiché>, <verbe> à partir de son CV.</p>
        <p>Demandez-moi :</p>
        <ul>
          <li>Entreprises / rôles</li>
          <li>Méthodes / approches</li>
          <li>Projets / compétences / formation</li>
        </ul>
        <p>Que souhaitez-vous savoir ?</p>
      </div>
    </div>
    
  6. Contact — email + chaque URL sociale fournie en tant que <li> dans .connect-list. Supprimez les lignes pour toute plateforme non fournie.

6. Ajouter le portrait

Demandez où se trouve sa photo. Copiez-la à la racine du dépôt en tant que raw.jpg, puis redimensionnez :

cp <chemin-photo-utilisateur> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

Si le fond de la photo ne correspond pas au nouveau --bg, changez-le avec le script fourni :

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <chemin-dossier-skill>/scripts/shift-portrait.js \
  /path/to/mon-site/raw.jpg \
  /path/to/mon-site/assets/portrait.jpg \
  "#<votre-hex-bg>"

Par défaut à #fbf7eb si le troisième argument est omis. raw.jpg est dans .gitignore.

7. Configurer le chatbot (ignorer si l’utilisateur a dit non)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml :

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

worker/worker.js → SYSTEM_PROMPT — réécrivez à partir du CV de l’utilisateur. Conservez la structure des sections (À propos / Rôle actuel / Rôles passés / Formation / Boîte à outils). Réécrivez également la phrase d’ouverture du personnage en utilisant le nom du bot + l’avatar :

const SYSTEM_PROMPT = `Vous êtes "<Nom du Bot>" <EMOJI> — un assistant IA amical et concis intégré sur le site personnel de <Nom affiché>. …`;

Déployez :

wrangler deploy

7b. Client

js/config.js :

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

js/chatbot.js — mettez à jour les constantes en haut :

const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nom du Bot>";

8. Aperçu + publication

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

Parcourez chaque section. Testez le chat. Redimensionnez à la largeur mobile. Ensuite :

git add .
git commit -m "initial : site personnel"
git push -u origin main

En ligne à https://<nom-utilisateur>.github.io/ en moins de 60 secondes.

Architecture du template (ne pas modifier)

Mise en page des sections

Chaque section utilise .section-grid: 280px 1fr. La colonne de 280px correspond à la plus longue étiquette de la frise. Réduisez à 240px si toutes les étiquettes sont courtes, élargissez à 320px si longues.

Frise chronologique

  • Se trouve dans l’en-tête de section Projets section-head, juste en dessous du titre, à opacity: 0.45. Le survol, le focus ou un filtre actif la fait passer à 0,95.
  • L’ordre dans le DOM = ordre visuel du haut vers le bas. Présent → plus ancien. PAS proportionnel au temps — réparti uniformément via gap flex.
  • Trois types d’icônes prêts à l’emploi : #icon-cle (travail, .tl-stop-travail), #icon-livre (éducation, .tl-stop-edu), #icon-eticelle (vibe / projet annexe, .tl-stop-vibe). Les trois définitions <symbol> se trouvent dans le sprite SVG juste après <header>. Pour ajouter une nouvelle catégorie d’icône :
    1. Ajoutez un <symbol id="icon-foo"> avec votre chemin SVG
    2. Ajoutez .tl-icon-foo { color: var(--ink-mute); }
    3. Référencez avec <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
  • Chaque étape porte data-experience="<slug>" ; les étapes dont le slug correspond à au moins une fiche projet reçoivent également tabindex="0" pour que js/main.js puisse les rendre interactives pour le filtre.

Filtre de projet (clic + survol)

Entièrement piloté par js/main.js, zéro configuration — il analyse le DOM au chargement et branche les gestionnaires uniquement là où ils s’appliquent.

  • Au chargement, chaque étape dont le slug data-experience est présent sur au moins une .project-card reçoit .tl-stop-a-projets + role="button" + aria-pressed="false". Les étapes sans fiches liées restent inertes.
  • Survol / focus d’une étape interactive → filtre temporaire : les fiches non correspondantes deviennent .is-dim (la grille ajoute .is-filtering, que CSS traduit en display: none sur les fiches atténuées — elles sont retirées de la mise en page, pas seulement estompées).
  • Clic (ou Entrée / Espace) → verrouillage : l’étape reçoit .is-locked, opacité totale, icône colorée à l’encre, nom d’entreprise souligné. Recliquez sur la même étape pour effacer ; cliquez sur une autre pour changer.
  • Pendant le verrouillage, survoler une autre étape prévisualise ses fiches ; mouseleave sur la bande (ou focusout hors de celle-ci) ramène au filtre verrouillé.

Chatbot

  • Le panneau contextuel est un <aside> fixe en bas à droite. Le bouton de lancement est un <button> rond avec l’icône du chat.
  • Le composant chatbot.js est entièrement autonome — il crée le panneau DOM et le bouton de lancement lors de l’initialisation si window.SITE_CONFIG.chatWorkerUrl est défini.
  • Limitation de débit : 10 requêtes par minute par adresse IP (appliquée côté Worker) ; 20 messages cumulés par session dans le client — au-delà, le bouton d’envoi est désactivé avec un message « Limite de session atteinte ».
  • Toutes les réponses du bot sont rendues en Markdown via marked (chargé à partir d’un CDN).

Couleurs et thème

Le bloc :root dans css/styles.css est le seul endroit qui contrôle les couleurs. Ne dupliquez pas les variables de couleur ailleurs. Si une règle CSS a besoin d’une nuance, utilisez color-mix() ou rgba() avec les tokens racine.

Responsive

/* la grille devient verticale en dessous de 720px */
@media (max-width: 720px) {
  .section-grid { grid-template-columns: 1fr; }
  .section-head   { margin-bottom: 0; }
}

Ne personnalisez pas davantage — le template gère le reste.

Gestion des erreurs

ProblèmeCause probableCorrectif
La frise ne filtre pasdata-experience mal écrit sur une fiche ou une étapeVérifiez la correspondance des slugs ; ils doivent être identiques
Le chat ne répond pasL’URL du Worker dans js/config.js est incorrecteRemplacez-la par l’URL réelle après wrangler deploy
Le portrait n’a pas la bonne couleur de fondLe script n’a pas été appelé, ou le code hex n’est pas celui de --bgRelancez shift-portrait.js avec le bon hex
GitHub Pages 404Le dépôt ne s’appelle pas <nom-utilisateur>.github.ioRenommez le dépôt sur GitHub

Liste de vérification finale

  • La frise est dans l’ordre (présent → plus ancien)
  • Chaque étape avec au moins une fiche a tabindex="0"
  • Les fiches projets utilisent les bons slugs data-experience
  • Le message d’accueil du chatbot utilise le nom et l’emoji choisis
  • js/config.js pointe vers le Worker déployé
  • Le portrait a été redimensionné à 720px et le fond changé
  • Le site s’affiche correctement sur mobile (720px et moins)
  • Le commit initial a été poussé sur main

Skills associés