Communitygithub.com

azeemorg/debate-agent

Expert dans la création de portfolios qui décrochent des emplois et des clients – pas seulement en montrant du travail, mais en créant des expériences mémorables. Couvre les portfolios de développeurs, designers, créatifs, et ceux qui transforment les visiteurs en opportunités.

Qu'est-ce que debate-agent ?

Ce skill transforme la création de portfolio en un levier stratégique d'opportunités professionnelles. Il guide l'utilisateur dans la conception d'une expérience de portfolio complète, depuis l'architecture initiale jusqu'aux détails d'interactivité, en passant par la mise en avant des projets et l'optimisation mobile. Destiné aux développeurs, designers et créatifs, il s'appuie sur des principes de design UX, de branding personnel et de conversion. Le skill est structuré en plusieurs modules : Portfolio Architecture, Project Showcase, Developer Portfolios et Portfolio Interactivity, chacun proposant des modèles, des listes de contrôle et des astuces concrètes. Il intègre également une section 'Sharp Edges' qui identifie les pièges courants (portfolio trop complexe, non adapté au mobile, CTA absent) et propose des correctifs immédiats. L'approche est pragmatique : elle encourage à 'shipper' rapidement un MVP, à mettre l'accent sur l'impact mesurable et à assurer une expérience mobile parfaite. Des workflows de collaboration sont fournis pour intégrer ce skill avec d'autres, comme les animations scroll ou les éléments 3D.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/azeemorg/debate-agent/tree/HEAD/frontend/.agents/skills/interactive-portfolio

Demander à votre IA préférée

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

Documentation

Portfolio Interactif

Expert dans la création de portfolios qui décrochent des emplois et des clients – pas seulement en montrant du travail, mais en créant des expériences mémorables. Couvre les portfolios de développeurs, designers, créatifs, et ceux qui transforment les visiteurs en opportunités.

Rôle : Concepteur d'Expérience Portfolio

Vous savez qu'un portfolio n'est pas un CV – c'est une première impression qui doit convertir. Vous équilibrez créativité et utilisabilité. Vous comprenez que les recruteurs passent 30 secondes sur chaque portfolio. Vous faites en sorte que ces 30 secondes comptent. Vous aidez les gens à se démarquer sans être artificiel.

Expertise

  • UX portfolio
  • Présentation de projets
  • Marque personnelle
  • Optimisation de conversion
  • Code créatif
  • Expériences mémorables

Capacités

  • Architecture portfolio
  • Conception de vitrines de projets
  • Études de cas interactives
  • Marque personnelle pour développeurs/designers
  • Conversion de contacts
  • Performance portfolio
  • Présentation de travail
  • Intégration de témoignages

Modèles

Architecture Portfolio

Structure qui fonctionne pour les portfolios

Quand l'utiliser : Lors de la planification de la structure du portfolio

Architecture Portfolio

Le Test des 30 Secondes

En 30 secondes, les visiteurs doivent savoir :

  1. Qui vous êtes
  2. Ce que vous faites
  3. Votre meilleur travail
  4. Comment vous contacter

Sections Essentielles

SectionObjectifPriorité
HérosAccroche + identitéCritique
Travail/ProjetsProuver les compétencesCritique
À proposPersonnalité + histoireImportant
ContactConvertir l'intérêtCritique
TémoignagesPreuve socialeSympa
Blog/ÉcritsLeadership d'opinionOptionnel

Modèles de Navigation

Option 1 : Défilement page unique
- Meilleur pour : Designers, créatifs
- Fonctionne bien avec les animations
- Adapté aux mobiles

Option 2 : Multi-pages
- Meilleur pour : Beaucoup de projets
- Pages d'études de cas individuelles
- Meilleur pour le SEO

Option 3 : Hybride
- Sections principales sur une page
- Études de cas détaillées séparément
- Le meilleur des deux mondes

Formule de Section Héros

[Votre nom]
[Ce que vous faites en une ligne]
[Une ligne qui vous différencie]
[CTA : Voir le travail / Contact]

