Communitygithub.com

MikeCheng1208/BattleTree

Baue ein GitHub-Portfolio, das dich einstellt – kuratiere 3–5 polierte Projekte, erstelle überzeugende READMEs, deploye Live-Demos, erzähle eine kohärente Geschichte über deine Repos und richte alles auf KI-native Entwicklerrollen aus. Verwende dies, wenn du dein GitHub für die Jobsuche vorbereitest, entscheidest, was du pinnen sollst, oder deine öffentliche Präsenz prüfst.

Was ist BattleTree?

Diese Skill (BattleTree) ist ein strategischer Leitfaden, um dein GitHub-Profil von einem Friedhof halbfertiger Projekte in eine kuratierte Ausstellung zu verwandeln, die dich bei Personalverantwortlichen ins Gespräch bringt. Sie lehrt dich, Qualität vor Quantität zu stellen, eine narrative Struktur über deine gepinnten Repos zu weben und jedes Repository mit einem überzeugenden README zu versehen, das das Projekt in 30 Sekunden verkauft. Die Skill unterstützt alle gängigen Plattformen (Claude Code, Cursor, Codex) und basiert auf der `SKILL.md`, die detaillierte Checklisten, Anti-Patterns und Rollen-spezifische Anpassungen für KI-native Entwickler, Full-Stack-Ingenieure und Plattformentwickler enthält. Durch praktische Tipps zu Live-Demos, Deployment-Links und einer ehrlichen Selbstprüfung hilft sie dir, ein Portfolio aufzubauen, das nicht nur deine technischen Fähigkeiten, sondern auch deine Fähigkeit zu liefern und zu kommunizieren beweist.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio-Strategie

Kernprinzip

Dein GitHub ist kein Friedhof halbfertiger Projekte. Es ist eine kuratierte Ausstellung. Jedes gepinnte Repository sollte eine Frage beantworten, die ein Personalverantwortlicher über dich hat – und jede Antwort sollte ihn dazu bringen, ein Vorstellungsgespräch zu vereinbaren.

Was Beeindruckendes von Mittelmäßigem unterscheidet

MITTELMÄSSIGES PORTFOLIO              BEEINDRUCKENDES PORTFOLIO
─────────────────                     ────────────────────
30 Repos, meist Forks                 5 Repos, alles Eigenarbeit
Keine READMEs                         Jedes README erzählt eine Geschichte
Keine Live-Demos                      Jedes Projekt ist deployed
Zufällig geklonte Tutorials           Klares Thema und Fortschritt
Letzter Commit: vor 8 Monaten         Konsistente, aktuelle Aktivität
Keine Beschreibungen auf Repos        Jedes Repo hat einen Einzeiler
"my-first-react-app"                  "AI-gestütztes Code-Review-Tool"

Der Unterschied liegt nicht im Talent. Es ist die Kuratierung. Die besten Portfolios sehen aus, als hätte jemand einen Plan, nicht als würde jemand alles committen, was er anfasst.


Qualität vor Quantität

Drei bis fünf polierte Projekte schlagen dreißig verlassene Repos. Jedes Mal.

Die Mathematik, die zählt

ReposREADMEsDeployedPersonalverantwortlicher denkt
3020"Fängt Dinge an, beendet sie nicht"
1551"Bastelt herum. Unklar, was er kann"
554"Fokussiert. Liefert aus. Kennt sein Handwerk"
333"Alles, was er anfasst, ist poliert"

Die Aufräumregel

Bevor du etwas Neues hinzufügst, prüfe, was bereits da ist:

1. Archiviere oder mache privat, was unfertig und nicht zu retten ist.
2. Lösche geforkte Repos, die du nie geändert hast.
3. Füge READMEs zu allem hinzu, was du öffentlich behältst.
4. Setze Beschreibungen auf jedes sichtbare Repo.
5. Was übrig bleibt, sollte zeigenswert sein.

Wenn du es nicht in deinen Lebenslauf aufnehmen würdest, sollte es nicht auf deinem öffentlichen GitHub sein.


Erzähle eine Geschichte über deine Repos hinweg

Deine gepinnten Repos sind keine zufälligen Stichproben. Es sind Kapitel. Ordne sie so an, dass ein Besucher eine Erzählung sieht.

Story-Strukturen, die funktionieren

Der Spezialisten-Bogen:

"Ich gehe tief in KI/ML und kann es beweisen."

Repo 1: Feinabgestimmtes LLM für domänenspezifische Aufgabe
Repo 2: RAG-Pipeline mit Evaluierungsframework
Repo 3: Agentischer Workflow mit Tool-Nutzung
Repo 4: Open-Source-Beitrag zu LangChain/LlamaIndex

Der Full-Stack-Erbauer-Bogen:

"Ich baue vollständige Produkte von der Datenbank bis zum Deployment."

Repo 1: Full-Stack-SaaS-App (Next.js + API + DB + Auth)
Repo 2: KI-gestütztes CLI-Tool (zeigt Backend/System-Kenntnisse)
Repo 3: Open-Source-Bibliothek (zeigt API-Design-Denken)
Repo 4: Persönliches Automatisierungstool (zeigt, dass du auch für dich selbst baust)

Der KI-native Entwickler-Bogen:

"Ich nutze KI nicht nur – ich baue mit ihr und für sie."

Repo 1: Agentischer Workflow / Multi-Agenten-System
Repo 2: LLM-Integration in einer produktionsreifen App
Repo 3: Entwicklertool, das KI nutzt (Linter, Reviewer, Generator)
Repo 4: Beitrag zu einem KI-Framework oder einer Toolchain

Fortschrittssignale

Personalverantwortliche bemerken, wenn deine Repos Wachstum zeigen:

SignalWas es zeigt
Frühes Repo: einfache CRUD-AppDu hast irgendwo angefangen
Mittleres Repo: API mit Tests und CIDu hast Engineering-Praktiken gelernt
Aktuelles Repo: KI-Agent mit EvaluierungenDu baust an der Grenze des Möglichen
Beitrag zu einem großen OSS-ProjektDu kannst in großen Codebasen arbeiten

Was pinnen und warum

Du kannst bis zu sechs Repos pinnen. Nutze sie strategisch.

Das ideale Pin-Layout

SlotWas pinnenWarum
1Full-Stack-ProjektBeweist, dass du ein komplettes Produkt bauen kannst
2KI/ML-ProjektZeigt, dass du an der Grenze arbeitest
3Open-Source-BeitragBeweist, dass du in echten Codebasen zusammenarbeitest
4Entwicklertool oder CLIZeigt, dass du deine eigenen Probleme löst
5Domain-Projekt (deine Spezialität)Tiefensignal für deine Zielrolle
6Joker – persönlich oder kreativZeigt Persönlichkeit und echte Neugier

Pin-Regeln

PINNEN solltest du:
  - Projekte mit Live-Demos oder Deployment-Links
  - Repos mit gründlichen READMEs und Screenshots
  - Arbeiten, die zu den Rollen passen, auf die du dich bewirbst
  - Deine aktuellsten, am meisten polierten Arbeiten

NICHT PINNEN solltest du:
  - Geforkte Repos, die du nicht wesentlich geändert hast
  - Tutorial-Nachbauten (selbst wenn fertiggestellt)
  - Repos ohne README
  - Alles, was du in einem Vorstellungsgespräch nicht erklären kannst

README als deine Portfolio-Präsentation

Jedes gepinnte Repo braucht ein README, das das Projekt in 30 Sekunden verkauft. Ein Personalverantwortlicher wird weniger Zeit damit verbringen, zu entscheiden, ob er weiterliest.

README-Struktur für Portfolio-Repos

# Projektname
Ein-Satz-Beschreibung, was es tut und warum es wichtig ist.

## Demo
[Link zur Live-Demo] | [Link zum Video-Walkthrough]

Screenshot oder GIF, das die App in Aktion zeigt.

## Das Problem
Welches Problem löst das? Wer hat dieses Problem?

## Wie es funktioniert
Architekturüberblick. Wichtige technische Entscheidungen.
Diagramm, wenn das System mehrere Komponenten hat.

## Tech-Stack
Liste der Technologien – aber nur die bedeutungsvollen.
Nicht HTML/CSS auflisten. Schon deine KI-Integrationen, Datenbanken, Deployment-Ziele.

## Hauptfunktionen
- Funktion 1 – warum sie technisch interessant ist
- Funktion 2 – was am Bauen schwer war
- Funktion 3 – was du als Nächstes verbessern würdest

## Erste Schritte
Klare Setup-Anleitung. Jemand sollte dies in unter 5 Minuten ausführen können.

## Was ich gelernt habe
Kurze Reflexion über die schwierigste technische Herausforderung und wie du sie gelöst hast.

README-Anti-Patterns

Schlechtes READMEBesseres README
"Eine React-App""KI-gestützter Meeting-Zusammenfasser, der Aufnahmen in Aktionspunkte verwandelt"
Keine ScreenshotsHero-Screenshot oder GIF über dem Falz
Setup: "clone und run"Setup: Schritt für Schritt mit aufgelisteten Voraussetzungen
Keine ArchitekturerklärungSystemdiagramm, das zeigt, wie Komponenten verbunden sind
Listet jedes npm-Paket aufHebt die 3-4 Technologien hervor, die zählen

