Communitygithub.com

MikeCheng1208/BattleTree

Sistema de design de portfólio minimalista focado em tipografia, inspirado pelos princípios neo-brutalistas e do design suíço. Enfatiza tipografia ousada, espaçamento generoso, esquemas de cores monocromáticas e simplicidade elegante para portfólios de desenvolvedores/designers.

O que é BattleTree?

Esta habilidade fornece um sistema de design abrangente e detalhado para criar portfólios web minimalistas e elegantes, com forte ênfase em tipografia e clareza visual. Baseado nos princípios do neo-brutalismo e do design suíço, o guia prioriza a legibilidade, a hierarquia visual e a apresentação profissional, removendo elementos decorativos desnecessários. O sistema é aplicável a qualquer framework ou ferramenta de desenvolvimento web (como React, Next.js, Tailwind CSS, entre outros) e oferece especificações completas para tipografia (com uma seleção de fontes primárias como Aeonik, Inter e Space Grotesk), um esquema de cores estritamente monocromático (preto, branco e tons de cinza), um sistema de layout baseado em grade de 12 colunas e espaçamento de 8pt, e padrões de componentes como navegação, botões, cartões de projeto e formulários. O documento também detalha a filosofia de espaçamento (com uma escala de 8pt) e diretrizes para fotografia, iconografia e indicadores de rolagem, garantindo que o desenvolvedor possa implementar um portfólio visualmente coeso, moderno e profissional.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Design de Portfólio Minimalista

Esta habilidade orienta a criação de sites de portfólio limpos e focados em tipografia com uma estética minimalista. Baseada nos princípios neo-brutalistas e do design suíço, esta abordagem prioriza a legibilidade, a hierarquia visual e a apresentação profissional sobre elementos decorativos.

Filosofia Central de Design

Princípios de Design:

  • Tipografia como protagonista: Deixe o tipo fazer o trabalho pesado
  • Simplicidade radical: Remova tudo que não é essencial
  • Espaçamento generoso: Espaço é um elemento de design, não vazio
  • Paleta monocromática: Preto, branco e tons de cinza
  • Precisão baseada em grade: Tudo se alinha a uma grade invisível
  • Sem decoração: A forma segue a função
  • Influência do design suíço: Layouts limpos e assimétricos com hierarquia clara

O QUE este estilo é:

  • Ousado, confiante, profissional
  • Limpo e descomplicado
  • Orientado por tipografia
  • Atemporal e elegante
  • Fácil de escanear e navegar

O QUE este estilo NÃO é:

  • Colorido ou lúdico (sem cores vibrantes)
  • Pesadamente animado (apenas interações sutis)
  • Desordenado ou sobrecarregado
  • Decorativo ou ornamental
  • Da moda ou chamativo

Sistema de Tipografia

Seleção de Fontes

Opções de Tipografia Primária (Sans-serif Neo-Grotesca/Geométrica):

  1. Aeonik (conforme mostrado na referência) - Neo-Grotesca, geométrica, moderna
  2. Inter - Versátil, excelente legibilidade em tela, gratuita
  3. Satoshi - Geométrica, limpa, com toque contemporâneo
  4. Supreme - Negrito, geométrica, ótima para textos grandes de exibição
  5. Space Grotesk - Geométrica moderna com personalidade
  6. Neue Montreal - Inspirada no design suíço, linhas limpas
  7. General Sans - Equilibrada, profissional, versátil

Pilha de Fontes do Sistema (fallback):

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

Escala Tipográfica e Hierarquia

Texto de Exibição/Hero (Saudação grande como "Hello"):

  • Desktop: 8rem-12rem (128px-192px)
  • Tablet: 6rem-8rem (96px-128px)
  • Mobile: 4rem-6rem (64px-96px)
  • Peso: 400-500 (Regular a Medium)
  • Altura da linha: 0.9-1.0 (apertado)
  • Espaçamento entre letras: -0.02em a -0.04em (apertado)

Cabeçalhos de Seção (Como "Colors", "Typography"):

  • Desktop: 4rem-6rem (64px-96px)
  • Tablet: 3rem-4rem (48px-64px)
  • Mobile: 2.5rem-3rem (40px-48px)
  • Peso: 400-500
  • Altura da linha: 1.1
  • Espaçamento entre letras: -0.02em

Subtítulos/Rótulos (Como "Primary", "Secondary"):

  • Tamanho: 1.25rem-1.5rem (20px-24px)
  • Peso: 400-500
  • Altura da linha: 1.4
  • Espaçamento entre letras: 0

Texto Corporal (Como a descrição abaixo de "Colors"):

  • Tamanho: 1rem-1.125rem (16px-18px)
  • Peso: 400
  • Altura da linha: 1.6-1.7
  • Espaçamento entre letras: 0
  • Largura máxima: 65ch (caracteres) para legibilidade

Texto Pequeno/Rótulos (Como "Scroll down ↓"):

  • Tamanho: 0.875rem-1rem (14px-16px)
  • Peso: 400
  • Altura da linha: 1.5
  • Espaçamento entre letras: 0.01em

Links de Navegação:

  • Tamanho: 1rem-1.125rem (16px-18px)
  • Peso: 400-500
  • Espaçamento entre letras: 0

Regras de Tipografia

  • Uma família de fontes para todo o site (consistência sobre variedade)
  • Use o peso da fonte para criar hierarquia, não múltiplas fontes
  • Espaçamento apertado entre letras para textos grandes de exibição
  • Espaçamento padrão para texto corporal
  • Altura de linha generosa (1.6-1.7) para texto corporal legível
  • Altura de linha apertada (0.9-1.1) para textos de exibição
  • Texto alinhado à esquerda (não centralizado, exceto para elementos específicos do hero)
  • Sem CAIXA ALTA para texto corporal (apenas para pequenos rótulos, se necessário)

Sistema de Cores

Paleta Monocromática (Abordagem Primária)

Esta é a estética CENTRAL - apenas preto, branco e tons de cinza.

Paleta de Cores:

--color-black: #222222;        /* Primário - preto rico, não preto puro */
--color-gray-dark: #7B7B7B;    /* Secundário - cinza médio */
--color-gray-light: #F8F8F8;   /* Terciário - fundo off-white */
--color-white: #FFFFFF;        /* Branco puro */
--color-gray-50: #FAFAFA;      /* Cinza mais claro */
--color-gray-100: #F5F5F5;     /* Cinza muito claro */
--color-gray-200: #EEEEEE;     /* Cinza claro */
--color-gray-300: #E0E0E0;     /* Cinza de borda */
--color-gray-400: #BDBDBD;     /* Estado desabilitado */
--color-gray-500: #9E9E9E;     /* Cinza médio */
--color-gray-600: #757575;     /* Cinza de texto */
--color-gray-700: #616161;     /* Cinza de texto escuro */
--color-gray-800: #424242;     /* Quase preto */
--color-gray-900: #212121;     /* Cinza mais escuro */

Uso das Cores:

  • Fundo: #F8F8F8 ou #FFFFFF (modo claro) / #0A0A0A (modo escuro)
  • Texto primário: #222222 (modo claro) / #F8F8F8 (modo escuro)
  • Texto secundário: #7B7B7B (ambos os modos)
  • Bordas: #E0E0E0 (modo claro) / #2A2A2A (modo escuro)
  • Cartões/Superfícies: #FFFFFF (modo claro) / #1A1A1A (modo escuro)
  • Estados de hover: Escurecimento/clareamento sutil (10-15% de alteração de opacidade)

Opção de Cor de Destaque (Uso Mínimo)

Somente se absolutamente necessário - use UMA cor de destaque com moderação:

  • Apenas para CTAs (botão "Book A Call")
  • Para estados de hover em elementos-chave
  • Para indicadores de link ativo
  • Nunca para fundos ou grandes áreas

Cores de Destaque Sugeridas (escolha UMA):

  • Azul Tech: #0066FF (azul IBM, profissional)
  • Verde Sucesso: #00B386 (sutil, confiável)
  • Vermelho Quente: #FF3B30 (vermelho Apple, que chama atenção)
  • Mantenha-o preto: Sem cor de destaque (abordagem mais pura)

Regras de Aplicação de Cor

  1. Padrão Modo Claro: Fundo branco/off-white (#F8F8F8 a #FFFFFF)
  2. Opção Modo Escuro: Fundo cinza escuro/preto (#0A0A0A a #121212)
  3. Contraste de texto: Mínimo de 4.5:1 para texto corporal, 3:1 para texto grande
  4. Sem gradientes: Cores sólidas apenas
  5. Sem sombras (ou sombras muito sutis de 1-2px): Use bordas
  6. Estados de hover: Mudanças de opacidade (0.7-0.8) ou deslocamentos de cor de fundo
  7. Fotografia: Preto e branco ou dessaturada (como o retrato de referência)

Considerações sobre o Modo Escuro

Se implementar o modo escuro:

  • Fundo: #0A0A0A a #121212 (não preto puro)
  • Superfícies: #1A1A1A a #222222
  • Texto: #F8F8F8 a #FFFFFF
  • Bordas: #2A2A2A a #333333
  • Mantenha a mesma abordagem monocromática
  • Evite branco puro sobre preto puro (causa cansaço visual)

Sistema de Layout e Espaçamento

Sistema de Grade

Larguras do Container:

  • Largura máxima do conteúdo: 1440px-1600px
  • Padding do conteúdo: 5-10% nas laterais (responsivo)
  • Padding mobile: 24px-32px nas laterais

Estrutura da Grade:

  • Grade de 12 colunas para flexibilidade
  • Para o hero: Divisão assimétrica 60/40 ou 50/50 (texto/imagem)
  • Gutters generosos: 32px-48px entre colunas

Escala de Espaçamento (Grade de 8pt)

Todo espaçamento em múltiplos de 8:

4px (0.25rem)   - Espaço mínimo
8px (0.5rem)    - Espaçamento apertado
16px (1rem)     - Espaçamento pequeno
24px (1.5rem)   - Espaçamento médio
32px (2rem)     - Espaçamento padrão
48px (3rem)     - Espaçamento grande
64px (4rem)     - Espaçamento XL
96px (6rem)     - Espaçamento de seção (mobile)
128px (8rem)    - Espaçamento de seção (tablet)
160px (10rem)   - Espaçamento de seção (desktop)
192px (12rem)   - Espaçamento do hero

Ritmo Vertical

Entre seções:

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

Dentro das seções:

  • Entre o cabeçalho e o conteúdo: 32px-48px
  • Entre parágrafos: 24px-32px
  • Entre itens de lista: 16px-24px

Espaçamento de componentes:

  • Padding da navegação: 24px-32px vertical
  • Padding do cartão: 32px-48px interno
  • Padding do botão: 16px-32px horizontal, 12px-16px vertical

Breakpoints Responsivos

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

/* Equivalente Tailwind */
sm: 640px
md: 768px
lg: 1024px
xl: 1280px
2xl: 1536px

Padrões de Layout para Portfólio

Seção Hero (Viewport Inteira)

Layout: Divisão 50/50 (texto à esquerda, imagem à direita)
Altura: 100vh (viewport inteira)
Alinhamento vertical: centro

Lado esquerdo:
- Grande texto de saudação: "Hello"
- Subtítulo: "— It's [Name] a [role]"
- Estatísticas (opcional): "+200 Project completed"
- Indicador de rolagem: "Scroll down ↓"
- Texto vertical (opcional): "Product designer"

Lado direito:
- Grande foto de retrato
- Preto e branco ou dessaturada
- Profissional, pose confiante
- Sem fundo (ou gradiente sutil)

Navegação:

  • Posição: Topo absoluto ou topo fixo
  • Altura: 80px-100px
  • Logo: Canto superior esquerdo (24px-32px das bordas)
  • Links: Centro superior ou direita
  • CTA: Canto superior direito ("Book A Call" com seta)
  • Fundo: Transparente ou sutil backdrop-blur ao rolar
  • Borda: Nenhuma ou borda inferior de 1px (#E0E0E0)

Seções Sobre/Informações

Layout: Coluna única, conteúdo centralizado
Largura máxima: 800px-900px para legibilidade
Cabeçalho: Alinhado à esquerda, grande
Corpo: Alinhado à esquerda, comprimento de linha confortável

Grade de Portfólio

Desktop: 3 colunas
Tablet: 2 colunas
Mobile: 1 coluna
Espaçamento: 32px-48px
Proporção do cartão: 4:3 ou 16:9

Filosofia do Espaçamento

Mais espaço = Mais premium

  • Espaço vazio é um elemento de design
  • Não preencha cada pixel
  • Deixe o conteúdo respirar
  • Use o espaçamento para guiar o olhar
  • Equilíbrio é fundamental: Nem muito esparso, nem muito lotado

Lista de Verificação de Espaçamento:

  • Há espaço de respiração ao redor de todos os elementos?
  • O olho consegue identificar facilmente as seções?
  • O layout parece calmo e organizado?
  • Itens relacionados estão agrupados com menos espaço?
  • Itens não relacionados estão separados com mais espaço?

Padrões de Design de Componentes

Barra de Navegação

Estrutura:

[Logo]                    [About Me] [Portfolio] [Services] [Blog]                    [Book A Call →]

Especificações:

  • Altura: 80px-100px
  • Posição: Topo fixo com efeito backdrop-filter blur OU absoluto
  • Fundo: Transparente → Semitransparente ao rolar
  • Logo: Logotipo simples ou ícone (24px-32px de tamanho)
  • Links: 16px-18px, peso Medium
  • Espaçamento entre links: 32px-48px de distância
  • Botão CTA: Contornado ou preenchido, alinhado à direita
  • Hover: Opacidade 0.7 ou sublinhado sutil (1-2px)

Navegação Mobile:

  • Menu hambúrguer: Ícone simples de 3 linhas (24px)
  • Menu: Sobreposição de tela inteira OU gaveta deslizante
  • Links: Texto maior (24px-32px), empilhamento vertical
  • Animação: Suave, 200-300ms de duração

Botões

Botão Primário (CTA):

padding: 14px-16px vertical, 28px-32px horizontal
border-radius: 4px-8px (sutil, não em formato de pílula)
font-size: 16px-18px
font-weight: 500
background: #222222 (ou cor de destaque)
color: #FFFFFF
border: none OU 1-2px sólida
hover: opacity: 0.9 ou transform: translateY(-2px)

Botão Secundário:

Mesmo tamanho do primário
background: transparent
color: #222222
border: 1-2px sólida #222222
hover: background: #222222, color: #FFFFFF

Link de Texto:

Sem fundo, sem borda
Sublinhado: 1px sólida (apenas no hover) OU sempre presente
Hover: opacity: 0.7

Cartões (Cartões de Projeto)

Estrutura:

┌──────────────────────────┐
│                          │
│      Project Image       │
│       (16:9 ratio)       │
│                          │
├──────────────────────────┤
│  Project Title           │
│  Brief description...    │
│  [Tag] [Tag] [Tag]       │
└──────────────────────────┘

Especificações:

  • Fundo: #FFFFFF ou #FAFAFA
  • Borda: 1px sólida #E0E0E0 OU sombra sutil
  • Border-radius: 8px-12px (sutil)
  • Padding: 0 (imagem de ponta a ponta) + 24px-32px inferior
  • Imagem: Largura total, proporção fixa
  • Hover: Escala 1.02 OU elevação com sombra OU mudança de cor da borda
  • Transição: 200-300ms de duração

Conteúdo do Cartão:

  • Título: 20px-24px, peso Medium
  • Descrição: 16px, Regular, 2-3 linhas no máximo
  • Tags: 12px-14px, padding 6px-12px, rounded-full, border 1px

Exibição de Estatísticas ("+200 Project completed")

Estilo:

Número: 3rem-4rem (48px-64px), peso Medium
Rótulo: 1rem (16px), peso Regular, cor cinza
Layout: Empilhamento vertical
Espaçamento: 8px entre número e rótulo

Posicionamento:

  • Perto do texto do hero
  • Sutil, não competindo com a mensagem principal
  • Pode ter várias estatísticas lado a lado (espaçamento de 32px-48px)

Fotografia/Imagens

Foto de Retrato (Hero):

  • Preto e branco OU fortemente dessaturada
  • Profissional, olhar direto
  • Fundo limpo (cor sólida ou gradiente sutil)
  • Alta qualidade: Nitidez, bem iluminada
  • Proporção: Retrato (3:4) ou quadrado (1:1)
  • Tamanho: Grande, preenche 40-50% da viewport

Imagens de Projeto:

  • Alta qualidade: Mockups ou screenshots
  • Proporção consistente em todos os projetos
  • Considere: 16:9 (paisagem) ou 4:3
  • Hover: Zoom leve (scale 1.05) ou sem efeito
  • Texto alternativo: Sempre incluir para acessibilidade

Iconografia

Estilo do Ícone:

  • Minimalista: Apenas ícones de linha (sem ícones preenchidos)
  • Espessura do traço: 1.5px-2px
  • Tamanho: 20px-24px padrão, 32px-40px para destaque
  • Cor: Combine com a cor do texto (#222222 ou #7B7B7B)
  • Exemplos: Seta (→), Menu (≡), Fechar (×), Ícones sociais

Uso de Ícones:

  • Navegação: Menu hambúrguer, seta para CTA
  • Links sociais: GitHub, LinkedIn, Twitter/X, Email
  • Setas: Para links, botões, indicadores de rolagem
  • Mantenha mínimo: Não use ícones em excesso

Formulários (Formulários de Contato)

Campos de Entrada:

padding: 16px
border: 1px sólida #E0E0E0
border-radius: 4px-8px
background: #FFFFFF ou #FAFAFA
font-size: 16px
focus: border-color: #222222, outline: none

Rótulo:

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

Layout:

  • Coluna única, largura total
  • Campos: Nome, Email, Mensagem (máx. 3 campos)
  • Espaçamento: 24px entre campos
  • Botão de envio: Largura total ou alinhado à direita

Indicador de Rolagem

Estilo de Texto:

"Scroll down ↓"
font-size: 14px-16px
color: #7B7B7B
position: centro inferior ou canto inferior esquerdo
animation: salto sutil (opcional)

Alternativa:

  • Linha/seta animada
  • Ícone de mouse com animação de roda
  • Mantenha sutil e minimalista

Estrutura de Página do Portfólio

1. Seção Hero (Acima da Dobra)

Propósito: Impacto imediato, identidade clara

Conteúdo:

  • Saudação grande: "Hello" (ou sua variação)
  • Nome e função: "— It's [Name] a [role]"
  • Estatísticas opcionais: "+200 Project completed" "+50 Startup raised"
  • Indicador de rolagem: "Scroll down ↓"
  • Foto de retrato: Lado direito, P&B, profissional

Layout:

  • Altura total da viewport (100vh)
  • Divisão 50/50 (texto à esquerda, foto à direita) OU 60/40
  • Conteúdo centralizado verticalmente
  • Fundo branco ou off-white
  • Navegação minimalista no topo

Tipografia:

  • "Hello": 10rem-12rem desktop, 6rem mobile
  • Subtítulo: 1.25rem-1.5rem, cor cinza (#7B7B7B)

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.

Habilidades Relacionadas