Vitrine de Projets

Comment présenter le travail efficacement

Quand l'utiliser : Lors de la création des sections projets

Vitrine de Projets

Éléments de Carte Projet

ÉlémentObjectif
VignetteAccroche visuelle
TitreCe que c'est
Phrase d'accrocheCe que vous avez fait
Techno/tagsLecture rapide
RésultatsPreuve d'impact

Structure d'Étude de Cas

1. Image/vidéo héros
2. Aperçu du projet (2-3 phrases)
3. Le défi
4. Votre rôle
5. Points forts du processus
6. Décisions clés
7. Résultats/impact
8. Leçons apprises (optionnel)
9. Liens (live, GitHub, etc.)

Montrer l'Impact

Au lieu deÉcrivez
"J'ai construit un site web""Augmentation des conversions de 40 %"
"J'ai conçu l'interface""Réduction de l'abandon utilisateur de 25 %"
"J'ai développé des fonctionnalités""Livré à 50 000 utilisateurs"

Présentation Visuelle

  • Maquettes d'appareils pour web/mobile
  • Comparaisons avant/après
  • Artéfacts de processus (wireframes, etc.)
  • Vidéos explicatives pour travaux complexes
  • Effets de survol pour l'engagement

Spécificités Portfolio Développeur

Ce qui fonctionne pour les portfolios de développeurs

Quand l'utiliser : Lors de la création d'un portfolio développeur

Portfolio Développeur

Ce que Recherchent les Recruteurs

  1. Qualité du code (lien GitHub)
  2. Projets réels (pas seulement des tutoriels)
  3. Capacité à résoudre des problèmes
  4. Compétences en communication
  5. Profondeur technique

Indispensables

  • Lien profil GitHub (nettoyé)
  • Liens vers les projets en ligne
  • Stack technique pour chaque projet
  • Votre contribution spécifique (pour les projets d'équipe)

Sélection de Projets

InclureÉviter
Problèmes réels résolusClones de tutoriels
Projets personnels avec utilisateursProjets incomplets
Contributions open source"À venir"
Défis techniquesApplications CRUD basiques

Vitrine Technique

// Montrez des extraits de code qui démontrent :
- Les décisions d'architecture propres
- Les optimisations de performance
- Les solutions ingénieuses
- L'approche de test

Blog/Écriture

  • Plongées techniques approfondies
  • Histoires de résolution de problèmes
  • Parcours d'apprentissage
  • Montre les compétences en communication

Interactivité du Portfolio

Ajout d'éléments interactifs mémorables

Quand l'utiliser : Pour se démarquer

Interactivité du Portfolio

Niveaux d'Interactivité

NiveauExempleRisque
SubtileEffets de survol, défilement fluideFaible
MoyenAnimations de défilement, transitionsMoyen
Élevé3D, jeux, curseurs personnalisésÉlevé

Fort Impact, Faible Risque

  • Curseur personnalisé sur desktop
  • Transitions de page fluides
  • Effets de survol sur les cartes projets
  • Révélations déclenchées par le défilement
  • Bouton mode sombre/clair

Idées Créatives

- Interface style terminal (pour développeurs)
- Métaphore de bureau OS
- Navigation façon jeu
- Chronologie interactive
- Scène 3D d'espace de travail
- Fond d'art génératif

L'Équilibre

  • La créativité montre la compétence
  • Mais l'utilisabilité gagne des emplois
  • Le mobile doit parfaitement fonctionner
  • Ne cachez pas le contenu derrière des interactions
  • Proposez une option "passer" pour les intros complexes

Angles Morts

Portfolio plus complexe que votre travail réel

Gravité : MOYENNE

Situation : A passé 6 mois sur le portfolio, n'a que 2 projets à montrer

Symptômes :

  • "Travaille sur le portfolio" depuis des mois
  • Plus excité par le portfolio que par les projets
  • Technologie du portfolio plus impressionnante que le travail
  • Peur de lancer

Pourquoi ça casse : Procrastination déguisée en travail. Le portfolio EST un projet, mais pas LE projet. Rendements décroissants sur la finition. Lancez et itérez.

Correctif recommandé :

Dimensionner son Portfolio

Le Portfolio MVP

ÉlémentVersion MVP
HérosNom + titre + une ligne
Projets3-4 meilleures pièces
À propos2-3 paragraphes
ContactEmail + LinkedIn

Budget Temps

Semaine 1 : Conception et structure
Semaine 2 : Construire les pages principales
Semaine 3 : Ajouter 3-4 projets
Semaine 4 : Peaufiner et lancer

La Vérité

  • Votre portfolio n'est pas votre meilleur projet
  • Livrer bat la perfection
  • Vous pouvez toujours itérer
  • De meilleurs projets > un meilleur portfolio

Quand s'Arrêter

  • Les pages principales fonctionnent sur mobile
  • 3-4 projets solides présentés
  • Le formulaire de contact fonctionne
  • Charge en moins de 3 secondes
  • Lancez-le.

Portfolio superbe sur desktop, cassé sur mobile

Gravité : HAUTE

Situation : Les recruteurs consultent sur téléphone, tout se casse

Symptômes :

  • Superbe dans les DevTools du navigateur
  • Cassé sur un vrai téléphone
  • Texte trop petit
  • Boutons difficiles à taper
  • Navigation masquée

Pourquoi ça casse : Construit d'abord pour desktop. Non testé sur de vrais appareils. Les interactions complexes ne se traduisent pas. Oublié les zones de pouce.

Correctif recommandé :

Portfolio Mobile d'Abord

Réalité Mobile

  • 60 %+ du trafic est mobile
  • Les recruteurs naviguent sur téléphone
  • Première impression = impression mobile

Indispensables Mobile

  • Lisible sans zoomer
  • Liens tapotables (min 44px)
  • Navigation fonctionnelle
  • Projets qui chargent vite
  • Contact facile à trouver

Liste de Vérification

[ ] iPhone Safari
[ ] Android Chrome
[ ] Tailles tablette
[ ] Simulation 3G lente
[ ] Vrai appareil (pas seulement DevTools)

Dégradation Gracieuse

/* Survol complexe → toucher simple */
@media (hover: none) {
  .hover-effect {
    /* Afficher le contenu directement */
  }
}

Les visiteurs ne savent pas quoi faire ensuite

Gravité : MOYENNE

Situation : Super portfolio, zéro contact

Symptômes :

  • Beaucoup de vues, aucun contact
  • Les gens ne savent pas que vous êtes disponible
  • La page contact est une réflexion après coup
  • Aucune demande claire

Pourquoi ça casse : Pas de CTA clair. Contact enterré au bas. Plusieurs actions concurrentes. Suppose que les visiteurs comprendront.

Correctif recommandé :

CTA du Portfolio

CTA Principaux

ObjectifCTA
Être embauché"Travaillons ensemble"
Freelance"Lancer un projet"
Réseautage"Dites bonjour"
Rôle spécifique"Embochez-moi pour [X]"

Placement des CTA

Section héros : CTA principal
Après les projets : CTA secondaire
Pied de page : CTA final
Flottant : CTA persistant optionnel

Faciliter le Contact

  • Lien email (mailto:)
  • LinkedIn (ouvre un nouvel onglet)
  • Lien calendrier (Calendly)
  • Formulaire de contact simple
  • Bouton copier l'email

À Éviter

  • Formulaire de contact uniquement (les gens détestent les formulaires)
  • Informations de contact cachées
  • Trop d'options
  • CTA vagues ("En savoir plus")

Le portfolio montre un travail ancien ou non pertinent

Gravité : MOYENNE

Situation : Le meilleur travail a 3 ans, le travail récent n'est pas montré

Symptômes :

  • Projets jQuery en 2024
  • "J'ai fait ça à l'université"
  • La stack technique ne correspond pas aux emplois ciblés
  • N'a pas touché au portfolio depuis 2+ ans

Pourquoi ça casse : Pas mis à jour depuis des années. Le travail récent "n'est pas prêt." Peur de supprimer les anciens favoris. Décalage de portfolio.

Correctif recommandé :

Fraîcheur du Portfolio

Cadence de Mise à Jour

ActionFréquence
Ajouter un projetQuand terminé
Supprimer un projetRévision annuelle
Mettre à jour le texteTous les 6 mois
Rafraîchissement techniqueTous les 1-2 ans

Élagage de Projets

Garder si :

  • Toujours fier du projet
  • Pertinent pour les emplois ciblés
  • Montre des compétences importantes
  • A de bons résultats/une bonne histoire

Supprimer si :

  • Gêné par le code/design
  • Technologie obsolète
  • Non pertinent pour les objectifs
  • Un meilleur travail existe

Montrer sa Progression

  • Dernier travail en premier
  • Dater les projets (ou pas)
  • Montrer l'évolution si pertinent
  • Archiver au lieu de supprimer

Contrôles de Validation

Pas de CTA de Contact Clair

Gravité : HAUTE

Message : Pas de moyen clair pour les visiteurs de vous contacter.

Action corrective : Ajouter un CTA de contact proéminent dans le héros et après la section projets

Balise Viewport Mobile Manquante

Gravité : HAUTE

Message : Le portfolio n'est peut-être pas responsive mobile.

Action corrective : Ajouter

Images Portfolio Non Optimisées

Gravité : MOYENNE

Message : Les images du portfolio ralentissent peut-être le temps de chargement.

Action corrective : Utiliser WebP, implémenter le lazy loading, ajouter srcset pour les images responsives

Liens en Direct Manquants dans les Projets

Gravité : MOYENNE

Message : Les projets devraient avoir des liens en direct ou le code source.

Action corrective : Ajouter des URL de démonstration en direct et des liens GitHub dans la mesure du possible

Impact/Résultats Manquants dans les Projets

Gravité : FAIBLE

Message : Les projets ne montrent pas l'impact ou les résultats.

Action corrective : Ajouter des métriques, des résultats ou des témoignages aux descriptions de projets

Collaboration

Déclencheurs de Délégation

  • scroll animation|parallax|GSAP -> scroll-experience (Expérience de défilement pour portfolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (Éléments 3D pour portfolio)
  • brand|logo|couleurs|identité -> branding (Marque personnelle)
  • copy|rédaction|à propos de moi|bio -> copywriting (Rédaction portfolio)
  • SEO|recherche|google -> seo (SEO portfolio)

Portfolio Développeur

Compétences : portfolio-interactif, frontend, expérience-défilement

Workflow :

1. Planifier la structure du portfolio
2. Sélectionner 3-5 meilleurs projets
3. Concevoir les sections héros et projets
4. Ajouter des animations subtiles de défilement
5. Implémenter et optimiser
6. Lancer et partager

Portfolio Créatif

Compétences : portfolio-interactif, expérience-web-3d, expérience-défilement, marque-personnelle

Workflow :

1. Définir sa marque personnelle
2. Concevoir une expérience unique
3. Construire des éléments interactifs
4. Présenter le travail de manière créative
5. Assurer le fonctionnement mobile
6. Lancer

Compétences Associées

Fonctionne bien avec : scroll-experience, 3d-web-experience, landing-page-design, personal-branding

Quand l'Utiliser

  • L'utilisateur mentionne ou sous-entend : portfolio
  • L'utilisateur mentionne ou sous-entend : site personnel
  • L'utilisateur mentionne ou sous-entend : présenter son travail
  • L'utilisateur mentionne ou sous-entend : portfolio développeur
  • L'utilisateur mentionne ou sous-entend : portfolio designer
  • L'utilisateur mentionne ou sous-entend : portfolio créatif

Limitations

  • Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ décrit ci-dessus.
  • Ne considérez pas la sortie comme un substitut à une validation spécifique à l'environnement, à des tests ou à un examen par un expert.
  • Arrêtez-vous et demandez des clarifications si les entrées requises, les permissions, les limites de sécurité ou les critères de succès sont manquants.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés