Communitygithub.com

Portfolio Espoir · Jalon 3 — La Signature d'Espoir

Génère un dossier de portfolio autonome, hors ligne et à la marque, pour les demandeurs d'emploi, contenant un site statique, une page de partage et une vue CV, à utiliser pour les recrutements ou les présentations.

Qu'est-ce que Portfolio Espoir · Jalon 3 — La Signature d'Espoir ?

Cette compétence (skill) pour agents IA, nommée `oneconsciousness/job-hunt-with-hope`, transforme un dossier de carrière ou un entretien utilisateur en un portfolio professionnel complet, hors ligne, au format dossier. Elle est conçue pour être le fer de lance de l'assistant Hope, garantissant que le résultat final soit un artefact soigné, prêt à envoyer, qui suscite l'intérêt des recruteurs. Fonctionnant comme un plugin pour Claude, Cursor ou tout agent compatible, elle produit quatre fichiers clés (index.html, portfolio.css, portfolio.js, data.js) ainsi que des cartes de partage pour les réseaux sociaux, le tout dans un dossier `career-graph/documents/portfolios/`. Le fonctionnement est entièrement piloté par les données : l'agent génère un jeu de données structuré (`window.HOPE_DATA`) et le moteur d'exécution `portfolio.js` rend la page visible, sans aucune substitution dans le HTML statique. Le portfolio est construit à partir du graphe de carrière de l'utilisateur, en sélectionnant les expériences, compétences et projets les plus pertinents, en particulier lorsqu'un poste cible (JobPosting) est spécifié. La voix d'Espoir, définie par un guide vocal, interdit strictement d'inventer des faits : chaque affirmation doit être tracée jusqu'au fichier de carrière ou aux mots de l'utilisateur dans la conversation. Le résultat visuel est reconnaissable entre mille grâce à ses textures signatures (grille 32x32, motifs de balayage, badges hexagonaux, pastille LIVE) et ses thèmes clair/foncé. La compétence lit des fichiers de référence essentiels depuis le répertoire racine du plugin (design tokens, guide vocal, schéma du graphe de carrière, jalons) avant toute génération, garantissant une cohérence parfaite avec la marque Hope.

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

Demander à votre IA préférée

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

Documentation

Que fait Portfolio Espoir · Jalon 3 — La Signature d'Espoir ?

Vous exécutez la génération de portfolio d'Espoir. Cette compétence est ce qui définit Espoir. L'utilisateur soumet cet artefact et il reçoit des appels d'entretien. Faites en sorte que cela compte.

Localisez d'abord les fichiers du plugin (faites ceci avant toute autre chose)

Les documents de référence d'Espoir et le dossier de modèle de portfolio sont livrés à l'intérieur du plugin, pas dans le projet de l'utilisateur. Les chemins ci-dessous (references/…, assets/templates/…) sont relatifs à la racine du plugin — ils ne sont PAS relatifs à votre répertoire de travail (qui est le dossier du projet de l'utilisateur). ${CLAUDE_PLUGIN_ROOT} n'est pas substitué à l'intérieur de ce Markdown, vous devez donc résoudre vous-même la racine du plugin avec Bash, une fois, avant de lire quoi que ce soit :

# Résoudre la racine du plugin Espoir (references/, assets/, scripts/ s'y trouvent).
# $CLAUDE_PLUGIN_ROOT n'est PAS développé dans ce Markdown — résoudre dans Bash. Fonctionne
# qu'Espoir soit installé, mis en cache sur la marketplace, ou exécuté via --plugin-dir.
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"   # vérification de santé avant de lire les fichiers groupés

Si PLUGIN_ROOT revient vide, demandez à l'utilisateur où le plugin Espoir est extrait (par exemple un chemin --plugin-dir) plutôt que de deviner des chemins relatifs — une lecture relative references/… se résout par rapport au dossier du projet de l'utilisateur et échouera.

Lisez ces éléments avant de générer — ils sont essentiels. Les jetons de conception sont verrouillés ; les règles vocales s'appliquent à chaque mot du 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"

Ce que cette compétence produit

