Communitygithub.com

MikeCheng1208/BattleTree

Minimalistisches Portfolio-Designsystem mit Schwerpunkt auf Typografie, inspiriert von neo-brutalistischen und Schweizer Gestaltungsprinzipien. Setzt auf kräftige Typografie, großzügige Weißräume, monochrome Farbschemata und elegante Schlichtheit für Entwickler- und Designer-Portfolios.

Was ist BattleTree?

Diese Fähigkeit bietet eine umfassende Designanleitung zur Erstellung von Portfolio-Websites mit einem minimalistischen, typografiezentrierten Ansatz. Sie basiert auf neo-brutalistischen und Schweizer Gestaltungsprinzipien und legt den Fokus auf Lesbarkeit, visuelle Hierarchie und professionelle Präsentation anstelle von dekorativen Elementen. Die Fähigkeit behandelt Kernbereiche wie Typografie, Farbsystem, Layout und Komponentenmuster und bietet detaillierte Spezifikationen für Schriftgrößen, Abstände, Raster und responsive Breakpoints. Sie ist plattformunabhängig und kann mit jedem Webentwicklungs-Framework oder CMS umgesetzt werden, das CSS und HTML unterstützt. Der Leitfaden betont die Verwendung eines monochromen Farbschemas mit optionalem, sparsam eingesetztem Akzent, einer einzigen Schriftfamilie und einem 8-Punkt-Raster für konsistente Abstände. Zu den Komponentenmustern gehören Navigationsleisten, Buttons, Karten, Foto-Präsentationen und Formulare, die alle einer Designphilosophie der radikalen Einfachheit und funktionalen Ästhetik folgen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Fähigkeit: Minimalistisches Portfolio-Design

Diese Fähigkeit leitet die Erstellung von sauberen, typografiezentrierten Portfolio-Websites mit einer minimalistischen Ästhetik an. Basierend auf neo-brutalistischen und Schweizer Gestaltungsprinzipien priorisiert dieser Ansatz Lesbarkeit, visuelle Hierarchie und professionelle Präsentation gegenüber dekorativen Elementen.

Grundlegende Designphilosophie

Gestaltungsprinzipien:

  • Typografie als Held: Lass die Schrift die Hauptarbeit leisten
  • Radikale Einfachheit: Entferne alles, was nicht wesentlich ist
  • Großzügiger Weißraum: Raum ist ein Gestaltungselement, keine Leere
  • Monochrome Palette: Schwarz, Weiß und Grautöne
  • Rasterbasierte Präzision: Alles richtet sich an einem unsichtbaren Raster aus
  • Keine Dekoration: Form folgt Funktion
  • Schweizer Design-Einfluss: Saubere, asymmetrische Layouts mit klarer Hierarchie

Was dieser Stil IST:

  • Kühn, selbstbewusst, professionell
  • Sauber und aufgeräumt
  • Typografie-getrieben
  • Zeitlos und elegant
  • Leicht zu überfliegen und zu navigieren

Was dieser Stil NICHT IST:

  • Farbenfroh oder verspielt (keine hellen Farben)
  • Stark animiert (nur subtile Interaktionen)
  • Überladen oder hektisch
  • Dekorativ oder ornamental
  • Trendig oder auffällig

Typografie-System

Schriftauswahl

Primäre Schriftarten-Optionen (Neo-Grotesk/Geometrische Sans):

  1. Aeonik (wie im Referenzbeispiel) – Neo-Grotesk, geometrisch, modern
  2. Inter – Vielseitig, hervorragende Bildschirmlesbarkeit, kostenlos
  3. Satoshi – Geometrisch, sauber, zeitgenössisches Gefühl
  4. Supreme – Kühn, geometrisch, großartig für große Anzeigetexte
  5. Space Grotesk – Moderne Geometrie mit Persönlichkeit
  6. Neue Montreal – Schweizerisch inspiriert, klare Linien
  7. General Sans – Ausgewogen, professionell, vielseitig

System-Schriftarten-Stapel (Fallback):

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', sans-serif;

Schriftgrößen & Hierarchie

Anzeige/Heldentext (Großer Gruß wie „Hallo“):

  • Desktop: 8rem-12rem (128px-192px)
  • Tablet: 6rem-8rem (96px-128px)
  • Mobil: 4rem-6rem (64px-96px)
  • Schriftstärke: 400-500 (Normal bis Medium)
  • Zeilenhöhe: 0.9-1.0 (eng)
  • Buchstabenabstand: -0.02em bis -0.04em (eng)

