context-optimization
Ajuda seu agente a usar melhor o espaço de informações disponível. Ele comprime e organiza os dados para que o agente possa processar mais informações.
O que ela faz
Esta ferramenta ajuda a IA a usar melhor a memória (contexto) que ela tem disponível. Ela faz isso resumindo informações antigas, guardando apenas o essencial, para que a IA possa lidar com mais dados ou conversas mais longas sem se perder.
Quando usar
- ✓Quando a IA precisa lembrar de muitas informações de uma vez.
- ✓Para fazer a IA responder mais rápido em conversas longas.
- ✓Para processar documentos grandes sem que a IA se perca.
Exemplo do que pedir para a IA
“Resuma esta longa conversa para que eu possa entender os pontos principais.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta identifica o que é mais importante na conversa ou nos documentos que a IA está lendo. Ela então cria resumos ou guarda apenas as partes cruciais, liberando espaço na memória da IA para novas informações.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill context-optimizationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/context-optimization/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Técnicas de Otimização de Contexto
A otimização de contexto estende a capacidade efetiva de janelas de contexto limitadas através de compressão estratégica, mascaramento, cache e particionamento. O objetivo não é aumentar magicamente as janelas de contexto, mas sim fazer melhor uso da capacidade disponível. Uma otimização eficaz pode dobrar ou triplicar a capacidade de contexto efetiva sem a necessidade de modelos maiores ou contextos mais longos.
Quando Usar
Ative esta funcionalidade quando:
- Limites de contexto restringem a complexidade da tarefa
- Otimizando para redução de custos (menos tokens = custos menores)
- Reduzindo a latência para conversas longas
- Implementando sistemas de agentes de longa duração
- Precisando lidar com documentos ou conversas maiores
- Construindo sistemas de produção em escala
Conceitos Principais
A otimização de contexto estende a capacidade efetiva através de quatro estratégias principais: compactação (resumindo o contexto próximo aos limites), mascaramento de observação (substituindo saídas verbosas por referências), otimização de KV-cache (reutilizando computações em cache) e particionamento de contexto (dividindo o trabalho entre contextos isolados).
A percepção chave é que a qualidade do contexto importa mais do que a quantidade. A otimização preserva o sinal enquanto reduz o ruído. A arte reside em selecionar o que manter versus o que descartar, e quando aplicar cada técnica.
Tópicos Detalhados
Estratégias de Compactação
O que é Compactação Compactação é a prática de resumir o conteúdo do contexto ao se aproximar dos limites, e então reinicializar uma nova janela de contexto com o resumo. Isso destila o conteúdo de uma janela de contexto de maneira de alta fidelidade, permitindo que o agente continue com degradação mínima de desempenho.
A compactação geralmente serve como a primeira alavanca na otimização de contexto. A arte reside em selecionar o que manter versus o que descartar.
Implementação de Compactação A compactação funciona identificando seções que podem ser comprimidas, gerando resumos que capturam pontos essenciais e substituindo o conteúdo completo por resumos. A prioridade para compressão vai para saídas de ferramentas (substituir por resumos), turnos antigos (resumir conversas iniciais), documentos recuperados (resumir se houver versões recentes) e nunca comprimir o prompt do sistema.
Geração de Resumos Resumos eficazes preservam diferentes elementos dependendo do tipo de mensagem:
Saídas de ferramentas: Preservam descobertas chave, métricas e conclusões. Removem a saída bruta e verbosa.
Turnos de conversação: Preservam decisões chave, compromissos e mudanças de contexto. Removem preenchimento e idas e vindas.
Documentos recuperados: Preservam fatos e alegações chave. Removem evidências de suporte e elaboração.
Mascaramento de Observação
O Problema da Observação Saídas de ferramentas podem compor 80%+ do uso de tokens em trajetórias de agentes. Grande parte disso é saída verbosa que já cumpriu seu propósito. Uma vez que um agente usou uma saída de ferramenta para tomar uma decisão, manter a saída completa oferece valor decrescente enquanto consome contexto significativo.
O mascaramento de observação substitui saídas de ferramentas verbosas por referências compactas. A informação permanece acessível se necessário, mas não consome contexto continuamente.
Seleção de Estratégia de Mascaramento Nem todas as observações devem ser mascaradas igualmente:
Nunca mascarar: Observações críticas para a tarefa atual, observações do turno mais recente, observações usadas em raciocínio ativo.
Considerar mascarar: Observações de 3+ turnos atrás, saídas verbosas com pontos chave extraíveis, observações cujo propósito foi cumprido.
Sempre mascarar: Saídas repetidas, cabeçalhos/rodapés boilerplate, saídas já resumidas na conversa.
Otimização de KV-Cache
Entendendo o KV-Cache O KV-cache armazena tensores de Chave (Key) e Valor (Value) computados durante a inferência, crescendo linearmente com o comprimento da sequência. Armazenar o KV-cache em cache entre requisições que compartilham prefixos idênticos evita a recomputação.
O prefix caching reutiliza blocos de KV entre requisições com prefixos idênticos usando correspondência de blocos baseada em hash. Isso reduz drasticamente o custo e a latência para requisições com prefixos comuns, como prompts do sistema.
Padrões de Otimização de Cache Otimize para caching reordenando elementos de contexto para maximizar acertos de cache. Coloque elementos estáveis primeiro (prompt do sistema, definições de ferramentas), depois elementos frequentemente reutilizados, e elementos únicos por último.
Projete prompts para maximizar a estabilidade do cache: evite conteúdo dinâmico como timestamps, use formatação consistente, mantenha a estrutura estável entre sessões.
Particionamento de Contexto
Particionamento por Sub-Agente
…
Perguntas frequentes
Isso faz a memória da IA ficar maior?
Não, ela não aumenta a memória da IA, mas a faz usar o espaço que já existe de forma mais inteligente.
A IA vai esquecer coisas importantes?
O objetivo é justamente o contrário. A ferramenta foca em guardar o que é essencial e descartar o que é menos importante ou repetitivo, para não perder o fio da meada.
Quando devo usar essa ferramenta?
Use quando a IA parecer confusa com muitas informações, quando as respostas demorarem muito, ou quando você precisar que ela processe textos extensos.
Detalhes
Descrição original do autor
Context optimization extends the effective capacity of limited context windows through strategic compression, masking, caching, and partitioning. The goal is not to magically increase context windows but to make better use of available capacity.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2645
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC