SKILL.md — Constructeur de Portfolio
Créez un portfolio personnel qui vous rend inoubliable. Soutenu par plus de 67 styles d'interface, 161 palettes de couleurs, 57 associations de polices et des motifs spécifiques aux portfolios. Pipeline : comprendre → identité de marque → contenu → construire → déployer.
Aperçu
Un portfolio n'a qu'un seul objectif : donner envie à quelqu'un de travailler avec vous. Tout — le design, le texte, la sélection des projets, les interactions — sert cet objectif.
Pipeline (5 phases) :
Phase 0 — Comprendre → Qui êtes-vous ? Que faites-vous ? Qui regarde ceci ?
Phase 1 — Concevoir → Identité visuelle : style, palette, polices — « l'ambiance » de votre travail
Phase 2 — Contenu → Bio, descriptions de projets, compétences, contact
Phase 3 — Construire → HTML/CSS + grille de projets interactive + animations
Phase 4 — Livrer → Aperçu en direct → Déploiement sur Vercel
Types de Portfolio
| Type | Public | Focus |
|---|---|---|
| Designer | Clients, recruteurs | Travail visuel, études de cas, processus |
| Développeur | Recruteurs, clients, collaborateurs | Projets, stack technique, GitHub |
| Créatif (photographe/illustrateur/etc.) | Clients, galeries | Imagerie plein écran, texte minimal |
| Freelance | Clients potentiels | Services, travaux antérieurs, contact/appel à l'action |
| Étudiant / Reconversion | Recruteurs, responsables RH | Projets, compétences, trajectoire narrative |
Stack Technique
Par défaut : HTML + CSS + Vanilla JS — identique à la page d'atterrissage. Aucun framework nécessaire.
- Le plus rapide à construire et déployer
- Zéro dépendance, contrôle maximal sur les animations
- Vercel déploie les fichiers statiques instantanément
Structure des Fichiers
portfolio/
├── index.html # Page principale (monopage ou navigation par ancres)
├── styles.css # Design tokens → reset → mise en page → composants → sections → animations
├── main.js # Filtre, lightbox, effets de défilement, navigation mobile
├── assets/
│ ├── images/ # Captures d'écran de projets, avatar, image OG
│ └── fonts/ # Polices auto-hébergées (optionnel)
└── README.md
Phase 0 — Comprendre
0.1 Questions Clés
| Question | Pourquoi c'est important |
|---|---|
| Que faites-vous ? | Designer / développeur / photographe / freelance / étudiant / hybride |
| Qui va visiter ce site ? | Recruteurs, clients, collaborateurs, conservateurs de galeries |
| Quel est l'objectif n°1 ? | Être embauché / obtenir des clients freelance / intégrer un programme / juste avoir une présence en ligne |
| Combien de projets montrer ? | 3 à 6 est idéal ; la qualité plutôt que la quantité |
| Avez-vous déjà une marque ? | Couleurs, polices, logo existants — ou on part de zéro |
| Ton ? | Minimal, audacieux, sombre, ludique, éditorial, technique, luxueux |
| Des portfolios de référence ? | Sites que vous aimez ou dont vous voulez vous différencier |
0.2 Cartographie des Archétypes de Portfolio
| Archétype | Sections Clés | Priorité Visuelle |
|---|---|---|
| Designer | Hero + Travaux sélectionnés (études de cas) + À propos + Compétences + Contact | Détail des études de cas, photos de processus |
| Développeur | Hero + Projets (liens en direct + GitHub) + Compétences/Stack + À propos + Contact | Extraits de code, démos en direct, stats GitHub |
| Créatif | Hero plein écran + Galerie/Grille + À propos + Contact | L'imagerie domine, chrome UI minimal |
| Freelance | Hero + Services + Travaux + Témoignages + Contact | Proéminence de l'appel à l'action, signaux de confiance |
| Étudiant | Hero + Projets + Compétences + À propos + Contact | Trajectoire narrative — croissance et potentiel |
Phase 1 — Recherche de Design
1.1 La Base de Données de Design
# Recherche de style
python3 src/ui-ux-pro-max/scripts/search.py "<requête>" --domain style --max-results 5
# Palette de couleurs
python3 src/ui-ux-pro-max/scripts/search.py "<humeur/industrie>" --domain color --max-results 5
# Typographie
python3 src/ui-ux-pro-max/scripts/search.py "<style/humeur>" --domain typography --max-results 3
# Motifs spécifiques aux portfolios
python3 src/ui-ux-pro-max/scripts/search.py "portfolio" --domain landing --max-results 5
# Règles de type de produit pour les sites personnels
python3 src/ui-ux-pro-max/scripts/search.py "portfolio personal site" --domain product
# Système de design complet
python3 src/ui-ux-pro-max/scripts/search.py "<requête>" --design-system -p "Portfolio"
# Extraits spécifiques au stack
python3 src/ui-ux-pro-max/scripts/search.py "<requête>" --stack html
1.2 Principes Esthétiques Spécifiques aux Portfolios
Un portfolio EST le travail de design. S'il a l'air générique, le visiteur suppose que le travail est générique.
| ❌ Générique (à éviter) | ✅ Distinctif (viser) |
|---|---|
| Fond blanc, police Inter, texte gris | Une palette qui exprime la personnalité |
| « Bonjour, je suis [Nom]. Je suis designer. » hero | Une phrase d'accroche qui crée l'intrigue |
| Grille de cartes à 3 colonnes avec espacement identique | Une mise en page qui reflète le caractère du travail |
| Hover : opacité 0.8 | Hover : révèle les infos du projet avec personnalité |
| Pied de page : « © 2024 Nom. Tous droits réservés. » | Un pied de page qui prolonge la marque |
1.3 Stratégie de Couleur pour les Portfolios
Contrairement aux pages d'atterrissage (où l'accent = appel à l'action), les couleurs du portfolio expriment la personnalité :
| Persona | Direction de Palette |
|---|---|
| Designer minimaliste | Blanc cassé + 1 accent fort, grand espace blanc |
| Créatif audacieux | Fond sombre + accent vif, contraste élevé |
| Développeur technique | Esthétique sombre/terminal OU clair et propre avec accents inspirés du code |
| Freelance chaleureux | Teintes terreuses, accessible, humain |
| Luxe/premium | Neutres profonds + or/champagne, typographie raffinée |
1.4 Brief de Design pour les Portfolios
## Brief de Design du Portfolio : <Nom>
### Identité
- **Qui :** <nom + rôle>
- **Archétype :** <designer / développeur / créatif / freelance / étudiant>
- **Objectif du portfolio :** <être embauché / obtenir des clients / juste avoir une présence>
- **Visiteur cible :** <recruteurs / clients / collaborateurs>
### Personnalité (choisir 3 adjectifs)
- <ex. : précis, chaleureux, audacieux>
### Orientation du Style
- **Style principal :** <issu de la recherche — ex. : « Éditorial Sombre », « Minimalisme Doux »>
- **Esthétique en un mot :** <ex. : « concentré », « expressif », « technique »>
- **Pourquoi ce style correspond au travail :** <une phrase>
### Palette de Couleurs
- **Arrière-plan :** <hex> — <nom>
- **Arrière-plan secondaire :** <hex> — pour les cartes/panneaux
- **Texte principal :** <hex>
- **Texte atténué :** <hex>
- **Accent :** <hex> — utilisé avec parcimonie, impact maximal
- **Bordure/séparateur :** <hex>
### Typographie
- **Police des titres :** <nom> + poids + URL Google Fonts
- **Police du corps :** <nom> + URL Google Fonts
- **Note sur le style des titres :** <ex. : « crénage serré, fort contraste d'échelle »>
### Motif de Mise en Page
- **Grille :** <ex. : 2 colonnes asymétriques, maçonnerie, rangée plein écran>
- **Style de carte de projet :** <ex. : image d'abord avec superposition au hover, carte de texte minimal>
- **Transitions de sections :** <ex. : séparateurs pleine largeur, entrée décalée, aucun>
### Interactions
- **Survol de carte de projet :** <ex. : échelle + superposition avec titre/étiquettes>
- **Animations de défilement :** <ex. : apparition décalée vers le haut sur la grille de travaux>
- **Curseur :** <par défaut / point personnalisé / aucun>
1.5 Critères de Qualité
- Archétype identifié, objectif principal clair
- 3+ options de style recherchées avant de décider
- La palette exprime la personnalité (pas seulement les valeurs par défaut « propres »)
- L'association de polices a du contraste — une d'affichage, une de corps
- Le motif de mise en page correspond au type de travail (photographie ≠ projets de code)
- L'utilisateur a approuvé le Brief de Design
Phase 2 — Contenu
2.1 Texte du Hero
La phrase d'accroche du hero est le texte le plus important de la page. Elle doit répondre : qui êtes-vous, que faites-vous, et pourquoi est-ce important — avec personnalité.
Options de formules :
| Formule | Exemple |
|---|---|
| Rôle + différenciateur | « Designer produit qui obsède sur les moments de 0,1 seconde » |
| Axé sur le résultat | « Je rends les logiciels complexes simples à utiliser » |
| Déclaration audacieuse | « Un bon design est invisible. Un grand design est inévitable. » |
| Ludique/direct | « Je construis des trucs pour le web. Actuellement ouvert aux opportunités. » |
| Nom + descripteur | « Bonjour, je suis Maya — je conçois pour les humains, pas pour les écrans » |
À éviter :
- « Je suis un designer passionné avec 5 ans d'expérience »
- « Bienvenue sur mon portfolio »
- Adjectifs génériques : créatif, innovant, dévoué, passionné
2.2 Descriptions de Projets
Chaque entrée de projet doit inclure :
### <Nom du Projet>
**Rôle :** <votre rôle — ex. : « Designer Principal », « Développeur Solo »>
**Type :** <ex. : « Application Mobile », « Identité de Marque », « Application Web »>
**Tags :** [<étiquettes tech/compétence>]
**Le défi :** <1-2 phrases — quel problème devait être résolu>
**Ce que j'ai fait :** <2-3 phrases — votre contribution spécifique et vos décisions>
**Le résultat :** <1 phrase avec un résultat si possible — « Réduction du temps d'intégration de 40 % »>
[En direct →](<url>) [Étude de cas →](<url>) [GitHub →](<url>)
Règles :
- Commencez par le PROBLÈME, pas la technologie
- Votre RÔLE doit être spécifique — « designer » n'est pas un rôle, « a conçu le flux d'intégration » l'est
- Si vous avez des métriques, utilisez-les. Sinon, décrivez le résultat qualitatif
- 3 à 6 projets maximum — sélectionnez sans pitié
2.3 Section À Propos
Structure :
- Qui vous êtes — état actuel (rôle, lieu, ce sur quoi vous vous concentrez)
- Comment vous en êtes arrivé là — bref parcours (pas un CV, une histoire)
- Ce qui vous tient à cœur — le « pourquoi » derrière le travail
- Ce que vous cherchez — ouvert aux opportunités / types de projets spécifiques / collaborations
Longueur : 80-150 mots. Pas une bio, pas un CV. Une personne.
2.4 Section Compétences / Stack
Pour les designers :
Design : Figma, Prototypage, Systèmes de Design, Typographie, Motion
Recherche : Entretiens Utilisateurs, Tests d'Utilisabilité, Analyse Concurrentielle
Pour les développeurs :
Frontend : React, TypeScript, Next.js, CSS/Tailwind
Backend : Node.js, PostgreSQL, REST/GraphQL
Outils : Git, Docker, Vercel, Figma
Affichez sous forme de nuages de tags, grilles d'icônes ou listes groupées — jamais une simple liste à puces.
2.5 Section Contact
Restez extrêmement simple :
- Email (le plus important — rendez-le cliquable avec
mailto:) - 2-3 liens sociaux (GitHub, LinkedIn, Twitter/X, Dribbble — choisissez ce qui est pertinent)
- Optionnel : une courte ligne « actuellement disponible pour... »
- Optionnel : un simple formulaire de contact (Formspree)
Pas de formulaires de contact avec 6 champs. Pas de remplissage « prenons un café ».
2.6 Critères de Qualité
- La phrase d'accroche du hero a de la personnalité (pas générique)
- Chaque projet commence par le problème, pas la technologie
- Les rôles sont spécifiques, pas seulement des titres de poste
- La section À propos donne l'impression qu'une personne l'a écrite
- 3 à 6 projets, sélectionnés pour la qualité
- La section contact a un lien mailto comme action principale
Phase 3 — Construire
3.1 Structure HTML
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title><Nom> — <Rôle></title>
<meta name="description" content="<description personnelle de 150 caractères>">
<!-- Google Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=<PoliceTitres>:wght@400;600;700&family=<PoliceCorps>:wght@400;500&display=swap" rel="stylesheet">
<!-- OG Tags -->
<meta property="og:title" content="<Nom> — <Rôle>">
<meta property="og:description" content="<description>">
<meta property="og:image" content="<og-image.jpg>">
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<nav class="nav" id="nav">...</nav>
<main>
<section class="hero" id="home">...</section>
<section class="work" id="work">...</section>
<section class="about" id="about">...</section>
<section class="skills" id="skills">...</section> <!-- optionnel -->
<section class="contact" id="contact">...</section>
</main>
<footer class="footer">...</footer>
<div class="project-modal" id="modal" aria-hidden="true">...</div> <!-- optionnel lightbox -->
<script src="main.js"></script>
</body>
</html>
3.2 Architecture CSS
/* ── 1. Google Fonts ── */
/* ── 2. Variables CSS ── */
:root {
/* Couleurs du Brief de Design */
--color-bg: <hex>;
--color-bg-secondary: <hex>;
--color-text: <hex>;
--color-text-muted: <hex>;
--color-accent: <hex>;
--color-border: <hex>;
/* Typographie */
--font-heading: '<PoliceTitres>', serif;
--font-body: '<PoliceCorps>', sans-serif;
/* Échelle typographique */
--text-hero: clamp(3rem, 8vw, 7rem);
--text-h2: clamp(1.75rem, 4vw, 2.75rem);
--text-h3: clamp(1.125rem, 2vw, 1.5rem);
--text-body: 1.0625rem;
--text-sm: 0.875rem;
/* Espacement */
--section-padding: clamp(5rem, 12vw, 10rem);
--container-width: 1200px;
--gap: 1.5rem;
--radius: 8px;
--radius-lg: 16px;
/* Transitions */
--transition: 0.3s ease;
--transition-slow: 0.6s ease;
}
/* ── 3. Reset + Base ── */
/* ── 4. Mise en page (.container, .section, .grid-2, .grid-3) ── */
/* ── 5. Navigation (fixe, changement de fond selon le défilement) ── */
/* ── 6. Hero ── */
/* ── 7. Travaux / Grille de projets ── */
/* ── 8. Carte de projet + Survol ── */
/* ── 9. À propos ── */
/* ── 10. Compétences ── */
/* ── 11. Contact ── */
/* ── 12. Pied de page ── */
/* ── 13. Modal / Lightbox (si utilisé) ── */
/* ── 14. Animations de défilement ── */
/* ── 15. Responsive ── */
3.3 Grille de Projets
<!-- Section Travaux avec filtre optionnel -->
<section class="work" id="work">
<div class="container">
<div class="work__header">
<h2 class="work__title">Travaux Sélectionnés</h2>
<!-- Onglets de filtre optionnels -->
<div class="work__filters" role="tablist">
<button class="filter-btn active" data-filter="all">Tout</button>
<button class="filter-btn" data-filter="design">Design</button>
<button class="filter-btn" data-filter="dev">Développement</button>
</div>
</div>
<div class="work__grid" id="work-grid">
<!-- Carte de projet -->
<article class="project-card" data-category="design" data-index="0">
<div class="project-card__image">
<img src="assets/images/project-1.jpg" alt="<Nom du Projet> — <brève description>" loading="lazy">
<div class="project-card__overlay">
<span class="project-card__type"><Type></span>
<h3 class="project-card__title"><Nom du Projet></h3>
<div class="project-card__tags">
<span class="tag">React</span>
<span class="tag">UI Design</span>
</div>
</div>
</div>
</article>
</div>
</div>
</section>
3.4 JavaScript — Filtre + Lightbox + Animations
// ── FILTRE DE PROJET ──
document.querySelectorAll('.filter-btn').forEach(btn => {
btn.addEventListener('click', () => {
document.querySelector('.filter-btn.active').classList.remove('active');
btn.classList.add('active');
const filter = btn.dataset.filter;
document.querySelectorAll('.project-card').forEach(card => {
card.style.display = filter === 'all' || card.dataset.category === filter ? 'block' : 'none';
});
});
});
// ── LIGHTBOX ──
const modal = document.getElementById('modal');
const modalImg = modal?.querySelector('img');
const modalClose = modal?.querySelector('.modal__close');
document.querySelectorAll('.project-card').forEach((card, i) => {
card.addEventListener('click', () => {
if (!modal || !modalImg) return;
modalImg.src = card.querySelector('img').src;
modal.setAttribute('aria-hidden', 'false');
document.body.style.overflow = 'hidden';
});
});
modalClose?.addEventListener('click', () => {
modal.setAttribute('aria-hidden', 'true');
document.body.style.overflow = '';
});
modal?.addEventListener('click', (e) => {
if (e.target === modal) {
modal.setAttribute('aria-hidden', 'true');
document.body.style.overflow = '';
}
});
// ── ANIMATIONS AU DÉFILEMENT ──
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
entry.target.classList.add('visible');
}
});
}, { threshold: 0.1 });
document.querySelectorAll('.project-card, .about__content, .skills__group').forEach(el => {
el.classList.add('reveal');
observer.observe(el);
});
Phase 4 — Livrer
4.1 Vérification Finale
- Liens de navigation fonctionnent (ancres
#id) - filtres de projet fonctionnent (si implémentés)
- Lightbox s'ouvre/se ferme (si implémentée)
- Animations au défilement ne bloquent pas la navigation initiale
- Appel à l'action de contact (email, formulaire ou lien)
- Balises meta OG (partage sur les réseaux sociaux)
- Responsive sur mobile, tablette et desktop
- Texte « alt » sur toutes les images
- Le site se charge en moins de 3 secondes (vérifier avec Lighthouse)
- Pages 404 (si navigation multipage)
- Icône de favori (favicon)
4.2 Déploiement Vercel
# 1. Aller dans le dossier du projet
cd portfolio
# 2. Initialiser Git (si pas déjà fait)
git init
# 3. Ajouter et committer
git add .
git commit -m "Initial portfolio build"
# 4. Créer un dépôt GitHub et pousser
# (ou utiliser le CLI Vercel directement)
# 5. Déployer avec Vercel CLI
vercel --prod
# 6. Configurer le domaine personnalisé (optionnel)
vercel domains add votredomaine.com
4.3 Quand le Portfolio est-il Terminé ?
- L'utilisateur approuve la version en direct
- Le portfolio répond à l'objectif défini en Phase 0
- Le design se sent intentionnel, pas générique
- Vous êtes fier d'envoyer le lien à quelqu'un
Appendices
A. Notes sur les Performances
- Images — Utilisez WebP. Compressez avec
squooshou ImageOptim. Les images hero ne doivent pas dépasser 200 Ko - Polices — Auto-hébergez ou utilisez Google Fonts avec
display=swap. Évitez plus de 2 polices - CSS — Réduisez avec des variables : pas de valeurs codées en dur pour les couleurs ou la taille des polices
- JS — Gardez-le léger. Pas de frameworks, pas de lourdes bibliothèques d'animation
B. Directives d'Accessibilité
- Toutes les images doivent avoir un
altpertinent - Le contraste du texte doit passer WCAG AA (rapport de contraste minimum de 4.5:1)
- Les filtres et la navigation doivent être utilisables au clavier
aria-labeletaria-currentpour les éléments interactifs- Pas d'animation qui pourrait déclencher des vertiges (mouvement réduit dans
prefers-reduced-motion)
C. Moteurs de Recherche & Partage Social
<!-- De base -->
<meta name="description" content="<150 caractères, décrivant qui vous êtes et ce que vous faites>">
<meta name="keywords" content="portfolio, <votre nom>, <votre rôle>, <votre spécialité>">
<!-- Open Graph -->
<meta property="og:title" content="<Nom> — <Rôle>">
<meta property="og:description" content="<brève description attrayante>">
<meta property="og:image" content="<URL de l'image d'aperçu (1200×630)>">
<meta property="og:type" content="website">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="<Nom> — <Rôle>">
Construit avec le Constructeur de Portfolio.