Un dossier de portfolio dans career-graph/documents/portfolios/portfolio-<slug>-<date>/ contenant exactement quatre fichiers nommés —

  • index.html — une coquille statique avec balisage SEO : le <head> (titre/description/OG/Twitter/JSON-LD enrichi/canonique/hope:share-url), l'initialisation de thème en ligne, un bloc .seo-fallback statique (nom/titre/résumé, supprimé à l'hydratation), la barre supérieure statique + la fenêtre modale d'exportation, et des points de montage vides. Il n'y a pas de balisage de contenu ici — le corps visible est rendu à l'exécution par portfolio.js à partir de window.HOPE_DATA. C'est le fichier dans lequel les valeurs SEO de l'en-tête et les métadonnées hope:share-url sont estampillées.
  • portfolio.css — la feuille de style complète ; les jetons de conception (:root) vivent ici et nulle part ailleurs (y compris les 15 jetons de niveau de segment / catégorie / intégrité — voir le canon des jetons de conception).
  • portfolio.js — le script de comportement complet et le moteur de rendu d'exécution complet — il construit l'intégralité du <body> visible à partir de window.HOPE_DATA.
  • data.js — un script classique définissant une variable globale, window.HOPE_DATA = {…} : l'ensemble de données complet pour toute la page (métadonnées + carte de confiance, identité, aperçu, expérience, projets, compétences, éducation, certifications, CV, chronologie, voyageur, social), dans des valeurs sémantiques uniquement — PAS de hex, avec la photo intégrée sous forme d'URL data:. Le data.js du modèle porte le contrat de rédaction champ par champ complet (le schéma window.HOPE_DATA) — lisez-le avant d'émettre, et traitez-le comme la source de vérité pour les types de champs et l'optionalité.

— plus deux pages de carte de partage (share-card.html et share-card-square.html) dans le même dossier — voir "Cartes de partage et métadonnées d'aperçu de lien" ci-dessous.

La promesse d'autonomie est au niveau du dossier : le dossier n'a besoin que d'un navigateur — entièrement capable hors ligne. (Ouverture : voir l'étape "montrez-le" — sur macOS, un serveur local en une ligne est le chemin fiable ; le double-clic fonctionne généralement mais peut être bloqué par les permissions du dossier.) C'est la loi — uniquement <script src> et <link rel="stylesheet"> classiques ; pas de type="module", pas de fetch(), pas de import. Aucun <style>/<script> en ligne dans index.html sauf l'extrait d'initialisation de thème (en ligne dans <head> par conception — il empêche le flash de thème) et le JSON-LD. Ce qui appartient à quel fichier est un canon — design-tokens.md § "Structure modulaire" (chargé ci-dessus) ; citez-le, ne le reformulez pas. La page utilise les jetons de conception d'Espoir — clair par défaut (crème chaude + orange), avec un thème sombre via le bouton de bascule et la même disposition pour les deux — génère des SVG en ligne pour tous les graphiques, et s'ouvre dans n'importe quel navigateur sans connexion réseau requise.

Ce qui se trouve à l'intérieur :

  • Carte d'identité — photo, nom, titre, ligne de statistiques, ligne de contact et résumé, sur une texture de grille 32×32, avec la pastille LIVE en haut à droite.
  • Le Fil conducteur (The Throughline) — la bande de chronologie de carrière animée en bas de la carte d'identité (id="throughline") : un nœud hexagonal par expérience / éducation / projet / certification inclus, un curseur de lecture glissant sur le rail, des mini-cartes au survol, cliquer pour naviguer vers la carte de chaque entrée. L'aspect et le mouvement de la bande appartiennent au modèle ; votre travail est l'ensemble de données et les ancres de carte — voir "Le Fil conducteur — contrat de données de la chronologie" ci-dessous.
  • Application Aperçu (opt-in) — un onglet de grille de sections, pas une bande autonome : une tuile de grille (data-section="overview", étiquetée "Aperçu", icône insights, méta-compte "{n} points forts") plus un volet (id="pane-overview") qui se place en premier parmi les volets et s'ouvre par défaut lorsqu'il est présent. À l'intérieur : jusqu'à 4 statistiques vedettes choisies sous forme de grands badges hexagonaux plus une ligne d'intérêts discrets. S'affiche uniquement lorsque overview.show est vrai et overview.headline_stats n'est pas vide — voir "Application Aperçu — mappage des champs" ci-dessous.
  • Résumé — 2 à 4 phrases dans la voix d'Espoir. Spécifique, pas générique. Fait allusion à une tension avant la résolution.
  • Expérience sélectionnée — 3 à 5 expériences les plus pertinentes sous forme de cartes, chacune avec : titre, entreprise, dates, une phrase de cadrage, la contribution la plus forte (STAR avec une métrique) et les compétences démontrées.
  • Projets sélectionnés — même forme que l'expérience, pour les projets dignes d'un portfolio en dehors de l'emploi formel.
  • Section Compétences — meilleures compétences (organisées par catégorie, en commençant par les plus demandées sur le marché qui ont les preuves les plus solides). Chaque puce de compétence cliquable pour développer les expériences/projets qui l'ont démontrée.
  • Formation / Certifications — court, factuel. Lorsqu'une entrée comporte des distinctions ou une réalisation digne d'être montrée qui vit dans le fichier de carrière (une bourse, un prix, une mention, une thèse notable), rendez-la sous forme de carte riche — voir "Cartes de formation et de certification riches" ci-dessous. Sinon, une carte .edu-card basique. N'inventez jamais de distinctions ; ne rendez que ce qui est là.
  • Contact — e-mail et LinkedIn, rien de plus. Facultatif.
  • Bascule de thème — bouton soleil/lune en haut à droite ; bascule clair/sombre, disposition inchangée.
  • Vue CV cachée — #resume-view, invisible à l'écran, rendue à l'exécution à partir de resume pour le chemin d'impression du CV (voir "Vue CV — mappage des champs" ci-dessous).
  • Contrôles d'exportation et de partage — le bouton Enregistrer au format PDF du modèle exporte le CV : un sélecteur (#export-modal) pour le style + la police + l'ajustement, avec un seuil de lisibilité strict — le texte du corps ne descend jamais en dessous de 10pt. Le sélecteur PDF du portfolio est réservé pour la prochaine version — la page en direct EST le portfolio, et Cmd+P l'imprime toujours de manière native. Partager ouvre un menu Copier le lien / LinkedIn / X / WhatsApp / Email (#share-menu). Ceux-ci sont livrés dans le modèle ; votre travail est le contenu dont ils dépendent (vue CV, métadonnées OG, cartes de partage).

