Communitygithub.com

MikeCheng1208/BattleTree

Construye un portafolio en GitHub que te consiga trabajo: selecciona de 3 a 5 proyectos pulidos, redacta README atractivos, despliega demos en vivo, cuenta una historia coherente entre tus repositorios y alinea todo con roles de desarrollo nativo en IA. Úsalo al preparar tu GitHub para búsquedas laborales, decidir qué fijar o auditar tu presencia pública.

¿Qué es BattleTree?

BattleTree es una habilidad de agente de IA especializada en la curaduría estratégica de portafolios en GitHub, diseñada para profesionales del desarrollo de software que buscan roles nativos en IA. Proporciona un marco integral para transformar un perfil de GitHub genérico en una exhibición pulida que maximice la empleabilidad. La habilidad cubre desde la poda de repositorios innecesarios y la escritura de README convincentes, hasta el despliegue de demos en vivo y la alineación de proyectos con arcos narrativos específicos como el de 'Especialista en IA' o 'Desarrollador Full-Stack'. Funciona en cualquier plataforma de IA que soporte habilidades de agente (Claude Code, Cursor, Codex, etc.) y se activa durante la preparación para búsquedas laborales o auditorías de presencia pública. Su enfoque principal es la calidad sobre la cantidad, guiando al usuario para que sus repositorios fijados cuenten una historia coherente de crecimiento y competencia técnica, especialmente en el ámbito de la IA.

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

Preguntar en tu IA favorita

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

Documentación

Estrategia de Portafolio

Principio Fundamental

Tu GitHub no es un cementerio de proyectos a medio terminar. Es una exhibición curada. Cada repositorio fijado debe responder una pregunta que un reclutador tiene sobre ti — y cada respuesta debe hacer que quieran agendarte una entrevista.

Lo Que Separa lo Impresionante de lo Mediocre

PORTAFOLIO MEDIOCRE                    PORTAFOLIO IMPRESIONANTE
─────────────────                     ────────────────────
30 repositorios, en su mayoría forks   5 repositorios, todo trabajo original
Sin READMEs                            Cada README cuenta una historia
Sin demos en vivo                      Cada proyecto está desplegado
Tutoriales aleatorios clonados         Tema y progresión claros
Último commit: hace 8 meses            Actividad consistente y reciente
Sin descripciones en los repos           Cada repositorio tiene un resumen
"mi-primer-react-app"                  "Herramienta de revisión de código impulsada por IA"

La diferencia no es el talento. Es la curaduría. Los mejores portafolios parecen hechos por alguien con un plan, no por alguien que hace commit de todo lo que toca.


Calidad Sobre Cantidad

De tres a cinco proyectos pulidos superan a treinta repositorios abandonados. Siempre.

Las Matemáticas Que Importan

ReposREADMEDesplegadosEl Reclutador Piensa
3020"Empieza cosas, no las termina"
1551"Experimenta. No está claro en qué es bueno"
554"Enfocado. Entrega. Conoce su oficio"
333"Todo lo que toca está pulido"

La Regla de Limpieza

Antes de agregar algo nuevo, audita lo que ya tienes:

1. Archiva o haz privado cualquier cosa inacabada e irrecuperable.
2. Elimina los forks de repositorios que nunca modificaste.
3. Agrega README a todo lo que mantengas público.
4. Establece descripciones en cada repositorio visible.
5. Lo que quede debe valer la pena mostrarlo.

Si no lo pondrías en tu currículum, no debería estar en tu GitHub público.


Cuenta una Historia a Través de Tus Repos

Tus repositorios fijados no son muestras aleatorias. Son capítulos. Organízalos para que un visitante vea una narrativa.

Estructuras de Historia Que Funcionan

El Arco del Especialista:

"Profundizo en IA/ML y puedo probarlo."

Repositorio 1: LLM ajustado para una tarea específica del dominio
Repositorio 2: Pipeline RAG con marco de evaluación
Repositorio 3: Flujo de trabajo agéntico con uso de herramientas
Repositorio 4: Contribución open-source a LangChain/LlamaIndex

El Arco del Constructor Full-Stack:

"Construyo productos completos desde la base de datos hasta el despliegue."

Repositorio 1: App SaaS full-stack (Next.js + API + DB + Auth)
Repositorio 2: Herramienta CLI impulsada por IA (muestra habilidades de backend/sistemas)
Repositorio 3: Librería open-source (muestra pensamiento de diseño de API)
Repositorio 4: Herramienta de automatización personal (muestra que también construyes para ti)

El Arco del Desarrollador Nativo en IA:

"No solo uso IA — construyo con ella y para ella."

Repositorio 1: Flujo de trabajo agéntico / sistema multi-agente
Repositorio 2: Integración de LLM en una app de nivel de producción
Repositorio 3: Herramienta para desarrolladores que aprovecha la IA (linter, revisor, generador)
Repositorio 4: Contribución a un framework o cadena de herramientas de IA

Señales de Progresión

Los reclutadores notan cuando tus repositorios muestran crecimiento:

SeñalLo Que Muestra
Repositorio temprano: app CRUD simpleEmpezaste en algún lugar
Repositorio intermedio: API con tests y CIAprendiste prácticas de ingeniería
Repositorio reciente: agente de IA con evaluacionesEstás construyendo en la frontera
Contribución a un proyecto OSS importantePuedes trabajar en bases de código grandes

Qué Fijar y Por Qué

Tienes seis repositorios fijados. Úsalos estratégicamente.

La Distribución Ideal de Fijados

EspacioQué FijarPor Qué
1Proyecto full-stackPrueba que puedes construir un producto completo
2Proyecto de IA/MLMuestra que trabajas en la frontera
3Contribución open-sourcePrueba que colaboras en bases de código reales
4Herramienta para desarrolladores o CLIMuestra que resuelves tus propios problemas
5Proyecto de dominio (tu especialidad)Señal de profundidad para tu rol objetivo
6Comodín — personal o creativoMuestra personalidad y curiosidad genuina

Reglas de Fijación

SÍ fijar:
  - Proyectos con demos en vivo o enlaces de despliegue
  - Repositorios con README exhaustivos y capturas de pantalla
  - Trabajo que coincida con los roles a los que estás postulando
  - Tu trabajo más reciente y más pulido

NO fijar:
  - Repositorios fork que no modificaste significativamente
  - Seguir tutoriales (incluso si los completaste)
  - Repositorios sin README
  - Cualquier cosa que no puedas explicar en una entrevista

README Como tu Presentación de Portafolio

Cada repositorio fijado necesita un README que venda el proyecto en 30 segundos. Un reclutador gastará menos tiempo que eso antes de decidir si seguir leyendo.

Estructura del README para Repositorios de Portafolio

# Nombre del Proyecto
Descripción de una oración sobre qué hace y por qué importa.

## Demo
[Enlace a demo en vivo] | [Enlace a video demostrativo]

Captura de pantalla o GIF mostrando la aplicación en acción.

## El Problema
¿Qué problema resuelve esto? ¿Quién tiene este problema?

## Cómo Funciona
Visión general de la arquitectura. Decisiones técnicas clave.
Diagrama si el sistema tiene múltiples componentes.

## Stack Tecnológico
Lista de tecnologías — pero solo las significativas.
No enumeres HTML/CSS. Hazlo con tus integraciones de IA, bases de datos, objetivos de despliegue.

## Características Clave
- Característica 1 — por qué es interesante técnicamente
- Característica 2 — qué fue difícil al construirla
- Característica 3 — qué mejorarías a continuación

## Primeros Pasos
Instrucciones claras de configuración. Alguien debería poder ejecutar esto en menos de 5 minutos.

## Lo Que Aprendí
Breve reflexión sobre el desafío técnico más difícil y cómo lo resolviste.

Anti-patrones del README

Mal READMEMejor README
"Una app de React""Resumidor de reuniones impulsado por IA que convierte grabaciones en elementos de acción"
Sin capturas de pantallaCaptura de pantalla principal o GIF arriba del pliegue
Configuración: "clonar y ejecutar"Configuración: paso a paso con requisitos previos listados
Sin explicación de la arquitecturaDiagrama del sistema que muestra cómo se conectan los componentes
Enumera todos los paquetes npmDestaca las 3-4 tecnologías que importan

