Pular para o conteúdo

Skill Context Degradation

Diagnostique falhas em contextos longos e planeje a recuperação com fatos verificados e comparações por tarefa.

Comunidade · Muratcan Koylan
AutorMuratcan Koylan
LicençaMIT
Fontemuratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md no GitHub
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

A skill context-degradation diagnostica falhas causadas por contexto de agente sobrecarregado, enganoso ou conflitante.

Distingue perda no meio, contaminação, distração, confusão e conflitos. Parte de sintomas e evidências, sem limite universal de tokens.

Do SKILL.md da skill: ## Gotchas

Esta é uma skill da comunidade, de Muratcan Koylan, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Classificar a falha observada e inspecionar seu contexto.
  2. Comparar execuções repetidas com uma base de contexto menor.
  3. Propor recuperação seletiva, compressão, isolamento ou reinício verificado.

O que você recebe

  • Diagnóstico do contexto e plano de experimentos de recuperação.

Quando usar

  • O agente ignora requisitos ou repete erros em sessões longas.

Quando não usar

  • Implementar memória persistente ou atribuir qualquer erro à janela de contexto.

O que ela exige

  • Um agente com arquivos, prompts representativos, rastros e resultados esperados.
  • O exemplo Python simula atenção e usa heurísticas; não é telemetria do modelo nem um detector calibrado.

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdPadrões de falha, comparações diagnósticas e recuperação.
references/patterns.mdDetector ilustrativo em Python e guia de padrões de degradação.
scripts/degradation_detector.pyDetector ilustrativo em Python e guia de padrões de degradação.

Licença conforme encontrada no repositório em 2026-11-20: MIT.

Prompts de exemplo

Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.

  • Diagnostique por que esta sessão longa ignora os critérios de aceitação.
  • Compare contextos curtos e longos antes de recomendar compressão.
  • Planeje um reinício só com fatos verificados e suas fontes.

Como instalar a skill context-degradation

Copiar a pasta completa da skill

Mantenha referências e scripts junto de SKILL.md para resolver caminhos relativos. O plugin instala a coleção de engenharia de contexto.

Ler o guia não exige serviço pago. Experimentos precisam do seu agente e tarefas; modelos podem gerar custos. Upload hospedado e execução API não foram verificados aqui.

Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:

Claude Code: pelo marketplace de plugins

  1. Abra o Claude Code em um terminal com claude.
  2. Adicione o marketplace (uma vez por computador):
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
    /plugin install context-engineering@context-engineering-marketplace
  4. Digite / e procure /context-engineering:context-degradation, ou simplesmente peça a tarefa.

Pelo shell, em vez de dentro de uma sessão:

claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplace

O plugin é instalado inteiro, então outras skills vêm junto, incluindo context-fundamentals, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, tool-design, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops.

Claude Code: copie a pasta para a sua pasta de skills

Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/context-degradation ~/.claude/skills/

O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /context-degradation ou apenas descreva a tarefa.

No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.

Codex, Gemini CLI, Cursor e GitHub Copilot

Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/context-degradation .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservações
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Diagnosticar antes de mudar o sistema

Teste o prompt com menos contexto relevante. Repita execuções para separar variação normal de degradação.

Registre origem e precedência dos fatos importantes. Um resumo menor que preserva erros pode contaminar a próxima sessão.

Limites do detector de exemplo

O script ilustra riscos com curvas simuladas e padrões textuais. Não prova atenção a uma passagem nem a veracidade de uma afirmação.

Valide a recuperação com resultados reais. Registre modelo, prompt, composição do contexto e condições do experimento.

Perguntas sobre a skill context-degradation

O exemplo mede a atenção real do modelo?

Não. Simula curvas e usa contagens aproximadas de tokens e verificações de padrões.

Existe um tamanho de contexto sempre seguro?

Não. Estabeleça uma base por modelo, tarefa e ambiente de execução; não generalize limites ilustrativos.

Todas as respostas devem sobreviver ao reinício?

Não. Preserve fatos verificados com fontes; carregar respostas infundadas pode repetir a falha.

Substitui a compressão do contexto?

Não. Diagnostica e escolhe a recuperação; compressão e memória durável exigem implementação própria.

Mais skills de IA

Skills relacionadas

Categorias de skills