O limite prático da janela de contexto
Quando os repositórios públicos de skills para agentes de IA começaram a se multiplicar, o reflexo imediato de quem desenvolve foi tentar carregar tudo. Repositórios da AWS, Google Cloud, Microsoft e comunidade reúnem centenas de arquivos SKILL.md repletos de boas práticas, scripts e arquiteturas de referência.
O problema dessa abordagem é matemático. Um acervo com mais de 500 skills consome dezenas de milhares de tokens antes mesmo da primeira instrução enviada ao agente. A janela de contexto, que deveria estar livre para o código do projeto e para o raciocínio da tarefa, é engolida por manuais que talvez nunca sejam lidos naquela sessão.
A alternativa manual também cobra pedágio: abrir diretórios, escolher duas ou três skills específicas para cada tarefa pontual e desinstalá-las depois cansa rápido.
O conceito: rotear em vez de entulhar
O Jump Skills Ninjas aborda esse problema dividindo o conhecimento em camadas. Em vez de carregar centenas de arquivos de uma só vez, o sistema opera com meta-skills chamadas Jump Skills.
Cada Ninja atua como um despachante técnico de um domínio específico. Na inicialização do agente, ele injeta apenas um catálogo de metadados enxuto, que ocupa por volta de 500 tokens. O fluxo funciona em quatro etapas diretas:
- Interpretação: o Ninja analisa o objetivo da solicitação enviada ao agente.
- Roteamento: identifica no catálogo qual skill especializada domina aquele problema.
- Carga sob demanda: puxa o conteúdo integral da skill apenas no momento do uso.
- Execução: o agente resolve a demanda com o contexto técnico completo do especialista.
Isso transforma a biblioteca de contexto: em vez de carregar todos os livros na mochila, o agente consulta o fichário e retira da estante apenas o volume necessário.
O catálogo dos Ninjas
O sistema distribui mais de 500 skills em combatentes especialistas, agrupados por nuvem e plataforma:
| Ninja | Plataforma / Domínio | Skills | Cobertura técnica principal |
|---|---|---|---|
| AWS Ninja | Amazon Web Services | 230+ | EKS, Lambda, DynamoDB, Bedrock, CDK, Security Hub |
| Azure Ninja | Microsoft Azure | 40 | AKS, App Service, Entra ID, AI Foundry, DevOps |
| GCloud Ninja | Google Cloud Platform | 85+ | GKE, BigQuery, Cloud Run, Cloud Spanner, IAM |
| AI Ninja | Google AI | 25+ | Gemini API, Agent Platform, Genkit, fluxos de RAG |
| Mobile Ninja | Google / Mobile | 35+ | Android Nativo, Jetpack Compose, Flutter, Dart |
| Firebase Ninja | Google Firebase | 18+ | Firestore, Firebase Auth, Cloud Functions, Hosting |
| Ads Ninja | Google Ads | 15+ | Ads API, Google Mobile Ads SDK, Interactive Media Ads |
| Analytics Ninja | Google Analytics | 3+ | GA4 Admin API, Data API, extração de relatórios |
| Firecrawl Ninja | Firecrawl | 33 | Web scraping avançado, deep research, crawling inteligente |
| Datadog Ninja | Datadog | 57 | APM, logs, monitores, LLM Ops, observabilidade de agentes |
Cada ninja mantém o isolamento do seu respectivo ecossistema, permitindo alternar entre arquiteturas sem conflito de definições.
Note (Estrutura Modular)
Embora o núcleo histórico do projeto tenha nascido em torno dos 9 ninjas de cloud e desenvolvimento, integrações recentes como o Datadog Ninja expandiram o ecossistema para monitoramento e observabilidade contínua de agentes.
Onde cada projeto se encaixa no ecossistema
É importante separar as responsabilidades dentro do trabalho com agentes de IA:
- Agentic Skills: minha biblioteca aberta de skills pontuais e workflows utilitários (revisão de copy, SEO, design system, propostas e automações diárias). São módulos autônomos para qualquer agente.
- AWS Ninja: o projeto pioneiro onde validei o padrão de roteamento em catálogo para mais de 200 skills da Amazon. Funciona como uma jump skill única e dedicada.
- Jump Skills Ninjas: o sistema orquestrador multi-tenant e multi-cloud. Ele padroniza a arquitetura do AWS Ninja para múltiplos provedores, oferecendo um catálogo unificado que pode ser acionado por comandos ou seletores sem amarras a uma única nuvem.
Como instalar
O Jump Skills é um meta-repositório que gerencia fontes externas sincronizadas localmente. Por depender de caminhos locais sincronizados, a instalação é realizada diretamente via terminal:
# 1. Clonar o repositório principalgit clone https://github.com/fabricioctelles/jump-skills.gitcd jump-skills
# 2. Sincronizar todos os repositórios de skills de cada provedor./sync-repos.sh
# 3. Gerar e instalar os ninjas nos agentes configurados no sistema./install-ninjas.shDepois de instalado, o agente ganha acesso imediato aos comandos ou ao roteamento automático. Se você estiver usando Claude Code, Cursor ou Kiro, basta chamar o comando do especialista:
/aws-ninja Configure an EKS cluster with Karpenter autoscaling and private endpointsO roteador detecta a necessidade de eks-design e eks-karpenter, carrega as diretrizes correspondentes e entrega a arquitetura pronta sem exigir que você memorize o nome de centenas de arquivos.
Tip (Atualizações)
Para atualizar o catálogo quando novos serviços forem lançados pelos provedores de nuvem, basta rodar ./sync-repos.sh novamente na raiz do repositório.
Compatibilidade entre agentes
O padrão de Jump Skills respeita o formato agnóstico de Agent Skills (SKILL.md). Os scripts de instalação reconhecem e configuram o suporte automaticamente em mais de 36 ferramentas:
- Ferramentas de terminal: Claude Code, Kiro CLI, Codex CLI, Gemini CLI, OpenCode.
- IDEs e editores com IA: Cursor, Windsurf, GitHub Copilot, Void.
- Extensões de ambiente: Cline, Roo Code, Continue, Aider.
Toda a lógica fica salva em arquivos locais, sem envio de telemetria ou necessidade de servidores intermediários rodando em segundo plano.
Interface e código aberto
A experiência visual do projeto segue uma linha arcade com estética terminal verde fósforo, scanlines de tubo CRT e seleção de lutadores, acessível no ar:
- Landing page: jumpskills.ninja
- Código-fonte no GitHub: github.com/fabricioctelles/jump-skills
O projeto é distribuído sob licença MIT, mantendo intactas as licenças originais dos repositórios de cada provedor integrado.