Communitygithub.com

Yukiniro/skills

Convertit les CV en sites web HTML animés et interactifs avec des styles visuels distinctifs. À utiliser lorsque l'utilisateur souhaite créer un CV web, convertir un CV en HTML, construire une page CV interactive ou générer un site CV personnel. Aide les non-designers à découvrir leur esthétique par l'exploration visuelle (« montrer, ne pas dire »). Prend en charge les formats PDF, DOCX, Markdown, texte brut, JSON Resume (jsonresume.org), la saisie directe de texte et l'amélioration de CV HTML existants.

Qu'est-ce que skills ?

Yukiniro/skills est une compétence avancée pour agents IA (compatible avec Claude Code, Cursor, etc.) qui permet de créer des pages de CV HTML riches en animations et sans dépendances. Elle guide l'utilisateur à travers un processus en quatre phases : extraction et structuration du contenu à partir de fichiers (PDF, DOCX, MD, TXT, JSON) ou de texte saisi, exploration visuelle pour choisir un style parmi des préréglages soigneusement conçus ou via des mini-aperçus générés dynamiquement, génération d'un fichier HTML unique auto-suffisant avec animations, navigation flottante, barres de compétences animées et styles d'impression, puis livraison du résultat. L'outil met l'accent sur une philosophie « zéro dépendance » (pas de npm ni de frameworks), un design distinctif évitant les esthétiques génériques « d'IA », l'accessibilité (WCAG AA, navigation clavier, animations réduites) et la compatibilité impression. Il est particulièrement utile pour les développeurs, designers et professionnels non techniques souhaitant obtenir un CV web de qualité sans compétences avancées en développement web.

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

Demander à votre IA préférée

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

Documentation

CV Frontend

Créez des pages de CV HTML riches en animations, sans dépendances, qui s'exécutent entièrement dans le navigateur. Aidez les utilisateurs à découvrir leur esthétique préférée par l'exploration visuelle, puis générez des CV interactifs de qualité production.

Philosophie Fondamentale

  1. Zéro dépendance — Fichiers HTML uniques avec CSS/JS intégrés. Pas de npm, pas d'outils de build.
  2. Montrer, Ne Pas Dire — Générez des aperçus visuels, laissez les utilisateurs choisir ce qu'ils aiment.
  3. Design Distinctif — Évitez les esthétiques génériques « d'IA ». Chaque CV doit sembler sur mesure.
  4. Prêt pour l'Impression — Chaque CV DOIT inclure des styles @media print pour un rendu PDF propre.
  5. Accessible — HTML sémantique, navigation clavier, prise en charge des mouvements réduits, contraste WCAG AA.

Phase 0 : Détection du Mode

Déterminez ce que l'utilisateur souhaite :

Mode A : Depuis un fichier — L'utilisateur fournit un fichier CV (.pdf, .docx, .md, .txt, .json) → Phase 1 Mode B : Depuis le texte — L'utilisateur fournit le contenu du CV sous forme de texte → Phase 1 Mode C : Amélioration — L'utilisateur a un CV HTML existant à améliorer → Lire le fichier, puis Phase 2


Phase 1 : Extraction & Structuration du Contenu

Étape 1.1 : Extraction du Fichier (Mode A uniquement)

Exécutez scripts/extract_resume.py sur le fichier CV de l'utilisateur :

python [chemin-compétence]/scripts/extract_resume.py <fichier_cv>

Formats pris en charge et dépendances :

FormatExtensionsDépendance PythonRemarques
PDF.pdfpdfplumber (recommandé) ou PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
Markdown.mdAucuneAnalyse les en-têtes, listes, gras/italique
Texte brut.txtAucuneLes lignes en MAJUSCULES sont interprétées comme des en-têtes
JSON Resume.jsonAucune (json intégré)Schéma jsonresume.org ; déjà structuré — peut sauter l'étape 1.2

Si une dépendance requise est manquante, le script imprime les instructions d'installation.

Présentez le contenu extrait à l'utilisateur pour confirmation. Pour les fichiers JSON Resume, les données sont déjà structurées — présentez directement les sections mappées et passez à l'étape 1.3 sauf si l'utilisateur souhaite ajuster.

Étape 1.2 : Structuration du Contenu

Analysez le texte brut en sections structurées :

  • header : nom, titre/accroche, localisation, contact (email, téléphone, LinkedIn, GitHub, portfolio)
  • about : résumé professionnel
  • experience[] : entreprise, rôle, dates, localisation, points
  • education[] : école, diplôme, dates, distinctions/Moyenne
  • skills{} : regroupées par catégorie avec niveaux de compétence optionnels (0-100)
  • projects[] : nom, description, stack technique, lien
  • certifications[] : nom, émetteur, date (optionnelle)
  • languages[] : langue, compétence (optionnelle)

Présentez le contenu structuré à l'utilisateur pour révision. Demandez : « Est-ce que cela semble correct ? Souhaitez-vous ajouter, supprimer ou modifier des sections ? »

Étape 1.3 : Priorité des Sections

Demandez via AskUserQuestion :

  • En-tête : « Mise en page »
  • Question : « Quelles sections devraient être les plus mises en avant ? »
  • Options :
    • « Expérience prioritaire » — L'historique professionnel est la vedette (professionnels seniors)
    • « Compétences en avant » — Les compétences techniques au premier plan (développeurs/ingénieurs)
    • « Projets en vedette » — Portfolio/projets en lumière (designers/freelances)
    • « Équilibré » — Poids égal pour toutes les sections

Phase 2 : Découverte du Style

Étape 2.0 : Choix du Chemin

Demandez : « Comment souhaitez-vous choisir le style de votre CV ? »

  • « Montre-moi des options » — Générez 3 aperçus visuels (recommandé) → Étape 2.1
  • « Je sais ce que je veux » — Choisissez directement dans une liste prédéfinie → Afficher le sélecteur de préréglages ci-dessous

Préréglages Disponibles :

PréréglageAmbianceIdéal pour
Midnight ArchitectSophistiqué, premiumCadres, consultants
Neon TerminalHacker-chic, développeurIngénieurs logiciels, DevOps
Dark LuxeÉlégant, éditorialDirecteurs créatifs, marketing
Cosmic DepthAudacieux, futuristeFondateurs tech, ingénieurs IA/ML
Clean SlateMinimaliste, inspiration suisseDesigners, chefs de produit
Paper CraftChaleureux, tactileÉcrivains, éducateurs, universitaires
Soft BlueprintTechnique, accessibleIngénieurs, data scientists
Brutalist MonoBrut, anti-designStratèges de marque, chercheurs d'originalité
Sage GardenInspiré de la nature, apaisantRH, bien-être, éducateurs
Retro InkÉditorial rétroJournalistes, marques personnelles

Si l'utilisateur choisit directement, passez à la Phase 3.

Étape 2.1 : Découverte Guidée

