Communitygithub.com

MikeCheng1208/BattleTree

Construa um portfólio no GitHub que consiga uma vaga: selecione de 3 a 5 projetos refinados, crie READMEs atraentes, implante demonstrações ao vivo, conte uma história coesa em seus repositórios e alinhe tudo com funções nativas de IA. Use ao preparar seu GitHub para buscas de emprego, decidir o que fixar ou auditar sua presença pública.

O que é BattleTree?

Esta skill transforma seu perfil do GitHub em uma ferramenta estratégica de carreira, focada em papéis nativos de IA e desenvolvimento de software. Ela ensina que qualidade supera quantidade: ter de três a cinco repositórios bem cuidados vale mais que dezenas de projetos abandonados. Você aprenderá a fixar projetos que contem uma história coerente — por exemplo, de iniciante a construtor de agentes de IA — e a criar READMEs que vendam cada projeto em 30 segundos, com demonstrações ao vivo, capturas de tela e explicações claras de problemas e soluções técnicas. A skill também aborda como alinhar seu portfólio a vagas específicas (como engenheiro de IA/ML, desenvolvedor full-stack com IA ou engenheiro de plataforma), como manter um gráfico de contribuições consistente sem parecer artificial, e inclui uma lista de verificação de auditoria para antes de cada busca de emprego. No final, oferece um comando poderoso para usar o agente como crítico de portfólio, gerando um plano de ação personalizado para melhorar cada repositório fixado.

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

Perguntar na sua IA favorita

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

Documentação

Estratégia de Portfólio

Princípio Central

Seu GitHub não é um cemitério de projetos inacabados. É uma exposição curada. Cada repositório fixado deve responder a uma pergunta que um gerente de contratação tem sobre você — e cada resposta deve fazê-lo querer agendar uma entrevista.

O Que Separa Impressionante de Medíocre

PORTFÓLIO MEDÍOCRE                    PORTFÓLIO IMPRESSIONANTE
─────────────────                     ────────────────────
30 repositórios, a maioria forks      5 repositórios, todos originais
Nenhum README                         Cada README conta uma história
Nenhuma demo ao vivo                  Todo projeto está implantado
Tutoriais aleatórios clonados         Tema claro e progressão
Último commit: 8 meses atrás          Atividade consistente e recente
Nenhuma descrição nos repositórios    Cada repositório tem uma frase
"meu-primeiro-app-react"               "Ferramenta de revisão de código com IA"

A diferença não é talento. É curadoria. Os melhores portfólios parecem de alguém com um plano, não de alguém que commitou tudo que tocou.


Qualidade em vez de Quantidade

Três a cinco projetos refinados superam trinta repositórios abandonados. Sempre.

A Matemática Que Importa

RepositóriosREADMEsImplantadosO Gerente de Contratação Pensa
3020"Começa coisas, não termina"
1551"Experimenta. Não fica claro no que é bom"
554"Focado. Entrega. Conhece seu ofício"
333"Tudo que toca é polido"

A Regra da Limpeza

Antes de adicionar algo novo, audite o que já existe:

1. Arquive ou torne privado qualquer coisa inacabada e irrecuperável.
2. Apague forks que você nunca modificou.
3. Adicione READMEs a tudo que você mantiver público.
4. Defina descrições em todos os repositórios visíveis.
5. O que sobrar deve valer a pena mostrar.

Se você não colocaria no seu currículo, não deveria estar no seu GitHub público.


Conte uma História Através dos Seus Repositórios

Seus repositórios fixados não são amostras aleatórias. São capítulos. Organize-os para que um visitante veja uma narrativa.

Estruturas de História Que Funcionam

O Arco do Especialista:

"Vou fundo em IA/ML e posso provar."

Repositório 1: LLM ajustado para tarefa específica de domínio
Repositório 2: Pipeline RAG com estrutura de avaliação
Repositório 3: Fluxo de trabalho agêntico com uso de ferramentas
Repositório 4: Contribuição open-source para LangChain/LlamaIndex

O Arco do Construtor Full-Stack:

"Construo produtos completos, do banco de dados à implantação."

