Communitygithub.com

BattleTree

Sistema de diseño de portafolio minimalista y centrado en tipografía, inspirado en principios neobrutalistas y del diseño suizo. Enfatiza tipografía audaz, espacios generosos, esquemas monocromáticos y elegancia simple para portafolios de desarrolladores y diseñadores.

¿Qué es BattleTree?

BattleTree es una habilidad de agente de IA que proporciona un sistema de diseño integral para crear portafolios web limpios y centrados en tipografía, con una estética minimalista. Está inspirada en principios del diseño suizo y neobrutalismo, priorizando la legibilidad, jerarquía visual y presentación profesional sobre elementos decorativos. La habilidad incluye guías detalladas sobre sistemas tipográficos (con opciones de fuentes como Aeonik, Inter, Satoshi), paletas de colores monocromáticos (negro, blanco y grises), un sistema de rejilla basado en una cuadrícula de 8 puntos, y patrones de diseño de componentes como navegación, tarjetas, botones y formularios. Es compatible con cualquier plataforma de agente de IA para desarrollo web (como Claude Code, Cursor, Codex) y se puede aplicar directamente a la generación de código. La habilidad es útil para desarrolladores y diseñadores que desean crear portafolios profesionales, atemporales y fáciles de escanear, evitando colores brillantes, animaciones pesadas o decoraciones excesivas. Incluye pautas para diseño responsive (mobile-first), con consideraciones de modo oscuro y una filosofía de espacios en blanco que prioriza la amplitud para transmitir una sensación premium.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Diseño de Portafolio Minimalista

Esta habilidad guía la creación de sitios web de portafolio limpios, centrados en tipografía y con una estética minimalista. Basada en principios del diseño suizo y neobrutalismo, este enfoque prioriza la legibilidad, jerarquía visual y presentación profesional sobre elementos decorativos.

Filosofía Central de Diseño

Principios de Diseño:

  • La tipografía como protagonista: Deja que el tipo haga el trabajo pesado
  • Simplicidad radical: Elimina todo lo que no sea esencial
  • Espacios en blanco generosos: El espacio es un elemento de diseño, no vacío
  • Paleta monocromática: Negro, blanco y tonos de gris
  • Precisión basada en rejilla: Todo se alinea a una rejilla invisible
  • Sin decoración: La forma sigue a la función
  • Influencia del diseño suizo: Diseños limpios y asimétricos con jerarquía clara

Lo que ESTE ESTILO ES:

  • Audaz, seguro, profesional
  • Limpio y sin desorden
  • Impulsado por tipografía
  • Atemporal y elegante
  • Fácil de escanear y navegar

Lo que ESTE ESTILO NO ES:

  • Colorido o divertido (sin colores brillantes)
  • Muy animado (solo interacciones sutiles)
  • Desordenado o recargado
  • Decorativo u ornamental
  • Pasajero o llamativo

Sistema Tipográfico

Selección de Fuentes

Opciones de Tipo de Letra Primario (Sans Serif Neo-Grotesk/Geométrico):

  1. Aeonik (como se muestra en la referencia) - Neo-Grotesk, geométrico, moderno
  2. Inter - Versátil, excelente legibilidad en pantalla, gratuita
  3. Satoshi - Geométrica, limpia, sensación contemporánea
  4. Supreme - Audaz, geométrica, ideal para texto grande de exhibición
  5. Space Grotesk - Geométrica moderna con personalidad
  6. Neue Montreal - Inspirada en el diseño suizo, líneas limpias
  7. General Sans - Equilibrada, profesional, versátil

Pila de Fuentes del Sistema (respaldo):

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

Escala Tipográfica y Jerarquía

Texto de Exhibición/Heroe (Saludo grande como "Hola"):

  • Escritorio: 8rem-12rem (128px-192px)
  • Tablet: 6rem-8rem (96px-128px)
  • Móvil: 4rem-6rem (64px-96px)
  • Peso: 400-500 (Regular a Medium)
  • Altura de línea: 0.9-1.0 (ajustado)
  • Espaciado entre letras: -0.02em a -0.04em (ajustado)

Encabezados de Sección (Como "Colores", "Tipografía"):

  • Escritorio: 4rem-6rem (64px-96px)
  • Tablet: 3rem-4rem (48px-64px)
  • Móvil: 2.5rem-3rem (40px-48px)
  • Peso: 400-500
  • Altura de línea: 1.1
  • Espaciado entre letras: -0.02em

Subtítulos/Etiquetas (Como "Primario", "Secundario"):

  • Tamaño: 1.25rem-1.5rem (20px-24px)
  • Peso: 400-500
  • Altura de línea: 1.4
  • Espaciado entre letras: 0

Texto del Cuerpo (Como la descripción debajo de "Colores"):

  • Tamaño: 1rem-1.125rem (16px-18px)
  • Peso: 400
  • Altura de línea: 1.6-1.7
  • Espaciado entre letras: 0
  • Ancho máximo: 65 caracteres para legibilidad

Texto Pequeño/Etiquetas (Como "Desplázate hacia abajo ↓"):

  • Tamaño: 0.875rem-1rem (14px-16px)
  • Peso: 400
  • Altura de línea: 1.5
  • Espaciado entre letras: 0.01em

Enlaces de Navegación:

  • Tamaño: 1rem-1.125rem (16px-18px)
  • Peso: 400-500
  • Espaciado entre letras: 0

Reglas Tipográficas

  • Una familia de fuentes para todo el sitio (consistencia sobre variedad)
  • Usa peso de fuente para crear jerarquía, no múltiples fuentes
  • Espaciado entre letras ajustado para texto de exhibición grande
  • Espaciado estándar para el texto del cuerpo
  • Altura de línea generosa (1.6-1.7) para texto del cuerpo legible
  • Altura de línea ajustada (0.9-1.1) para texto de exhibición
  • Texto alineado a la izquierda (no centrado, excepto para elementos específicos del heroe)
  • Sin mayúsculas sostenidas para el texto del cuerpo (solo para etiquetas pequeñas si es necesario)

Sistema de Color

Paleta Monocromática (Enfoque Primario)

Esta es la estética CENTRAL: solo negro, blanco y grises.

Paleta de Colores:

--color-black: #222222;        /* Primario - negro rico, no negro puro */
--color-gray-dark: #7B7B7B;    /* Secundario - gris medio */
--color-gray-light: #F8F8F8;   /* Terciario - fondo blanco roto */
--color-white: #FFFFFF;        /* Blanco puro */
--color-gray-50: #FAFAFA;      /* Gris más claro */
--color-gray-100: #F5F5F5;     /* Gris muy claro */
--color-gray-200: #EEEEEE;     /* Gris claro */
--color-gray-300: #E0E0E0;     /* Gris de borde */
--color-gray-400: #BDBDBD;     /* Estado deshabilitado */
--color-gray-500: #9E9E9E;     /* Gris medio */
--color-gray-600: #757575;     /* Gris de texto */
--color-gray-700: #616161;     /* Gris de texto oscuro */
--color-gray-800: #424242;     /* Casi negro */
--color-gray-900: #212121;     /* Gris más oscuro */

Uso de Color:

  • Fondo: #F8F8F8 o #FFFFFF (modo claro) / #0A0A0A (modo oscuro)
  • Texto primario: #222222 (modo claro) / #F8F8F8 (modo oscuro)
  • Texto secundario: #7B7B7B (ambos modos)
  • Bordes: #E0E0E0 (modo claro) / #2A2A2A (modo oscuro)
  • Tarjetas/Superficies: #FFFFFF (modo claro) / #1A1A1A (modo oscuro)
  • Estados hover: Oscurecimiento/aclarado leve (10-15% de cambio de opacidad)

Opción de Color de Acento (Uso Mínimo)

Solo si es absolutamente necesario - usa UN color de acento con moderación:

  • Solo para CTAs (Botón "Reservar una llamada")
  • Para estados hover en elementos clave
  • Para indicadores de enlace activo
  • Nunca para fondos o áreas grandes

Colores de Acento Sugeridos (elige UNO):

  • Azul Tecnológico: #0066FF (azul IBM, profesional)
  • Verde Éxito: #00B386 (sutil, confiable)
  • Rojo Cálido: #FF3B30 (rojo Apple, que llama la atención)
  • Manténlo negro: Sin color de acento (enfoque más puro)

Reglas de Aplicación de Color

  1. Modo Claro por Defecto: Fondo blanco/blanco roto (#F8F8F8 a #FFFFFF)
  2. Opción de Modo Oscuro: Fondo gris oscuro/negro (#0A0A0A a #121212)
  3. Contraste de texto: Mínimo 4.5:1 para texto del cuerpo, 3:1 para texto grande
  4. Sin degradados: Solo colores sólidos
  5. Sin sombras (o sombras muy sutiles de 1-2px): Usa bordes en su lugar
  6. Estados hover: Cambios de opacidad (0.7-0.8) o cambios de color de fondo
  7. Fotografía: Blanco y negro o desaturada (como el retrato de referencia)

Consideraciones de Modo Oscuro

Si implementas modo oscuro:

  • Fondo: #0A0A0A a #121212 (no negro puro)
  • Superficies: #1A1A1A a #222222
  • Texto: #F8F8F8 a #FFFFFF
  • Bordes: #2A2A2A a #333333
  • Mantén el mismo enfoque monocromático
  • Evita blanco puro sobre negro puro (causa fatiga visual)

Sistema de Diseño y Espaciado

Sistema de Rejilla

Anchos de Contenedor:

  • Ancho máximo de contenido: 1440px-1600px
  • Relleno de contenido: 5-10% en los lados (responsive)
  • Relleno móvil: 24px-32px en los lados

Estructura de Rejilla:

  • Rejilla de 12 columnas para flexibilidad
  • Para el heroe: División asimétrica 60/40 o 50/50 (texto/imagen)
  • Medianiles generosos: 32px-48px entre columnas

Escala de Espaciado (Rejilla de 8 Puntos)

Todo el espaciado en múltiplos de 8:

4px (0.25rem)   - Espacio mínimo
8px (0.5rem)    - Espaciado ajustado
16px (1rem)     - Espaciado pequeño
24px (1.5rem)   - Espaciado medio
32px (2rem)     - Espaciado estándar
48px (3rem)     - Espaciado grande
64px (4rem)     - Espaciado XL
96px (6rem)     - Espaciado de sección (móvil)
128px (8rem)    - Espaciado de sección (tablet)
160px (10rem)   - Espaciado de sección (escritorio)
192px (12rem)   - Espaciado del heroe

Ritmo Vertical

Entre secciones:

  • Móvil: 96px-128px
  • Tablet: 128px-160px
  • Escritorio: 160px-192px

Dentro de secciones:

  • Entre encabezado y contenido: 32px-48px
  • Entre párrafos: 24px-32px
  • Entre elementos de lista: 16px-24px

Espaciado de componentes:

  • Relleno de navegación: 24px-32px vertical
  • Relleno de tarjeta: 32px-48px interno
  • Relleno de botón: 16px-32px horizontal, 12px-16px vertical

Puntos de Corte Responsivos

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

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

Patrones de Diseño para Portafolio

Sección Heroe (Viewport Completo)

Diseño: División 50/50 (texto a la izquierda, imagen a la derecha)
Altura: 100vh (viewport completo)
Alineación vertical: centrado

Lado izquierdo:
- Texto de saludo grande: "Hola"
- Subtítulo: "— Soy [Nombre] un [rol]"
- Estadísticas (opcional): "+200 Proyectos completados"
- Indicador de desplazamiento: "Desplázate hacia abajo ↓"
- Texto vertical (opcional): "Diseñador de producto"

Lado derecho:
- Foto de retrato grande
- Blanco y negro o desaturada
- Profesional, postura segura
- Sin fondo (o degradado sutil)

Navegación:

  • Posición: Absoluta en la parte superior o fija en la parte superior
  • Altura: 80px-100px
  • Logo: Esquina superior izquierda (24px-32px de los bordes)
  • Enlaces: Centro o derecha superior
  • CTA: Esquina superior derecha ("Reservar una llamada" con flecha)
  • Fondo: Transparente o sutil backdrop-blur al desplazarse
  • Borde: Ninguno o borde inferior de 1px (#E0E0E0)

Secciones Acerca de/Información

Diseño: Columna única, contenido centrado
Ancho máximo: 800px-900px para legibilidad
Encabezado: Alineado a la izquierda, grande
Cuerpo: Alineado a la izquierda, longitud de línea cómoda

Cuadrícula de Portafolio

Escritorio: 3 columnas
Tablet: 2 columnas
Móvil: 1 columna
Espacio: 32px-48px
Relación de aspecto de tarjeta: 4:3 o 16:9

Filosofía de Espacios en Blanco

Más espacio = Más premium

  • El espacio vacío es un elemento de diseño
  • No llenes cada píxel
  • Deja que el contenido respire
  • Usa el espacio en blanco para guiar el ojo
  • El equilibrio es clave: No demasiado escaso, no demasiado abarrotado

Lista de Verificación de Espacios en Blanco:

  • ¿Hay espacio para respirar alrededor de todos los elementos?
  • ¿El ojo puede identificar fácilmente las secciones?
  • ¿El diseño se siente tranquilo y organizado?
  • ¿Los elementos relacionados están agrupados con menos espacio?
  • ¿Los elementos no relacionados están separados con más espacio?

Patrones de Diseño de Componentes

Barra de Navegación

Estructura:

[Logo]                    [Sobre Mí] [Portafolio] [Servicios] [Blog]                    [Reservar una llamada →]

Especificaciones:

  • Altura: 80px-100px
  • Posición: Fija en la parte superior con backdrop-filter blur O absoluta
  • Fondo: Transparente → Semitransparente al desplazarse
  • Logo: Marca denominativa simple o icono (tamaño 24px-32px)
  • Enlaces: 16px-18px, peso Medium
  • Espaciado de enlaces: 32px-48px de separación
  • Botón CTA: Con borde o relleno, alineado a la derecha
  • Hover: Opacidad 0.7 o subrayado sutil (1-2px)

Navegación Móvil:

  • Menú hamburguesa: Icono simple de 3 líneas (24px)
  • Menú: Superposición de pantalla completa O cajón deslizante
  • Enlaces: Texto más grande (24px-32px), apilados verticalmente
  • Animación: Suave 200-300ms ease

Botones

Botón Primario (CTA):

padding: 14px-16px vertical, 28px-32px horizontal
border-radius: 4px-8px (sutil, no tipo píldora)
font-size: 16px-18px
font-weight: 500
background: #222222 (o color de acento)
color: #FFFFFF
border: none O 1-2px sólido
hover: opacity: 0.9 o transform: translateY(-2px)

Botón Secundario:

Mismo tamaño que el primario
background: transparente
color: #222222
border: 1-2px sólido #222222
hover: background: #222222, color: #FFFFFF

Enlace de Texto:

Sin fondo, sin borde
Subrayado: 1px sólido (solo en hover) O siempre presente
Hover: opacity: 0.7

Tarjetas (Tarjetas de Proyecto)

Estructura:

┌──────────────────────────┐
│                          │
│      Imagen del Proyecto │
│       (relación 16:9)    │
│                          │
├──────────────────────────┤
│  Título del Proyecto     │
│  Breve descripción...    │
│  [Etiqueta] [Etiqueta]   │
└──────────────────────────┘

Especificaciones:

  • Fondo: #FFFFFF o #FAFAFA
  • Borde: 1px sólido #E0E0E0 O sombra sutil
  • Border-radius: 8px-12px (sutil)
  • Relleno: 0 (imagen de borde a borde) + 24px-32px inferior
  • Imagen: Ancho completo, relación de aspecto fija
  • Hover: Escala 1.02 O elevación con sombra O cambio de color de borde
  • Transición: 200-300ms ease

Contenido de la Tarjeta:

  • Título: 20px-24px, peso Medium
  • Descripción: 16px, Regular, 2-3 líneas máximo
  • Etiquetas: 12px-14px, padding 6px-12px, rounded-full, border 1px

Visualización de Estadísticas ("+200 Proyectos completados")

Estilo:

Número: 3rem-4rem (48px-64px), peso Medium
Etiqueta: 1rem (16px), peso Regular, color gris
Diseño: Apilado vertical
Espaciado: 8px entre número y etiqueta

Posicionamiento:

  • Cerca del texto del heroe
  • Sutil, sin competir con el mensaje principal
  • Pueden ser múltiples estadísticas una al lado de la otra (espacio de 32px-48px)

Fotografía/Imágenes

Foto de Retrato (Heroe):

  • Blanco y negro O muy desaturada
  • Profesional, mirada directa
  • Fondo limpio (color sólido o degradado sutil)
  • Alta calidad: Nítida, bien iluminada
  • Relación de aspecto: Retrato (3:4) o cuadrado (1:1)
  • Tamaño: Grande, llena 40-50% del viewport

Imágenes de Proyecto:

  • Alta calidad: Maquetas o capturas de pantalla
  • Relación de aspecto consistente en todos los proyectos
  • Considera: 16:9 (apaisado) o 4:3
  • Hover: Zoom ligero (escala 1.05) o sin efecto
  • Texto alternativo: Incluir siempre para accesibilidad

Iconografía

Estilo de Icono:

  • Mínimo: Solo iconos de línea (sin iconos rellenos)
  • Grosor de trazo: 1.5px-2px
  • Tamaño: 20px-24px estándar, 32px-40px para destacados
  • Color: Coincide con el color del texto (#222222 o #7B7B7B)
  • Ejemplos: Flecha (→), Menú (≡), Cerrar (×), Iconos sociales

Uso de Iconos:

  • Navegación: Menú hamburguesa, flecha para CTA
  • Enlaces sociales: GitHub, LinkedIn, Twitter/X, Correo electrónico
  • Flechas: Para enlaces, botones, indicadores de desplazamiento
  • Mantenlo mínimo: No abuses de los iconos

Formularios (Formularios de Contacto)

Campos de Entrada:

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

Etiqueta:

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

Diseño:

  • Columna única, ancho completo
  • Campos: Nombre, Correo electrónico, Mensaje (máximo 3 campos)
  • Espaciado: 24px entre campos
  • Botón de envío: Ancho completo o alineado a la derecha

Indicador de Desplazamiento

Estilo de Texto:

"Desplázate hacia abajo ↓"
font-size: 14px-16px
color: #7B7B7B
position: centro inferior o esquina inferior izquierda
animation: rebote sutil (opcional)

Alternativa:

  • Línea/flecha animada
  • Icono de ratón con animación de rueda
  • Mantenlo sutil y mínimo

Estructura de Página de Portafolio

1. Sección Heroe (Sobre el Pliegue)

Propósito: Impacto inmediato, identidad clara

Contenido:

  • Saludo grande: "Hola" (o tu variación)
  • Nombre y rol: "— Soy [Nombre] un [rol]"
  • Estadísticas opcionales: "+200 Proyectos completados" "+50 Startup recaudados"
  • Indicador de desplazamiento: "Desplázate hacia abajo ↓"
  • Foto de retrato: Lado derecho, B/N, profesional

Diseño:

  • Altura de viewport completo (100vh)
  • División 50/50 (texto a la izquierda, foto a la derecha) O 60/40
  • Contenido centrado verticalmente
  • Fondo blanco o blanco roto
  • Navegación minimalista en la parte superior

Tipografía:

  • "Hola": 10rem-12rem escritorio, 6rem móvil
  • Subtítulo: 1.25rem-1.5rem, color gris (#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.

Skills relacionados