Demos en Vivo y Enlaces de Despliegue

El código es una hipótesis. Una aplicación desplegada es una prueba.

Por Qué el Despliegue Importa

Reclutador ve repositorio sin demo:
  "Código interesante... ¿realmente funciona?"

Reclutador ve repositorio con enlace en vivo:
  "Déjame probarlo." → 2 minutos después → "Esta persona entrega."

Opciones de Despliegue por Tipo de Proyecto

Tipo de ProyectoDespliegue GratuitoBueno Para
App web full-stackVercel, Railway, Fly.ioApps con sensación de producción
API / backendRailway, RenderMostrar habilidades de backend
Sitio estático / docsGitHub Pages, NetlifyDocumentación, páginas de aterrizaje
Demo de IA/MLHugging Face Spaces, Streamlit CloudDemos de modelos, aplicaciones de datos
Herramienta CLInpm publish, Homebrew tapSeñal de distribución

Si No Puedes Desplegar, Graba un Demo

No todo se puede ejecutar en la nube. Para herramientas solo locales, apps CLI o sistemas complejos:

1. Graba un video demostrativo de 60-90 segundos.
2. Súbelo a YouTube (no listado está bien).
3. Crea un GIF de la interacción clave.
4. Pon ambos en el README.

Un video demo es diez veces mejor que ningún demo.


Gráfico de Contribuciones

Lo Que la Consistencia Señala

Los reclutadores echan un vistazo a tu gráfico de contribuciones. Esto es lo que realmente leen:

PatrónInterpretación
Verde constante, la mayoría de los días"Esta persona programa regularmente. Buen hábito."
Agrupaciones alrededor de proyectos"Trabaja en sprints enfocados. Normal."
Verde solo entre semana"Tiene trabajo, aún así entrega trabajo personal."
Mezcla de repositorios propios y contribuciones"Colaborativo. No solo proyectos en solitario."

Cómo se Ve Hacer Trampa

Los revisores experimentados pueden detectar esto al instante:

SEÑALES DE ALARMA:
  - Verde perfectamente uniforme (todos los días, misma intensidad)
  - Commits que son solo ediciones de README o cambios de espacios en blanco
  - 500 commits en un día en repositorios vacíos
  - Decenas de repositorios creados en una semana, todos con un solo commit
  - Bots de commits generados automáticamente

Hacer trampa en tu gráfico es peor que tener lagunas. Señala desesperación y mal juicio. Consistencia real significa trabajar en cosas que te importan con una cadencia regular — lagunas y todo.

Construyendo un Gráfico Real

En lugar de fingir:
  1. Escoge un proyecto y trabaja en él 30 minutos al día.
  2. Contribuye a open source — incluso docs, tests o reportes de errores cuentan.
  3. Mantén un repositorio de aprendizaje donde hagas commit de notas y experimentos.
  4. Construye herramientas que realmente uses. Mejorarás naturalmente.

Alineando tu Portafolio al Rol Que Quieres

Tu portafolio debe parecer un adelanto del trabajo que harías si te contrataran. Adáptalo a tu objetivo.

Roles de Desarrollo Nativo en IA

Estos roles quieren ver que puedes construir con IA y construir para IA:

SeñalEjemplo de Repositorio
Uso de herramientas de IA en tu flujo de trabajoProyecto con config .claude/, commits asistidos por IA, comandos slash de Claude Code
Flujos de trabajo agénticosAgente multi-paso que investiga, planifica y ejecuta tareas
Integraciones de LLMApp con salida estructurada, ingeniería de prompts, enrutamiento de modelos
RAG y recuperaciónBase de conocimiento con búsqueda de embeddings y métricas de evaluación
Evaluación y pruebasMarco de evaluación de salida de LLM, tests de regresión de prompts
Desarrollo asistido por IAREADME del proyecto documentando cómo las herramientas de IA aceleraron el desarrollo

Objetivos de Portafolio por Rol Específico