Live-Demos und Deployment-Links

Code ist eine Hypothese. Eine deployed App ist der Beweis.

Warum Deployment wichtig ist

Personalverantwortlicher sieht Repo ohne Demo:
  "Interessanter Code... funktioniert es wirklich?"

Personalverantwortlicher sieht Repo mit Live-Link:
  "Lass es mich ausprobieren." → 2 Minuten später → "Diese Person liefert aus."

Deployment-Optionen nach Projekttyp

ProjekttypKostenloses DeploymentGut für
Full-Stack-Web-AppVercel, Railway, Fly.ioProduktionsnahe Apps
API / BackendRailway, RenderBackend-Kenntnisse zeigen
Statische Website / DocsGitHub Pages, NetlifyDokumentation, Landing Pages
KI/ML-DemoHugging Face Spaces, Streamlit CloudModelldemos, Daten-Apps
CLI-Toolnpm publish, Homebrew tapDistributionssignal

Wenn du nicht deployen kannst, nimm eine Demo auf

Nicht alles kann in der Cloud laufen. Für reine Lokaltools, CLI-Apps oder komplexe Systeme:

1. Nimm einen 60-90 Sekunden Video-Walkthrough auf.
2. Lade es auf YouTube hoch (ungelistet ist in Ordnung).
3. Erstelle ein GIF der Schlüsselinteraktion.
4. Füge beides in das README ein.

Eine Video-Demo ist zehnmal besser als keine Demo.


Beitragsgraph

Was Konsistenz signalisiert

Personalverantwortliche werfen einen Blick auf deinen Beitragsgraphen. Hier ist, was sie tatsächlich daraus lesen:

MusterInterpretation
Gleichmäßiges Grün, die meisten Tage"Diese Person codiert regelmäßig. Gute Angewohnheit."
Cluster um Projekte"Arbeitet in fokussierten Sprints. Normal."
Grün nur an Wochentagen"Hat einen Job, liefert trotzdem private Arbeit ab."
Mischung aus eigenen Repos und Beiträgen"Kooperativ. Nicht nur Soloprojekte."

Wie Manipulation aussieht

Erfahrene Prüfer erkennen dies sofort:

ROTE FLAGGEN:
  - Perfekt gleichmäßiges Grün (jeden Tag, gleiche Intensität)
  - Commits, die nur README-Bearbeitungen oder Leerzeichenänderungen sind
  - 500 Commits an einem Tag in leere Repos
  - Dutzende Repos, die in einer Woche erstellt wurden, alle mit einzelnen Commits
  - Automatisch generierte Commit-Bots

Deinen Graphen zu manipulieren ist schlimmer als Lücken zu haben. Es signalisiert Verzweiflung und schlechtes Urteilsvermögen. Echte Konsistenz bedeutet, regelmäßig an Dingen zu arbeiten, die dir wichtig sind – mit allen Lücken.

Einen echten Graphen aufbauen

Anstatt zu faken:
  1. Wähle ein Projekt aus und arbeite 30 Minuten täglich daran.
  2. Trage zu Open Source bei – selbst Docs, Tests oder Bug-Reports zählen.
  3. Führe ein Lern-Repo, in dem du Notizen und Experimente commitest.
  4. Baue Tools, die du tatsächlich nutzt. Du wirst sie natürlich weiter verbessern.

Dein Portfolio auf die gewünschte Rolle ausrichten

Dein Portfolio sollte wie eine Vorschau der Arbeit aussehen, die du tun würdest, wenn du eingestellt wirst. Passe es an dein Ziel an.

KI-native Entwicklerrollen

Diese Rollen wollen sehen, dass du mit KI und für KI bauen kannst:

SignalBeispiel-Repo
KI-Tool-Nutzung in deinem WorkflowProjekt mit .claude/-Konfiguration, KI-unterstützten Commits, Claude Code Slash-Befehlen
Agentische WorkflowsMehrschrittiger Agent, der recherchiert, plant und Aufgaben ausführt
LLM-IntegrationenApp mit strukturierter Ausgabe, Prompt-Engineering, Modell-Routing
RAG und RetrievalWissensdatenbank mit Embedding-Suche und Evaluierungsmetriken
Evaluierung und TestsLLM-Ausgabe-Evaluierungsframework, Prompt-Regressionstests
KI-unterstützte EntwicklungProjekt-README, das dokumentiert, wie KI-Tools die Entwicklung beschleunigt haben

Rollenspezifische Portfolio-Ziele