Repositório 1: App SaaS full-stack (Next.js + API + BD + Autenticação)
Repositório 2: Ferramenta CLI com IA (mostra habilidades de backend/sistemas)
Repositório 3: Biblioteca open-source (mostra pensamento de design de API)
Repositório 4: Ferramenta de automação pessoal (mostra que você constrói para si mesmo)

O Arco do Desenvolvedor Nativo de IA:

"Não apenas uso IA — construo com ela e para ela."

Repositório 1: Fluxo agêntico / sistema multiagente
Repositório 2: Integração de LLM em um aplicativo de nível de produção
Repositório 3: Ferramenta de desenvolvedor que aproveita IA (linter, revisor, gerador)
Repositório 4: Contribuição para um framework ou ferramenta de IA

Sinais de Progressão

Gerentes de contratação notam quando seus repositórios mostram crescimento:

SinalO Que Mostra
Repositório antigo: app CRUD simplesVocê começou em algum lugar
Repositório intermediário: API com testes e CIVocê aprendeu práticas de engenharia
Repositório recente: agente de IA com avaliaçõesVocê está construindo na fronteira
Contribuição para projeto OSS importanteVocê trabalha em bases de código grandes

O Que Fixar e Por Quê

Você pode fixar até seis repositórios. Use-os estrategicamente.

O Layout Ideal de Pinagem

SlotO Que FixarPor Quê
1Projeto full-stackProva que você pode construir um produto completo
2Projeto de IA/MLMostra que você trabalha na fronteira
3Contribuição open-sourceProva que você colabora em bases de código reais
4Ferramenta de desenvolvedor ou CLIMostra que você resolve seus próprios problemas
5Projeto de domínio (sua especialidade)Sinal de profundidade para seu cargo alvo
6Curinga — pessoal ou criativoMostra personalidade e curiosidade genuína

Regras de Pinagem

FIXE:
  - Projetos com demonstrações ao vivo ou links de implantação
  - Repositórios com READMEs completos e capturas de tela
  - Trabalho que corresponda às vagas para as quais você está se candidatando
  - Seu trabalho mais recente e mais polido

NÃO FIXE:
  - Repositórios forkados que você não modificou significativamente
  - Tutoriais seguidos passo a passo (mesmo se concluídos)
  - Repositórios sem README
  - Qualquer coisa que você não consiga explicar em uma entrevista

README Como Seu Discurso de Portfólio

Cada repositório fixado precisa de um README que venda o projeto em 30 segundos. Um gerente de contratação gastará menos tempo que isso antes de decidir se continua lendo.

Estrutura de README para Repositórios de Portfólio

# Nome do Projeto
Descrição de uma frase do que ele faz e por que é importante.

## Demonstração
[Link para demo ao vivo] | [Link para vídeo de demonstração]

Captura de tela ou GIF mostrando o aplicativo em ação.

## O Problema
Que problema isso resolve? Quem tem esse problema?

## Como Funciona
Visão geral da arquitetura. Principais decisões técnicas.
Diagrama se o sistema tiver vários componentes.

## Stack Tecnológica
Lista de tecnologias — mas apenas as significativas.
Não liste HTML/CSS. Liste suas integrações de IA, bancos de dados, destinos de implantação.

## Principais Funcionalidades
- Funcionalidade 1 — por que é interessante tecnicamente
- Funcionalidade 2 — o que foi difícil ao construí-la
- Funcionalidade 3 — o que você melhoraria em seguida

## Primeiros Passos
Instruções claras de configuração. Alguém deve conseguir executar isso em menos de 5 minutos.

## O Que Aprendi
Breve reflexão sobre o desafio técnico mais difícil e como você o resolveu.

Anti-Padrões de README

README RuimREADME Melhor
"Um app React""Resumidor de reuniões com IA que transforma gravações em itens de ação"
Sem capturas de telaCaptura de tela principal ou GIF acima da dobra
Configuração: "clone e execute"Configuração: passo a passo com pré-requisitos listados
Sem explicação da arquiteturaDiagrama do sistema mostrando como os componentes se conectam
Lista todos os pacotes npmDestaca as 3-4 tecnologias que importam

Demonstrações ao Vivo e Links de Implantação

Código é uma hipótese. Um aplicativo implantado é uma prova.

Por Que a Implantação Importa

Gerente de contratação vê repositório sem demo:
  "Código interessante... mas funciona mesmo?"

Gerente de contratação vê repositório com link ao vivo:
  "Deixe-me testar." → 2 minutos depois → "Essa pessoa entrega."

Opções de Implantação por Tipo de Projeto

Tipo de ProjetoImplantação GratuitaIdeal Para
Aplicativo web full-stackVercel, Railway, Fly.ioApps com sensação de produção
API / backendRailway, RenderMostrar habilidades de backend
Site estático / documentaçãoGitHub Pages, NetlifyDocumentação, landing pages
Demonstração de IA/MLHugging Face Spaces, Streamlit CloudDemos de modelo, apps de dados
Ferramenta CLInpm publish, Homebrew tapSinal de distribuição

Se Não Puder Implantar, Grave uma Demonstração

Nem tudo pode rodar na nuvem. Para ferramentas locais, aplicativos CLI ou sistemas complexos:

1. Grave um vídeo de demonstração de 60 a 90 segundos.
2. Envie para o YouTube (não listado é aceitável).
3. Crie um GIF da interação principal.
4. Coloque ambos no README.

Uma demonstração em vídeo é dez vezes melhor que nenhuma demonstração.


Gráfico de Contribuições

O Que a Consistência Sinaliza

Gerentes de contratação dão uma olhada no seu gráfico de contribuições. Veja o que eles realmente interpretam:

PadrãoInterpretação
Verde constante, na maioria dos dias"Essa pessoa programa regularmente. Bom hábito."
Agrupado em torno de projetos"Trabalha em sprints focados. Normal."
Verde apenas em dias úteis"Tem um emprego, ainda assim entrega trabalho pessoal."
Mistura de repositórios próprios e contribuições"Colaborativo. Não apenas projetos solo."

Como a Manipulação Parece

Revisores experientes identificam isso instantaneamente:

BANDEIRAS VERMELHAS:
  - Verde perfeitamente uniforme (todos os dias, mesma intensidade)
  - Commits que são apenas edições de README ou mudanças de espaços em branco
  - 500 commits em um dia em repositórios vazios
  - Dezenas de repositórios criados em uma semana, todos com commits únicos
  - Bots de commit gerados automaticamente

Manipular seu gráfico é pior do que ter lacunas. Isso sinaliza desespero e mau julgamento. Consistência real significa trabalhar em coisas que você gosta em um ritmo regular — lacunas e tudo.

Construindo um Gráfico Real

Em vez de fingir:
  1. Escolha um projeto e trabalhe nele 30 minutos por dia.
  2. Contribua para open source — até documentação, testes ou relatórios de bugs contam.
  3. Mantenha um repositório de aprendizado onde você commit notas e experimentos.
  4. Construa ferramentas que você realmente usa. Você naturalmente continuará melhorando-as.

Alinhando Seu Portfólio à Vaga que Você Quer

Seu portfólio deve parecer uma prévia do trabalho que você faria se fosse contratado. Adapte-o ao seu alvo.

Funções de Desenvolvimento Nativo de IA

Essas funções querem ver que você consegue construir com IA e construir para IA:

SinalExemplo de Repositório
Uso de ferramentas de IA no seu fluxo de trabalhoProjeto com configuração .claude/, commits assistidos por IA, comandos do Claude Code
Fluxos agênticosAgente de várias etapas que pesquisa, planeja e executa tarefas
Integrações de LLMApp com saída estruturada, engenharia de prompt, roteamento de modelos
RAG e recuperaçãoBase de conhecimento com busca por embeddings e métricas de avaliação
Avaliação e testesEstrutura de avaliação de saída de LLM, testes de regressão de prompt
Desenvolvimento assistido por IAREADME do projeto documentando como as ferramentas de IA aceleraram o desenvolvimento

Alvos de Portfólio Específicos para a Função