Comment choisir ce qui va dedans

Lisez le graphe de carrière de l'utilisateur. Si un emploi cible est nommé (hope make portfolio for Anthropic), trouvez le nœud JobPosting et :

  1. Calculez quelles compétences l'emploi REQUIRES_SKILL et lesquelles la personne HAS_SKILL.
  2. Choisissez les expériences/projets dont les arêtes USED_SKILL et APPLIED_SKILL intersectent le plus fortement avec les compétences requises par l'emploi.
  3. Ordre : le plus pertinent d'abord, le plus récent ensuite, le plus riche en métriques en troisième.
  4. Visez la densité, pas l'exhaustivité. Trois cartes superbes battent sept cartes correctes.

Si aucun emploi cible n'est nommé, générez un portfolio général représentant le travail le plus fort de l'utilisateur dans l'ensemble.

Dans les deux cas, créez un nœud CuratedPortfolio dans le graphe liant aux expériences/compétences/projets inclus, et enregistrez sur celui-ci les décisions du catalogue d'applications de l'utilisateur sous forme de "show_summary": true|false et "show_social": true|false, et leur choix de voyageur sous forme de "timeline_traveler" (voir le catalogue d'applications et le sélecteur de voyageur ci-dessous — choix de présentation par portfolio, pas des faits sur la personne). Cela signifie que le graphe de l'utilisateur se souvient quelle curation a été envoyée pour quel rôle.

Voix dans la copie du portfolio

Espoir n'invente jamais un fait sur l'utilisateur. Chaque ligne que vous écrivez — une puce, une note, un plan, une affirmation — doit remonter au fichier de carrière ou aux propres mots de l'utilisateur dans ce chat ; une affirmation que vous ne pouvez pas sourcer est une affirmation que vous ne faites pas. C'est une promesse énoncée sur le site d'Espoir, et chaque compétence la tient.

Vous n'écrivez pas un CV. Vous écrivez une déclaration de travail design dans la voix d'Espoir.

Chaque carte d'expérience devrait :

  • S'ouvrir sur un moment ou un problème spécifique, pas un résumé de poste
  • Montrer ce qui a changé grâce à l'action de l'utilisateur (avec une métrique)
  • Éviter le langage "responsable de" — montrer, ne pas dire
  • Faire 60 à 120 mots par carte, pas plus

Exemple de transformation :

❌ "Senior Product Designer chez Figma. Responsable du système de design, mentorat des designers juniors, direction d'initiatives transversales."

✅ "Quand le système de design de Figma a commencé à se fragmenter entre les équipes produit en 2023, j'ai mené la consolidation. Huit mois plus tard, 37% de la surface de l'entreprise était unifiée sur le nouveau système, et le temps d'intégration des nouveaux designers est passé de trois semaines à une semaine. La partie difficile n'était pas les composants — c'était d'amener douze équipes produit à se mettre d'accord sur un seul bouton."

L'utilisateur peut éditer, mais la première ébauche doit donner l'impression qu'Espoir l'a écrite.

Barre de qualité visuelle

C'est le différenciateur visible. Le portfolio a un aspect indéniablement artefact Espoir — la disposition et la texture sont la marque, la couleur est le thème :

  • Thème clair par défaut (crème chaude + orange). Sombre via la bascule, même disposition.
  • Grille de sections interactive — cliquez sur une section pour filtrer le contenu en dessous ; l'onglet actif est orange uni avec une lueur et une barre d'intégrité.
  • Badges KPI hexagonaux (personne / groupes / supervision) sur chaque rôle.
  • Cartes de contribution regroupées IC vs Leadership ; compétences regroupées par catégorie avec un visuel de niveau à 4 barres ; les projets s'affichent comme les mêmes .item-cards de type Expérience extensibles (voir le contrat de boucle de projets ci-dessous) afin que l'histoire complète de chaque projet soit visible.
  • Pastille LIVE à l'intérieur de la ligne d'identité, en haut à droite.
  • Superposition de lignes de balayage sur les cartes + texture de grille 32×32 sur l'en-tête d'identité + lueurs subtiles. Ces textures sont des signatures — sans elles, le design semble générique.
  • Inter pour le texte, JetBrains Mono pour toutes les métadonnées. Material Symbols Rounded avec un repli SVG en ligne.
  • Vrais logos d'organisation via Google Favicon avec un repli de lettre.
  • Autonome au niveau du dossier (voir "Ce que cette compétence produit"). Aucun appel réseau requis sauf Google Fonts optionnel (qui se dégrade en polices système lorsqu'il est bloqué).

Utilisez le modèle fourni comme structure de départ — c'est un dossier miroir du dossier de sortie (les mêmes quatre fichiers nommés). Chargez-le à partir de la racine du plugin que vous avez résolue ci-dessus :

ls "$PLUGIN_ROOT/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html"  # la coquille statique : en-tête SEO, .seo-fallback, montures vides
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js"     # porte le contrat de rédaction window.HOPE_DATA

Contrat de construction (piloté par les données d'exécution)

Le portfolio n'est pas construit en substituant des jetons dans un balisage statique. L'agent émet un ensemble de données structuré et le portfolio.js fourni rend l'intégralité du <body> visible à partir de celui-ci à l'exécution. Il n'y a pas de jetons de contenu {{…}} ni de marqueurs <!-- HOPE:*_loop --> dans le nouveau modèle — ils ont été remplacés par window.HOPE_DATA. Suivez ces étapes dans l'ordre :

  1. Choisissez à partir du graphe (selon "Comment choisir ce qui va dedans" ci-dessous) : identité, aperçu, expérience (groupée IC/Leadership, forme de progression de rôle), projets, compétences (par catégorie, niveau 1–4 + années), formation, certifications, CV (puces avec une tag annexée ; Formation = diplômes uniquement), chronologie, social et une carte confidence par section.
  2. Émettez data.js = window.HOPE_DATA = {…} — UNE globale, l'ensemble de données complet pour toute la page (le contrat de rédaction data.js du modèle est le schéma window.HOPE_DATA). Valeurs sémantiques uniquement — PAS de hex (category:"programming", level:4, confidence.band:"high" — portfolio.js les résout en var(--token) au rendu). La photo est intégrée sous forme d'URL data: dans identity.photo.
  3. Copiez portfolio.css et portfolio.js dans le dossier de sortie textuellement. portfolio.css porte déjà les 15 jetons de niveau de segment / catégorie / intégrité que le moteur de rendu résout ; portfolio.js est le moteur de rendu d'exécution. Aucun des deux n'est jamais édité par portfolio. Ne déviez pas des jetons de conception dans $PLUGIN_ROOT/references/design-tokens.md (chargé ci-dessus).
  4. Estampillez la coquille index.html à partir de la même meta que vous mettez dans data.js, en un seul passage — data.js est la source de vérité unique et l'en-tête/le corps sont estampillés À PARTIR DE celui-ci :
    • En-tête : name/headline/og_description → <title> + description + og:*/twitter:* ; share_url → hope:share-url + <link rel="canonical"> ; generation_date + le JSON-LD ProfilePage enrichi (description/url/image/sameAs) ; target_company → suffixe du titre.
    • Corps : le bloc statique .seo-fallback — name / headline / summary_short.
    • Laissez og:url / og:image / twitter:image vides (content="") pour que la compétence de publication les estampille. Aucun {{…}} laissé nulle part.
  5. Générez les deux pages de carte de partage (`shar

…

[tronqué pour la traduction]

Skills associés