ZielrolleMust-Have-ReposNice-to-Have
KI/ML-IngenieurFeinabgestimmtes Modell, Evaluierungsframework, DatenpipelinePaper-Implementierung, Modellvergleich
Full-Stack-KI-EntwicklerLLM-integrierte App, RAG-System, deployed SaaSOpen-Source-Beitrag, CLI-Tool
Plattform-/Infra-IngenieurCI/CD-Pipeline, IaC-Repo, Monitoring-SetupPerformance-Benchmark, OSS-Beitrag
Entwicklertools / DXCLI-Tool, SDK/Bibliothek, VS-Code-ErweiterungDocs-Seite, Entwickler-Community-Tool

Portfolio-Review-Checkliste

Führe diese Prüfung vor jeder Jobsuche durch. Sei ehrlich.

Erster Eindruck (30 Sekunden)

  • Profilfoto ist professionell (oder bewusst unverwechselbar)
  • Bio gibt an, was du tust und wonach du suchst
  • Gepinnte Repos haben Beschreibungen, die für einen Fremden sinnvoll sind
  • Mindestens 3 gepinnte Repos haben Screenshots oder Demo-Links im README
  • Keine peinlichen Repo-Namen auf der ersten Seite sichtbar

Tiefencheck (2 Minuten)

  • Jedes gepinnte Repo hat ein README, das das Was, Warum und Wie erklärt
  • Mindestens ein Projekt hat eine Live-Demo oder einen Deployment-Link
  • Codequalität in gepinnten Repos spiegelt dein aktuelles Können wider
  • Commit-Verlauf zeigt echte Entwicklung (kein einzelner "initial commit"-Klumpen)
  • Mindestens ein Repo demonstriert Tests oder CI/CD

Story-Check (5 Minuten)

  • Deine gepinnten Repos erzählen eine kohärente Geschichte über deine Fähigkeiten
  • Es gibt sichtbare Fortschritte von älteren zu neueren Projekten
  • Dein Portfolio passt zu den Rollen, die du anstrebst
  • Du kannst jedes gepinnte Repo in einem 60-Sekunden-Elevator-Pitch erklären
  • Du würdest dich selbst basierend auf diesem GitHub einstellen

Der ultimative Test

Öffne dein GitHub in einem Inkognito-Fenster. Stell dir vor, du bist ein Personalverantwortlicher, der dich nie getroffen hat. Nimm dir 60 Sekunden. Würdest du diesen Kandidaten in die nächste Runde bringen?

Wenn die Antwort nicht ein sofortiges Ja ist, verbessere weiter.


Anti-Patterns

Anti-PatternWarum es schadetBehebung
Geforkte Repos ohne ÄnderungenSieht nach Füllmaterial ausLöschen oder privat machen
Tutorial-Klone ("todo-app", "weather-app")Signalisiert, dass du Anweisungen gefolgt bist, nicht dass du bauen kannstForke es, erweitere es dann weit über das Tutorial hinaus
Leere Repos oder Repos nur mit READMESignalisiert aufgegebene IdeenArchivieren oder löschen
Keine READMEs auf öffentlichen Repos"Ich kommuniziere nicht über meine Arbeit"Füge READMEs zu allem hinzu, was du öffentlich behältst
50+ sichtbare Repos ohne KuratierungÜberwältigendes Rauschen, kein SignalAggressiv archivieren, strategisch pinnen
Veraltete gepinnte Repos (2+ Jahre alt)"Sie haben seit kurzem nichts mehr gebaut"Pins rotieren, um aktuelle Arbeit zu zeigen
Profil-README nur mit automatisch generierten StatistikenUnpersönlich, wenig AufwandSchreibe eine echte Bio mit deinem Fokus und Zielen
Repos mit Namen wie "test", "temp", "asdf"SorglosUmbenennen oder entfernen

Power-Move

"Überprüfe mein GitHub-Portfolio unter [deine GitHub-URL]. Bewerte es, als wärst du ein Personalverantwortlicher für eine KI-native Entwicklerrolle. Bewerte jedes gepinnte Repo nach README-Qualität, technischer Tiefe, Deployment-Status und Relevanz für KI/ML-Rollen. Gib mir dann einen priorisierten Aktionsplan: was archivieren, was verbessern, was fehlt und welches eine neue Projekt den größten Unterschied machen würde."

Der Agent wird zu deinem Portfolio-Kritiker – er gibt dir das ehrliche, spezifische Feedback, das du brauchst, um dein GitHub von einem Code-Friedhof in eine Karriere-Asset zu verwandeln.

Verwandte Skills

SkillWann verwenden
github-profileGitHub-Plattform-Mechaniken implementieren – Profil-README, Repo-Pinning, Themen, Aktivitätsgraph
career-resumeVollständiger Karrierezyklus – Jobsuche, Vorstellungsgespräche, Onboarding, Leistungsbeurteilungen

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.

Verwandte Skills