Question 1 — Ambiance (sélection multiple jusqu'à 2) :

  • « Professionnelle/Autoritaire » — Établie, digne de confiance
  • « Créative/Distinctive » — Unique, axée sur le design
  • « Moderne/Technique » — Propre, orientée développeur
  • « Chaleureuse/Approchable » — Amicale, agréable

Question 2 — Ton :

  • « Clair » — Propre, imprimable
  • « Sombre » — Audacieux, optimisé écran
  • « Peu importe » — Laissez le style décider

Étape 2.2 : Générer 3 Aperçus

En fonction de l'ambiance + du ton, sélectionnez 3 préréglages. Lisez references/STYLE_PRESETS.md pour les définitions complètes.

Correspondance ambiance-préréglage :

AmbianceSombreClairSpécialité
ProfessionnelleMidnight Architect, Dark LuxeClean Slate, Soft Blueprint—
CréativeDark Luxe, Cosmic DepthPaper CraftBrutalist Mono, Retro Ink
Moderne/TechniqueNeon Terminal, Cosmic DepthSoft BlueprintBrutalist Mono
ChaleureuseDark LuxePaper Craft, Sage GardenRetro Ink

Générez 3 mini aperçus HTML dans .claude-design/resume-previews/ :

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

Chaque aperçu : autonome (~80-120 lignes), montre la section héros + une entrée d'expérience + barres de compétences. Assez pour transmettre l'esthétique.

N'utilisez JAMAIS ces motifs génériques :

  • Inter, Roboto, Arial comme polices d'affichage
  • Dégradés violets sur fond blanc, indigo générique #6366f1
  • Tout centré sans variation
  • Vitromorphisme gratuit

Étape 2.3 : Choix

Présentez les aperçus, demandez à l'utilisateur d'en choisir un ou de mixer des éléments.


Phase 3 : Générer le CV

Lisez ces fichiers de référence pour le préréglage choisi :

  • references/STYLE_PRESETS.md — Variables CSS complètes, URLs de polices, palette de couleurs, style d'animation
  • references/RESUME_COMPONENTS.md — Modèles CSS/JS de composants interactifs
  • references/HTML_ARCHITECTURE.md — Modèle HTML de base, CSS obligatoire, architecture JS, styles d'impression, checklist d'accessibilité

Sortie

Générez un seul fichier HTML autonome :

  • Tout CSS en ligne dans <style>
  • Tout JS en ligne dans <script>
  • Google Fonts / Fontshare via <link> (dégradation gracieuse)
  • Structure HTML5 sémantique

Fonctionnalités Requises

  1. Révélations au défilement — Les éléments s'animent via IntersectionObserver
  2. Navigation flottante — Barre fixe avec suivi de la section active
  3. Barres de compétences animées — Se remplissent lors du défilement
  4. Barre de progression de défilement — Barre fine en haut
  5. Bouton retour en haut — Apparaît après défilement
  6. Feuille de style d'impression — @media print avec fond blanc, pas d'animations, URLs visibles
  7. Mouvements réduits — @media (prefers-reduced-motion: reduce) désactive les animations
  8. Responsive — Toutes les tailles utilisent clamp(), fonctionne du mobile au desktop

Checklist de Vérification

Avant la livraison, vérifiez :

  • Toute la typographie utilise clamp(min, préféré, max)
  • Tous les espacements utilisent clamp() ou des unités de viewport
  • HTML sémantique (<header>, <main>, <section>, <nav>)
  • Styles d'impression inclus et fonctionnels
  • Mouvements réduits respectés
  • Libellés ARIA sur navigation, boutons, barre de progression
  • Contraste des couleurs conforme WCAG AA
  • Liens externes avec target="_blank" rel="noopener"

Phase 4 : Livraison

  1. Nettoyage — Supprimez .claude-design/resume-previews/ s'il existe
  2. Ouverture — Lancez dans le navigateur : open [nomfichier].html
  3. Résumé :
Votre CV interactif est prêt !

Fichier : [nomfichier].html
Style : [Nom du Style]
Sections : [liste]

Fonctionnalités :
- Animations au défilement
- Barres de compétences animées
- Chronologie interactive
- Navigation flottante
- Prêt pour l'impression (Ctrl+P)
- Responsive sur toutes les tailles d'écran

Personnalisation :
- Couleurs : Modifiez les variables CSS :root en haut
- Polices : Changez le lien d'importation de police
- Animations : Modifiez les temporisations de la classe .reveal
- Contenu : Modifiez le texte directement dans le HTML

Souhaitez-vous que j'apporte des ajustements ?

Dépannage

L'extraction PDF renvoie peu de texte : Le PDF peut être basé sur une image (scanné). Demandez à l'utilisateur de fournir le contenu textuel directement.

L'extraction DOCX manque de structure : Certains fichiers DOCX n'utilisent pas les styles de titre standard (Titre 1/2/3). L'extracteur se rabat sur la taille de police des exécutions individuelles. Si la structure reste floue, demandez à l'utilisateur de confirmer quelles lignes sont des en-têtes de section.

Champs JSON Resume manquants : Le JSON peut omettre les sections optionnelles (projets, certificats, etc.). Présentez ce qui est disponible et demandez à l'utilisateur s'il souhaite ajouter manuellement les sections manquantes.

Interférence du frontmatter Markdown : Les délimiteurs de frontmatter YAML (---) sont ignorés automatiquement. Si le contenu du CV utilise lui-même --- comme lignes de séparation, elles seront également ignorées — cela est généralement sans danger.

Polices qui ne chargent pas : Vérifiez l'URL de la police. Assurez-vous que la déclaration font-family inclut un repli de police système.

Animations qui ne se déclenchent pas : Vérifiez que IntersectionObserver est initialisé. Vérifiez que la classe .visible est ajoutée.

Rendu d'impression incorrect : Assurez-vous que le bloc @media print existe. Vérifiez que les animations sont désactivées et que les fonds sont blancs.

Skills associés