Função AlvoRepositórios ObrigatóriosBom Ter
Engenheiro de IA/MLModelo ajustado, estrutura de avaliação, pipeline de dadosImplementação de artigo, comparação de modelos
Desenvolvedor Full-Stack de IAApp integrado a LLM, sistema RAG, SaaS implantadoContribuição open-source, ferramenta CLI
Engenheiro de Plataforma / InfraPipeline CI/CD, repositório IaC, configuração de monitoramentoBenchmark de desempenho, contribuição OSS
Ferramentas para Desenvolvedores / DXFerramenta CLI, SDK/biblioteca, extensão VS CodeSite de documentação, ferramenta de comunidade de desenvolvedores

Lista de Verificação de Revisão do Portfólio

Execute esta auditoria antes de cada busca de emprego. Seja honesto.

Primeiras Impressões (30 segundos)

  • Foto de perfil é profissional (ou intencionalmente distinta)
  • Biografia declara o que você faz e o que está procurando
  • Repositórios fixados têm descrições que fazem sentido para um estranho
  • Pelo menos 3 repositórios fixados têm capturas de tela ou links de demonstração no README
  • Nenhum nome de repositório embaraçoso visível na primeira página

Verificação de Profundidade (2 minutos)

  • Cada repositório fixado tem um README que explica o quê, por quê e como
  • Pelo menos um projeto tem uma demonstração ao vivo ou link de implantação
  • Qualidade do código nos repositórios fixados reflete seu nível de habilidade atual
  • Histórico de commits mostra desenvolvimento real (não um único "commit inicial" como bloco)
  • Pelo menos um repositório demonstra testes ou CI/CD

Verificação de História (5 minutos)

  • Seus repositórios fixados contam uma história coerente sobre suas habilidades
  • Há progressão visível de projetos antigos para novos
  • Seu portfólio está alinhado com as funções que você está almejando
  • Você consegue explicar cada repositório fixado em um discurso de elevador de 60 segundos
  • Você se contrataria com base neste GitHub

O Teste Final

Abra seu GitHub em uma janela anônima. Finja que é um gerente de contratação que nunca te conheceu. Gaste 60 segundos. Você passaria este candidato para a próxima rodada?

Se a resposta não for um sim imediato, continue iterando.


Anti-Padrões

Anti-PadrãoPor Que MachucaConserto
Repositórios forkados sem alteraçõesParece enchimentoApague ou torne privado
Clones de tutorial ("todo-app", "weather-app")Sinaliza que você seguiu instruções, não que sabe construirFaça um fork e estenda-o muito além do tutorial
Repositórios vazios ou com apenas um READMESinaliza ideias abandonadasArquive ou apague
Nenhum README em repositórios públicos"Não me comunico sobre meu trabalho"Adicione READMEs a tudo que você manter público
50+ repositórios visíveis sem curadoriaRuído esmagador, nenhum sinalArquive agressivamente, fixe estrategicamente
Repositórios fixados desatualizados (2+ anos)"Não construíram nada recentemente"Alterne os fixos para mostrar trabalho recente
README do perfil com apenas estatísticas geradas automaticamenteImpessoal, baixo esforçoEscreva uma biografia real com seu foco e objetivos
Repositórios chamados "teste", "temp", "asdf"DescuidoRenomeie ou remova

Movimento Poderoso

"Revise meu portfólio do GitHub em [sua URL do GitHub]. Avalie como se você fosse um gerente de contratação para uma função de desenvolvimento nativo de IA. Pontue cada repositório fixado em qualidade do README, profundidade técnica, status de implantação e relevância para funções de IA/ML. Depois, me dê um plano de ação priorizado: o que arquivar, o que melhorar, o que está faltando e que novo projeto faria a maior diferença."

O agente se torna seu crítico de portfólio — fornecendo o feedback honesto e específico que você precisa para transformar seu GitHub de um cemitério de código em um ativo de carreira.

Habilidades Relacionadas

HabilidadeQuando usar
github-profileImplementar mecanismos da plataforma GitHub — README do perfil, fixação de repositórios, tópicos, gráfico de atividade
career-resumeCiclo de carreira completo — busca de emprego, entrevistas, integração, avaliações de desempenho

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.

Habilidades Relacionadas