Abschnittsüberschriften (Wie „Farben“, „Typografie“):

  • Desktop: 4rem-6rem (64px-96px)
  • Tablet: 3rem-4rem (48px-64px)
  • Mobil: 2.5rem-3rem (40px-48px)
  • Schriftstärke: 400-500
  • Zeilenhöhe: 1.1
  • Buchstabenabstand: -0.02em

Unterüberschriften/Beschriftungen (Wie „Primär“, „Sekundär“):

  • Größe: 1.25rem-1.5rem (20px-24px)
  • Schriftstärke: 400-500
  • Zeilenhöhe: 1.4
  • Buchstabenabstand: 0

Fließtext (Wie die Beschreibung unter „Farben“):

  • Größe: 1rem-1.125rem (16px-18px)
  • Schriftstärke: 400
  • Zeilenhöhe: 1.6-1.7
  • Buchstabenabstand: 0
  • Maximale Breite: 65 Zeichen für Lesbarkeit

Kleiner Text/Beschriftungen (Wie „Nach unten scrollen ↓“):

  • Größe: 0.875rem-1rem (14px-16px)
  • Schriftstärke: 400
  • Zeilenhöhe: 1.5
  • Buchstabenabstand: 0.01em

Navigationslinks:

  • Größe: 1rem-1.125rem (16px-18px)
  • Schriftstärke: 400-500
  • Buchstabenabstand: 0

Typografie-Regeln

  • Eine Schriftfamilie für die gesamte Website (Konsistenz statt Vielfalt)
  • Schriftstärke verwenden, um Hierarchie zu schaffen, nicht mehrere Schriftarten
  • Enger Buchstabenabstand für großen Anzeigetext
  • Standardabstand für Fließtext
  • Großzügige Zeilenhöhe (1.6-1.7) für lesbaren Fließtext
  • Enge Zeilenhöhe (0.9-1.1) für Anzeigetext
  • Linksbündig ausgerichteter Text (nicht zentriert, außer bei bestimmten Helden-Elementen)
  • Keine Versalien für Fließtext (nur für kleine Beschriftungen, falls nötig)

Farbsystem

Monochrome Palette (Primärer Ansatz)

Dies ist die KERNÄsthetik – nur Schwarz, Weiß und Grautöne.

Farbpalette:

--color-black: #222222;        /* Primär - reiches Schwarz, nicht reines Schwarz */
--color-gray-dark: #7B7B7B;    /* Sekundär - mittleres Grau */
--color-gray-light: #F8F8F8;   /* Tertiär - off-white Hintergrund */
--color-white: #FFFFFF;        /* Reines Weiß */
--color-gray-50: #FAFAFA;      /* Hellstes Grau */
--color-gray-100: #F5F5F5;     /* Sehr helles Grau */
--color-gray-200: #EEEEEE;     /* Helles Grau */
--color-gray-300: #E0E0E0;     /* Randgrau */
--color-gray-400: #BDBDBD;     /* Deaktiviert-Zustand */
--color-gray-500: #9E9E9E;     /* Mittleres Grau */
--color-gray-600: #757575;     /* Textgrau */
--color-gray-700: #616161;     /* Dunkles Textgrau */
--color-gray-800: #424242;     /* Fast Schwarz */
--color-gray-900: #212121;     /* Dunkelstes Grau */

Farbverwendung:

  • Hintergrund: #F8F8F8 oder #FFFFFF (heller Modus) / #0A0A0A (dunkler Modus)
  • Text primär: #222222 (heller Modus) / #F8F8F8 (dunkler Modus)
  • Text sekundär: #7B7B7B (beide Modi)
  • Ränder: #E0E0E0 (heller Modus) / #2A2A2A (dunkler Modus)
  • Karten/Oberflächen: #FFFFFF (heller Modus) / #1A1A1A (dunkler Modus)
  • Hover-Zustände: Leichte Verdunkelung/Aufhellung (10-15% Deckkraftänderung)

Akzentfarbe-Option (Minimale Verwendung)

Nur wenn absolut notwendig – verwende EINE Akzentfarbe sparsam:

  • Nur für CTAs (Button „Anruf buchen“)
  • Für Hover-Zustände bei Schlüsselelementen
  • Für aktive Link-Indikatoren
  • Nie für Hintergründe oder große Flächen

Vorgeschlagene Akzentfarben (wähle EINE aus):

  • Tech-Blau: #0066FF (IBM-Blau, professionell)
  • Erfolgsgrün: #00B386 (dezent, vertrauenswürdig)
  • Warmes Rot: #FF3B30 (Apple-Rot, aufmerksamkeitsstark)
  • Behalte es schwarz bei: Keine Akzentfarbe (reinster Ansatz)

Farbanwendungs-Regeln

  1. Heller Modus Standard: Weißer/off-white Hintergrund (#F8F8F8 bis #FFFFFF)
  2. Dunkler Modus-Option: Dunkelgrauer/schwarzer Hintergrund (#0A0A0A bis #121212)
  3. Textkontrast: Mindestens 4.5:1 für Fließtext, 3:1 für großen Text
  4. Keine Verläufe: Nur Vollfarben
  5. Keine Schatten (oder sehr subtile 1-2px Schatten): Verwende stattdessen Ränder
  6. Hover-Zustände: Deckkraftänderungen (0.7-0.8) oder Hintergrundfarbverschiebungen
  7. Fotografie: Schwarz-Weiß oder entsättigt (wie das Referenzportrait)

Überlegungen zum Dunklen Modus

Wenn du den dunklen Modus implementierst:

  • Hintergrund: #0A0A0A bis #121212 (nicht reines Schwarz)
  • Oberflächen: #1A1A1A bis #222222
  • Text: #F8F8F8 bis #FFFFFF
  • Ränder: #2A2A2A bis #333333
  • Behalte den gleichen monochromen Ansatz bei
  • Vermeide reines Weiß auf reinem Schwarz (führt zu Augenbelastung)

Layout & Abstandssystem

Rastersystem

Containerbreiten:

  • Maximale Inhaltsbreite: 1440px-1600px
  • Inhaltspadding: 5-10% an den Seiten (responsiv)
  • Mobiles Padding: 24px-32px an den Seiten

Rasterstruktur:

  • 12-Spalten-Raster für Flexibilität
  • Für Heldenbereich: Asymmetrischer 60/40 oder 50/50 Split (Text/Bild)
  • Großzügige Abstände: 32px-48px zwischen Spalten

Abstandsskala (8pt-Raster)

Alle Abstände in Vielfachen von 8:

4px (0.25rem)   - Minimaler Abstand
8px (0.5rem)    - Enge Abstände
16px (1rem)     - Kleine Abstände
24px (1.5rem)   - Mittlere Abstände
32px (2rem)     - Standardabstände
48px (3rem)     - Große Abstände
64px (4rem)     - XL-Abstände
96px (6rem)     - Abstände zwischen Abschnitten (Mobil)
128px (8rem)    - Abstände zwischen Abschnitten (Tablet)
160px (10rem)   - Abstände zwischen Abschnitten (Desktop)
192px (12rem)   - Heldenbereich-Abstand

Vertikaler Rhythmus

Zwischen Abschnitten:

  • Mobil: 96px-128px
  • Tablet: 128px-160px
  • Desktop: 160px-192px

Innerhalb von Abschnitten:

  • Zwischen Überschrift und Inhalt: 32px-48px
  • Zwischen Absätzen: 24px-32px
  • Zwischen Listenelementen: 16px-24px

Abstände bei Komponenten:

  • Navigation-Padding: 24px-32px vertikal
  • Karten-Padding: 32px-48px intern
  • Button-Padding: 16px-32px horizontal, 12px-16px vertikal

Responsive Breakpoints

/* Mobile-first Ansatz */
mobile: 320px-640px
tablet: 641px-1024px
desktop: 1025px-1440px
xl: 1441px+

/* Tailwind-Äquivalent */
sm: 640px
md: 768px
lg: 1024px
xl: 1280px
2xl: 1536px

Layout-Muster für Portfolio

Heldenbereich (Gesamter Viewport)

Layout: 50/50 Split (Text links, Bild rechts)
Höhe: 100vh (gesamter Viewport)
Vertikale Ausrichtung: Mitte

Linke Seite:
- Großer Grußtext: „Hallo"
- Untertitel: „— Ich bin [Name] ein [Rolle]"
- Statistiken (optional): „+200 Projekt abgeschlossen"
- Scroll-Indikator: „Nach unten scrollen ↓"
- Vertikaler Text (optional): „Produktdesigner"

Rechte Seite:
- Großes Porträtfoto
- Schwarz-Weiß oder entsättigt
- Professionell, selbstbewusste Pose
- Kein Hintergrund (oder subtiler Verlauf)

Navigation:

  • Position: Absolute oben oder fixed oben
  • Höhe: 80px-100px
  • Logo: Oben links (24px-32px von den Rändern)
  • Links: Oben zentriert oder rechts
  • CTA: Oben rechts („Anruf buchen" mit Pfeil)
  • Hintergrund: Transparent oder subtiler backdrop-blur beim Scrollen
  • Rand: Keiner oder 1px unterer Rand (#E0E0E0)

Über mich/Info-Abschnitte

Layout: Einzelspalte, zentrierter Inhalt
Maximale Breite: 800px-900px für Lesbarkeit
Überschrift: Linksbündig, groß
Fließtext: Linksbündig, angenehme Zeilenlänge

Portfolio-Raster

Desktop: 3 Spalten
Tablet: 2 Spalten
Mobil: 1 Spalte
Abstand: 32px-48px
Karten-Seitenverhältnis: 4:3 oder 16:9

Weißraum-Philosophie

Mehr Raum = Hochwertiger

  • Leerer Raum ist ein Gestaltungselement
  • Fülle nicht jedes Pixel
  • Lass den Inhalt atmen
  • Verwende Weißraum, um das Auge zu führen
  • Ausgewogenheit ist der Schlüssel: Nicht zu spärlich, nicht zu überladen

Weißraum-Checkliste:

  • Gibt es Atemraum um alle Elemente?
  • Kann das Auge Abschnitte leicht identifizieren?
  • Wirkt das Layout ruhig und organisiert?
  • Sind zusammengehörige Elemente mit weniger Abstand gruppiert?
  • Sind nicht zusammengehörige Elemente mit mehr Abstand getrennt?

Komponenten-Designmuster

Navigationsleiste

Struktur:

[Logo]                    [Über mich] [Portfolio] [Dienste] [Blog]                    [Anruf buchen →]

Spezifikationen:

  • Höhe: 80px-100px
  • Position: Fixed oben mit backdrop-filter blur ODER absolute
  • Hintergrund: Transparent → Halbtransparent beim Scrollen
  • Logo: Einfaches Wortmarke oder Symbol (24px-32px Größe)
  • Links: 16px-18px, mittlere Schriftstärke
  • Link-Abstand: 32px-48px voneinander
  • CTA-Button: Umrissen oder gefüllt, rechtsbündig
  • Hover: Deckkraft 0.7 oder subtile Unterstreichung (1-2px)

Mobile Navigation:

  • Hamburger-Menü: Einfaches 3-Linien-Symbol (24px)
  • Menü: Vollbild-Overlay ODER eingeschobener Drawer
  • Links: Größerer Text (24px-32px), vertikaler Stapel
  • Animation: Sanft 200-300ms ease

Buttons

Primär-Button (CTA):

padding: 14px-16px vertikal, 28px-32px horizontal
border-radius: 4px-8px (dezent, nicht rund)
font-size: 16px-18px
font-weight: 500
background: #222222 (oder Akzentfarbe)
color: #FFFFFF
border: none ODER 1-2px solid
hover: opacity: 0.9 oder transform: translateY(-2px)

Sekundär-Button:

Gleiche Größe wie Primär
background: transparent
color: #222222
border: 1-2px solid #222222
hover: background: #222222, color: #FFFFFF

Textlink:

Kein Hintergrund, kein Rand
Unterstreichung: 1px solid (nur bei Hover) ODER immer vorhanden
Hover: opacity: 0.7

Karten (Projektkarten)

Struktur:

┌──────────────────────────┐
│                          │
│      Projektbild         │
│       (16:9 Verhältnis)  │
│                          │
├──────────────────────────┤
│  Projekttitel            │
│  Kurze Beschreibung...   │
│  [Tag] [Tag] [Tag]       │
└──────────────────────────┘

Spezifikationen:

  • Hintergrund: #FFFFFF oder #FAFAFA
  • Rand: 1px solid #E0E0E0 ODER dezenten Schatten
  • Randradius: 8px-12px (dezent)
  • Padding: 0 (Bild randlos) + 24px-32px unten
  • Bild: Volle Breite, festes Seitenverhältnis
  • Hover: Scale 1.02 ODER Anheben mit Schatten ODER Randfarbänderung
  • Übergang: 200-300ms ease

Karteninhalt:

  • Titel: 20px-24px, mittlere Schriftstärke
  • Beschreibung: 16px, Regular, maximal 2-3 Zeilen
  • Tags: 12px-14px, padding 6px-12px, rounded-full, border 1px

Statistiken-Anzeige („+200 Projekt abgeschlossen")

Stil:

Zahl: 3rem-4rem (48px-64px), mittlere Schriftstärke
Bezeichnung: 1rem (16px), Regular, graue Farbe
Layout: Vertikaler Stapel
Abstand: 8px zwischen Zahl und Bezeichnung

Positionierung:

  • Nahe am Heldenbereich-Text
  • Dezent, nicht mit der Hauptbotschaft konkurrierend
  • Können mehrere Statistiken nebeneinander sein (32px-48px Abstand)

Fotografie/Bilder

Porträtfoto (Heldenbereich):

  • Schwarz-Weiß oder stark entsättigt
  • Professionell, direkter Blick
  • Sauberer Hintergrund (Vollfarbe oder subtiler Verlauf)
  • Hohe Qualität: Scharf, gut beleuchtet
  • Seitenverhältnis: Hochformat (3:4) oder quadratisch (1:1)
  • Größe: Groß, füllt 40-50% des Viewports

Projektbilder:

  • Hohe Qualität: Mockups oder Screenshots
  • Einheitliches Seitenverhältnis für alle Projekte
  • Erwäge: 16:9 (Querformat) oder 4:3
  • Hover: Leichter Zoom (scale 1.05) oder kein Effekt
  • Alt-Text: Immer für Barrierefreiheit angeben

Ikonografie

Symbol-Stil:

  • Minimal: Nur Linien-Symbole (keine gefüllten Symbole)
  • Strichstärke: 1.5px-2px
  • Größe: 20px-24px Standard, 32px-40px für hervorgehobene
  • Farbe: Textfarbe anpassen (#222222 oder #7B7B7B)
  • Beispiele: Pfeil (→), Menü (≡), Schließen (×), Soziale Symbole

Symbolverwendung:

  • Navigation: Hamburger-Menü, Pfeil für CTA
  • Soziale Links: GitHub, LinkedIn, Twitter/X, E-Mail
  • Pfeile: Für Links, Buttons, Scroll-Indikatoren
  • Bleibe minimalistisch: Verwende Symbole nicht übermäßig

Formulare (Kontaktformulare)

Eingabefelder:

padding: 16px
border: 1px solid #E0E0E0
border-radius: 4px-8px
background: #FFFFFF oder #FAFAFA
font-size: 16px
focus: border-color: #222222, outline: none

Beschriftung:

font-size: 14px-16px
font-weight: 500
margin-bottom: 8px
color: #222222

Layout:

  • Einzelspalte, volle Breite
  • Felder: Name, E-Mail, Nachricht (maximal 3 Felder)
  • Abstand: 24px zwischen den Feldern
  • Senden-Button: Volle Breite oder rechtsbündig

Scroll-Indikator

Textstil:

„Nach unten scrollen ↓"
font-size: 14px-16px
color: #7B7B7B
position: unten zentriert oder unten links
animation: subtile Bewegung (optional)

Alternative:

  • Animierte Linie/Pfeil
  • Maussymbol mit Rad-Animation
  • Halte es dezent und minimalistisch

Portfolio-Seitenstruktur

1. Heldenbereich (Above the Fold)

Zweck: Sofortige Wirkung, klare Identität

Inhalt:

  • Großer Gruß: „Hallo" (oder deine Variante)
  • Name und Rolle: „— Ich bin [Name] ein [Rolle]"
  • Optionale Statistiken: „+200 Projekt abgeschlossen" „+50 Startup finanziert"
  • Scroll-Indikator: „Nach unten scrollen ↓"
  • Porträtfoto: Rechte Seite, S/W, professionell

Layout:

  • Gesamte Viewport-Höhe (100vh)
  • 50/50 Split (Text links, Foto rechts) ODER 60/40
  • Vertikal zentrierter Inhalt
  • Weißer oder off-white Hintergrund
  • Minimalistische Navigation oben

Typografie:

  • „Hallo": 10rem-12rem Desktop, 6rem Mobil
  • Untertitel: 1.25rem-1.5rem, graue Farbe (#7B7B7B)

Hinweis: Die restlichen Abschnitte der SKILL.md folgen diesem Muster für About, Portfolio, Kontakt und Footer – alle mit denselben Designprinzipien.

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

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.

MikeCheng1208/BattleTree

Build a GitHub portfolio that gets you hired — curate 3-5 polished projects, craft compelling READMEs, deploy live demos, tell a coherent story across your repos, and align everything to AI-native development roles. Use when preparing your GitHub for job searches, deciding what to pin, or auditing your public presence.

Verwandte Skills