Rol ObjetivoRepositorios ImprescindiblesNice-to-Have
Ingeniero de IA/MLModelo ajustado, marco de evaluación, pipeline de datosImplementación de paper, comparación de modelos
Desarrollador Full-Stack de IAApp integrada con LLM, sistema RAG, SaaS desplegadoContribución open-source, herramienta CLI
Ingeniero de Plataforma / InfraPipeline CI/CD, repo de IaC, configuración de monitoreoBenchmark de rendimiento, contribución OSS
Herramientas para Desarrolladores / DXHerramienta CLI, SDK/librería, extensión de VS CodeSitio de docs, herramienta de comunidad para desarrolladores

Lista de Verificación de Revisión del Portafolio

Realiza esta auditoría antes de cada búsqueda de empleo. Sé honesto.

Primera Impresión (30 segundos)

  • La foto de perfil es profesional (o intencionalmente distintiva)
  • La biografía indica qué haces y qué buscas
  • Los repositorios fijados tienen descripciones que tienen sentido para un extraño
  • Al menos 3 repositorios fijados tienen capturas de pantalla o enlaces de demo en el README
  • Ningún nombre de repositorio embarazoso visible en la primera página

Verificación de Profundidad (2 minutos)

  • Cada repositorio fijado tiene un README que explica el qué, el por qué y el cómo
  • Al menos un proyecto tiene un demo en vivo o enlace de despliegue
  • La calidad del código en los repositorios fijados refleja tu nivel de habilidad actual
  • El historial de commits muestra desarrollo real (no un solo blob de "commit inicial")
  • Al menos un repositorio demuestra testing o CI/CD

Verificación de Historia (5 minutos)

  • Tus repositorios fijados cuentan una historia coherente sobre tus habilidades
  • Hay una progresión visible de proyectos más antiguos a más nuevos
  • Tu portafolio está alineado con los roles a los que te diriges
  • Puedes explicar cada repositorio fijado en una presentación de 60 segundos
  • Te contratarías a ti mismo basándote en este GitHub

La Prueba Definitiva

Abre tu GitHub en una ventana de incógnito. Pretende que eres un reclutador que nunca te ha conocido. Pasa 60 segundos. ¿Pasarías a este candidato a la siguiente ronda?

Si la respuesta no es un sí inmediato, sigue iterando.


Anti-patrones

Anti-patrónPor Qué DueleSolución
Repositorios fork sin cambiosParece rellenoElimina o haz privado
Clones de tutoriales ("todo-app", "weather-app")Señala que seguiste instrucciones, no que sabes construirHaz fork, luego extiéndelo mucho más allá del tutorial
Repositorios vacíos o con solo un READMESeñala ideas abandonadasArchívalos o elimínalos
Sin README en repositorios públicos"No comunico sobre mi trabajo"Agrega README a todo lo que mantengas público
50+ repositorios visibles sin curaduríaRuido abrumador, sin señalArchiva agresivamente, fija estratégicamente
Repositorios fijados desactualizados (2+ años)"No han construido nada recientemente"Rota los fijados para mostrar trabajo reciente
README de perfil solo con estadísticas generadas automáticamenteImpersonal, poco esfuerzoEscribe una biografía real con tu enfoque y objetivos
Repositorios llamados "test", "temp", "asdf"DescuidadoRenómbralos o elimínalos

Movimiento Poderoso

"Revisa mi portafolio de GitHub en [tu URL de GitHub]. Evalúalo como si fueras un reclutador para un rol de desarrollo nativo en IA. Puntúa cada repositorio fijado en calidad del README, profundidad técnica, estado del despliegue y relevancia para roles de IA/ML. Luego dame un plan de acción priorizado: qué archivar, qué mejorar, qué falta y qué nuevo proyecto haría la mayor diferencia."

El agente se convierte en tu crítico de portafolio — dándote la retroalimentación honesta y específica que necesitas para convertir tu GitHub de un cementerio de código en un activo profesional.

Habilidades Relacionadas

HabilidadCuándo Usarla
github-profileImplementar mecánicas de plataforma de GitHub — README de perfil, fijación de repos, temas, gráfico de actividad
career-resumeCiclo de vida profesional completo — búsqueda de empleo, entrevistas, incorporación, revisiones de rendimiento

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 relacionados