Communitygithub.com

qike7777/skill-library

Créez un site portfolio personnel époustouflant avec une identité visuelle distinctive. Intègre la base de données de design ui-ux-design-pro (67+ styles, 161 palettes, 57 associations de polices) pour une esthétique audacieuse et mémorable. Couvre l'image de marque personnelle, la mise en page de vitrine de projets, le HTML/CSS responsive, les effets interactifs (hover/filtre/lightbox) et le déploiement sur Vercel. Conçu pour les designers, développeurs, freelances et professionnels créatifs.

Qu'est-ce que skill-library ?

Ce skill (qike7777/skill-library) permet de construire un site portfolio personnel percutant, conçu pour marquer les esprits et susciter l'envie de collaborer. Il suit un pipeline en cinq phases : comprendre l'identité du créateur, concevoir une identité visuelle distinctive (couleurs, typographie, style), préparer le contenu (bio, projets, compétences), construire le site en HTML/CSS/JS pur, et le déployer sur Vercel. Le skill tire parti d'une vaste base de données de design comprenant 67 styles d'interface, 161 palettes de couleurs et 57 associations de polices, avec des recherches intégrées pour trouver l'inspiration. Il est compatible avec tous les types de portfolios (designer, développeur, freelance, étudiant) et met l'accent sur des principes esthétiques forts pour éviter les designs génériques, en fournissant des critères de qualité détaillés pour chaque phase. L'architecture CSS est claire, les interactions (filtres, lightbox, animations) sont codées manuellement, et le déploiement est instantané grâce à Vercel. Ce skill est idéal pour tout professionnel souhaitant créer un portfolio en ligne sans framework complexe, avec un contrôle total sur l'apparence et le comportement.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/qike7777/skill-library/tree/HEAD/skills/3-websites-and-apps/portfolio

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

skill-library preview

Documentation

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

TypePublicFocus
DesignerClients, recruteursTravail visuel, études de cas, processus
DéveloppeurRecruteurs, clients, collaborateursProjets, stack technique, GitHub
Créatif (photographe/illustrateur/etc.)Clients, galeriesImagerie plein écran, texte minimal
FreelanceClients potentielsServices, travaux antérieurs, contact/appel à l'action
Étudiant / ReconversionRecruteurs, responsables RHProjets, 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

QuestionPourquoi 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étypeSections ClésPriorité Visuelle
DesignerHero + Travaux sélectionnés (études de cas) + À propos + Compétences + ContactDétail des études de cas, photos de processus
DéveloppeurHero + Projets (liens en direct + GitHub) + Compétences/Stack + À propos + ContactExtraits de code, démos en direct, stats GitHub
CréatifHero plein écran + Galerie/Grille + À propos + ContactL'imagerie domine, chrome UI minimal
FreelanceHero + Services + Travaux + Témoignages + ContactProéminence de l'appel à l'action, signaux de confiance
ÉtudiantHero + Projets + Compétences + À propos + ContactTrajectoire 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 grisUne palette qui exprime la personnalité
« Bonjour, je suis [Nom]. Je suis designer. » heroUne phrase d'accroche qui crée l'intrigue
Grille de cartes à 3 colonnes avec espacement identiqueUne mise en page qui reflète le caractère du travail
Hover : opacité 0.8Hover : 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é :

PersonaDirection de Palette
Designer minimalisteBlanc cassé + 1 accent fort, grand espace blanc
Créatif audacieuxFond sombre + accent vif, contraste élevé
Développeur techniqueEsthétique sombre/terminal OU clair et propre avec accents inspirés du code
Freelance chaleureuxTeintes terreuses, accessible, humain
Luxe/premiumNeutres 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 :

FormuleExemple
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 :

  1. Qui vous êtes — état actuel (rôle, lieu, ce sur quoi vous vous concentrez)
  2. Comment vous en êtes arrivé là — bref parcours (pas un CV, une histoire)
  3. Ce qui vous tient à cœur — le « pourquoi » derrière le travail
  4. 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

  1. Images — Utilisez WebP. Compressez avec squoosh ou ImageOptim. Les images hero ne doivent pas dépasser 200 Ko
  2. Polices — Auto-hébergez ou utilisez Google Fonts avec display=swap. Évitez plus de 2 polices
  3. CSS — Réduisez avec des variables : pas de valeurs codées en dur pour les couleurs ou la taille des polices
  4. 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 alt pertinent
  • 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-label et aria-current pour 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés