Communitygithub.com

MikeCheng1208/BattleTree

Construisez un portfolio GitHub qui vous permet de décrocher un emploi — sélectionnez 3 à 5 projets soignés, rédigez des README convaincants, déployez des démos en direct, racontez une histoire cohérente dans vos dépôts et alignez le tout sur les rôles de développement natifs de l'IA.

Qu'est-ce que BattleTree ?

Cette compétence vous guide dans la transformation de votre profil GitHub en un portfolio puissant et convaincant, conçu spécifiquement pour les rôles de développement natifs de l'IA et de génie logiciel. Elle explique comment passer d'une collection de projets inachevés à une vitrine soigneusement organisée de 3 à 5 dépôts épinglés, chacun racontant une partie de votre histoire professionnelle. Vous apprendrez à évaluer et nettoyer vos dépôts existants, à structurer vos projets épinglés selon des arcs narratifs efficaces (spécialiste, full-stack, développeur IA natif), à rédiger des README qui vendent votre travail en 30 secondes, et à déployer des démos en direct pour prouver que vos idées fonctionnent. La compétence inclut également des conseils sur la gestion de votre graphique de contribution, l'alignement de votre portfolio avec le poste visé, et une checklist d'audit complète pour chaque recherche d'emploi. Elle est idéale pour les développeurs utilisant des plateformes comme Claude Code, Cursor, Codex ou tout autre outil d'agent IA nécessitant l'amélioration de leur présence publique.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/portfolio-strategy

Demander à votre IA préférée

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

Documentation

Stratégie de Portfolio

Principe Fondamental

Votre GitHub n'est pas un cimetière de projets à moitié finis. C'est une exposition organisée. Chaque dépôt épinglé doit répondre à une question qu'un responsable de recrutement se pose à votre sujet — et chaque réponse doit leur donner envie de planifier un entretien.

Ce qui Sépare l'Impressionnant du Médiocre

PORTFOLIO MÉDIOCRE                    PORTFOLIO IMPRESSIONNANT
─────────────────                     ────────────────────────
30 dépôts, surtout des forks          5 dépôts, tous originaux
Pas de README                         Chaque README raconte une histoire
Pas de démos en direct                Chaque projet est déployé
Tutoriels aléatoires clonés           Thème et progression clairs
Dernier commit : il y a 8 mois        Activité récente et régulière
Pas de description sur les dépôts     Chaque dépôt a une phrase d'accroche
"my-first-react-app"                  "Outil de revue de code propulsé par l'IA"

La différence n'est pas le talent. C'est l'organisation. Les meilleurs portfolios ressemblent à ceux de quelqu'un qui a un plan, pas de quelqu'un qui commit tout ce qu'il touche.


La Qualité plutôt que la Quantité

Trois à cinq projets soignés battent trente dépôts abandonnés. À tous les coups.

Les Chiffres qui Comptent

DépôtsREADMEDéployésLe Responsable de Recrutement Pense
3020"Commence des choses, ne les finit pas"
1551"Touche à tout. On ne sait pas ce dans quoi il est bon"
554"Concentré. Livre. Connaît son métier"
333"Tout ce qu'il touche est soigné"

La Règle du Nettoyage

Avant d'ajouter quoi que ce soit de nouveau, auditez ce qui est déjà là :

1. Archivez ou rendez privé tout ce qui est inachevé et irrécupérable.
2. Supprimez les forks que vous n'avez jamais modifiés.
3. Ajoutez des README à tout ce que vous gardez public.
4. Définissez des descriptions sur chaque dépôt visible.
5. Ce qui reste doit mériter d'être montré.

Si vous ne le mettriez pas sur votre CV, il ne devrait pas être sur votre GitHub public.


Racontez une Histoire à Travers vos Dépôts

Vos dépôts épinglés ne sont pas des échantillons aléatoires. Ce sont des chapitres. Organisez-les pour qu'un visiteur voie un récit.

Structures d'Histoire qui Fonctionnent

L'Arc du Spécialiste :

"Je vais en profondeur dans l'IA/ML et je peux le prouver."

Dépôt 1 : LLM affiné pour une tâche spécifique à un domaine
Dépôt 2 : Pipeline RAG avec framework d'évaluation
Dépôt 3 : Workflow agentique avec utilisation d'outils
Dépôt 4 : Contribution open-source à LangChain/LlamaIndex

L'Arc du Développeur Full-Stack :

"Je construis des produits complets de la base de données au déploiement."

Dépôt 1 : App SaaS full-stack (Next.js + API + DB + Auth)
Dépôt 2 : Outil CLI propulsé par l'IA (montre les compétences backend/systèmes)
Dépôt 3 : Bibliothèque open-source (montre la réflexion sur la conception d'API)
Dépôt 4 : Outil d'automatisation personnel (montre que vous construisez aussi pour vous-même)

L'Arc du Développeur Natif de l'IA :

"Je n'utilise pas seulement l'IA — je construis avec et pour elle."

Dépôt 1 : Workflow agentique / système multi-agents
Dépôt 2 : Intégration LLM dans une application de qualité production
Dépôt 3 : Outil de développement qui exploite l'IA (linter, reviewer, générateur)
Dépôt 4 : Contribution à un framework ou une chaîne d'outils IA

Signaux de Progression

Les responsables de recrutement remarquent quand vos dépôts montrent une croissance :

SignalCe que cela Montre
Dépôt ancien : app CRUD simpleVous avez commencé quelque part
Dépôt intermédiaire : API avec tests et CIVous avez appris les pratiques d'ingénierie
Dépôt récent : agent IA avec évaluationsVous construisez à la frontière
Contribution à un projet OSS majeurVous pouvez travailler dans de grandes bases de code

Que Épingler et Pourquoi

Vous avez droit à six dépôts épinglés. Utilisez-les stratégiquement.

La Disposition Idéale des Épingles

EmplacementQuoi ÉpinglerPourquoi
1Projet full-stackProuve que vous pouvez construire un produit complet
2Projet IA/MLMontre que vous travaillez à la frontière
3Contribution open-sourceProuve que vous collaborez dans de vraies bases de code
4Outil de développement ou CLIMontre que vous résolvez vos propres problèmes
5Projet de domaine (votre spécialité)Signal de profondeur pour votre rôle cible
6Joker — projet personnel ou créatifMontre votre personnalité et votre curiosité authentique

Règles d'Épinglage

À ÉPINGLER :
  - Projets avec démos en direct ou liens de déploiement
  - Dépôts avec des README complets et des captures d'écran
  - Travail qui correspond aux postes auxquels vous postulez
  - Votre travail le plus récent et le plus soigné

À NE PAS ÉPINGLER :
  - Fork que vous n'avez pas modifiés de manière significative
  - Suivis de tutoriels (même terminés)
  - Dépôts sans README
  - Tout ce que vous ne pouvez pas expliquer lors d'un entretien

README comme Pitch de votre Portfolio

Chaque dépôt épinglé a besoin d'un README qui vende le projet en 30 secondes. Un responsable de recrutement passera moins de temps que cela avant de décider s'il continue à lire.

Structure du README pour les Dépôts du Portfolio

# Nom du Projet
Description en une phrase de ce qu'il fait et pourquoi c'est important.

## Démo
[Lien vers la démo en direct] | [Lien vers la vidéo de démonstration]

Capture d'écran ou GIF montrant l'application en action.

## Le Problème
Quel problème cela résout-il ? Qui a ce problème ?

## Comment ça Marche
Aperçu de l'architecture. Décisions techniques clés.
Diagramme si le système a plusieurs composants.

## Stack Technique
Liste des technologies — mais seulement les plus significatives.
Ne listez pas HTML/CSS. Listez vos intégrations IA, bases de données, cibles de déploiement.

## Fonctionnalités Clés
- Fonctionnalité 1 — pourquoi elle est intéressante techniquement
- Fonctionnalité 2 — ce qui a été difficile à construire
- Fonctionnalité 3 — ce que vous amélioreriez ensuite

## Pour Commencer
Instructions de configuration claires. Quelqu'un devrait pouvoir l'exécuter en moins de 5 minutes.

## Ce que j'ai Appris
Brève réflexion sur le défi technique le plus difficile et comment vous l'avez résolu.

Anti-Patterns du README

Mauvais READMEMeilleur README
"Une app React""Résumeur de réunions propulsé par l'IA qui transforme les enregistrements en éléments d'action"
Pas de captures d'écranCapture d'écran ou GIF héroïque au-dessus de la ligne de flottaison
Configuration : "clonez et exécutez"Configuration : étape par étape avec les prérequis listés
Pas d'explication de l'architectureDiagramme système montrant comment les composants se connectent
Liste tous les packages npmMet en évidence les 3-4 technologies qui comptent

Démos en Direct et Liens de Déploiement

Le code est une hypothèse. Une application déployée est une preuve.

Pourquoi le Déploiement est Important

Le responsable de recrutement voit un dépôt sans démo :
  "Code intéressant... est-ce que ça marche vraiment ?"

Le responsable de recrutement voit un dépôt avec un lien en direct :
  "Laissez-moi essayer." → 2 minutes plus tard → "Cette personne livre."

Options de Déploiement par Type de Projet

Type de ProjetDéploiement GratuitBon Pour
App web full-stackVercel, Railway, Fly.ioApplications avec aspect professionnel
API / backendRailway, RenderMontrer les compétences backend
Site statique / docsGitHub Pages, NetlifyDocumentation, pages d'atterrissage
Démo IA/MLHugging Face Spaces, Streamlit CloudDémonstrations de modèles, applications de données
Outil CLInpm publish, Homebrew tapSignal de distribution

Si Vous ne Pouvez pas Déployer, Enregistrez une Démo

Tout ne peut pas tourner dans le cloud. Pour les outils locaux uniquement, les applications CLI ou les systèmes complexes :

1. Enregistrez une vidéo de démonstration de 60 à 90 secondes.
2. Téléchargez-la sur YouTube (non répertoriée, c'est très bien).
3. Créez un GIF de l'interaction clé.
4. Mettez les deux dans le README.

Une démo vidéo est dix fois mieux que pas de démo du tout.


Graphique de Contribution

Ce que la Régularité Signale

Les responsables de recrutement jettent un œil à votre graphique de contribution. Voici ce qu'ils en lisent réellement :

MotifInterprétation
Vert régulier, la plupart des jours"Cette personne code régulièrement. Bonne habitude."
Groupes autour des projets"Travaille par sprints ciblés. Normal."
Vert uniquement en semaine"A un emploi, livre quand même du travail personnel."
Mélange de ses propres dépôts et contributions"Collaboratif. Pas seulement des projets solo."

À quoi Ressemble la Tricherie

Les réviseurs expérimentés peuvent repérer ces signes instantanément :

DRAPEAUX ROUGES :
  - Vert parfaitement uniforme (chaque jour, même intensité)
  - Commits qui ne sont que des modifications de README ou des changements d'espaces blancs
  - 500 commits en un jour dans des dépôts vides
  - Des dizaines de dépôts créés en une semaine, tous avec un seul commit
  - Bots de commit automatisés

Tricher sur votre graphique est pire que d'avoir des lacunes. Cela signale le désespoir et un mauvais jugement. La vraie régularité signifie travailler sur des choses qui vous tiennent à cœur à un rythme régulier — lacunes comprises.

Construire un Vrai Graphique

Au lieu de simuler :
  1. Choisissez un projet et travaillez dessus 30 minutes par jour.
  2. Contribuez à l'open source — même la documentation, les tests ou les rapports de bogues comptent.
  3. Gardez un dépôt d'apprentissage où vous commitez des notes et des expériences.
  4. Construisez des outils que vous utilisez réellement. Vous les améliorerez naturellement.

Aligner Votre Portfolio sur le Poste que Vous Voulez

Votre portfolio doit ressembler à un aperçu du travail que vous feriez si vous étiez embauché. Adaptez-le à votre cible.

Rôles de Développement Natifs de l'IA

Ces rôles veulent voir que vous pouvez construire avec l'IA et construire pour l'IA :

SignalExemple de Dépôt
Utilisation d'outils IA dans votre workflowProjet avec config .claude/, commits assistés par IA, commandes slash Claude Code
Workflows agentiquesAgent multi-étapes qui recherche, planifie et exécute des tâches
Intégrations LLMApp avec sortie structurée, ingénierie de prompt, routage de modèles
RAG et rechercheBase de connaissances avec recherche par embeddings et métriques d'évaluation
Évaluation et testFramework d'évaluation de sortie LLM, tests de régression de prompt
Développement assisté par IAREADME du projet documentant comment les outils IA ont accéléré le développement

Cibles de Portfolio Spécifiques au Rôle

Rôle CibleDépôts IndispensablesAgréables à Avoir
Ingénieur IA/MLModèle affiné, framework d'évaluation, pipeline de donnéesImplémentation d'article, comparaison de modèles
Développeur IA Full-StackApp intégrant LLM, système RAG, SaaS déployéContribution open-source, outil CLI
Ingénieur Plateforme / InfraPipeline CI/CD, dépôt IaC, configuration de monitoringBenchmark de performance, contribution OSS
Outils de Développement / DXOutil CLI, SDK/bibliothèque, extension VS CodeSite de documentation, outil de communauté de développeurs

Checklist de Révision du Portfolio

Effectuez cet audit avant chaque recherche d'emploi. Soyez honnête.

Premières Impressions (30 secondes)

  • Photo de profil professionnelle (ou délibérément distinctive)
  • La bio indique ce que vous faites et ce que vous cherchez
  • Les dépôts épinglés ont des descriptions qui ont du sens pour un étranger
  • Au moins 3 dépôts épinglés ont des captures d'écran ou des liens de démo dans le README
  • Aucun nom de dépôt embarrassant visible sur la première page

Vérification en Profondeur (2 minutes)

  • Chaque dépôt épinglé a un README qui explique le quoi, le pourquoi et le comment
  • Au moins un projet a une démo en direct ou un lien de déploiement
  • La qualité du code dans les dépôts épinglés reflète votre niveau de compétence actuel
  • L'historique des commits montre un vrai développement (pas un seul blob "initial commit")
  • Au moins un dépôt démontre des tests ou CI/CD

Vérification de l'Histoire (5 minutes)

  • Vos dépôts épinglés racontent une histoire cohérente sur vos compétences
  • Il y a une progression visible de l'ancien au plus récent
  • Votre portfolio correspond aux postes que vous ciblez
  • Vous pouvez expliquer chaque dépôt épinglé en 60 secondes (discours d'ascenseur)
  • Vous vous embaucheriez vous-même sur la base de ce GitHub

Le Test Ultime

Ouvrez votre GitHub dans une fenêtre de navigation privée. Imaginez que vous êtes un responsable de recrutement qui ne vous a jamais rencontré. Passez 60 secondes. Est-ce que vous feriez passer ce candidat à l'étape suivante ?

Si la réponse n'est pas un oui immédiat, continuez d'itérer.


Anti-Patterns

Anti-PatternPourquoi ça NuitCorrectif
Forks sans modificationsDonne l'impression de faire du remplissageSupprimez ou rendez privé
Clones de tutoriels ("todo-app", "weather-app")Signale que vous avez suivi des instructions, pas que vous savez construireForkez-le, puis étendez-le bien au-delà du tutoriel
Dépôts vides ou avec uniquement un READMESignale des idées abandonnéesArchivez ou supprimez-les
Pas de README sur les dépôts publics"Je ne communique pas sur mon travail"Ajoutez des README à tout ce que vous gardez public
50+ dépôts visibles sans sélectionBruit écrasant, aucun signalArchivez agressivement, épinglez stratégiquement
Dépôts épinglés obsolètes (2+ ans)"Ils n'ont rien construit récemment"Alternez les épingles pour montrer le travail récent
README de profil avec uniquement des statistiques générées automatiquementImpersonnel, peu d'effortÉcrivez une vraie bio avec votre focus et vos objectifs
Dépôts nommés "test", "temp", "asdf"NégligentRenommez ou supprimez

Action Puissante

"Examinez mon portfolio GitHub à [votre URL GitHub]. Évaluez-le comme si vous étiez un responsable de recrutement pour un poste de développement natif de l'IA. Notez chaque dépôt épinglé sur la qualité du README, la profondeur technique, le statut de déploiement et la pertinence pour les rôles IA/ML. Ensuite, donnez-moi un plan d'action priorisé : quoi archiver, quoi améliorer, ce qui manque, et quel nouveau projet ferait la plus grande différence."

L'agent devient votre critique de portfolio — vous donnant le retour honnête et spécifique dont vous avez besoin pour transformer votre GitHub de cimetière de code en atout de carrière.

Compétences Connexes

CompétenceQuand l'utiliser
github-profileImplémenter les mécanismes de la plateforme GitHub — README de profil, épinglage de dépôts, sujets, graphique d'activité
career-resumeCycle de vie complet de la carrière — recherche d'emploi, entretiens, intégration, évaluations de performance

Individual skills in this repo

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

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

Skills associés