tool-use-guardian
Faz seu agente lidar melhor com falhas de ferramentas. Ele monitora, tenta novamente e corrige erros. Garante que as tarefas continuem mesmo com problemas técnicos inesperados.
O que ela faz
Este é um assistente que ajuda a garantir que as ferramentas que a IA usa funcionem corretamente. Ele tenta novamente chamadas que falham, conserta respostas quebradas e aprende quais ferramentas não são confiáveis.
Quando usar
- ✓Quando uma ferramenta retorna dados incompletos ou mal formatados.
- ✓Quando uma ferramenta demora muito para responder ou é bloqueada temporariamente.
- ✓Quando uma sequência de tarefas falha no meio do caminho.
Exemplo do que pedir para a IA
“Tente novamente chamar a ferramenta de busca de clima, ela está retornando um erro.”
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
Antes de usar uma ferramenta, ele verifica se tudo está certo. Se a ferramenta falhar, ele tenta consertar ou chamar novamente, aprendendo com os erros para evitar problemas futuros.
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 tool-use-guardianOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/tool-use-guardian/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.
Guardian de Uso de Ferramentas
Visão Geral
O invólucro de confiabilidade que todo agente de IA precisa. Monitora chamadas de ferramentas, tenta novamente falhas automaticamente, corrige respostas truncadas e aprende quais ferramentas são não confiáveis — para que você nunca perca sua cadeia de pensamento.
Grátis para sempre. Construído pelo Genesis Agent Marketplace.
Instalar
npx skills add christopherlhammer11-ai/tool-use-guardian
Quando Usar Esta Habilidade
- Use quando as chamadas de ferramentas retornarem JSON truncado ou malformado
- Use quando as APIs expirarem ou limitarem seu agente no meio da tarefa
- Use quando uma cadeia de várias etapas quebrar no meio do caminho
- Use quando você precisar de lógica de nova tentativa automática sem escrevê-la você mesmo
- Use para qualquer fluxo de trabalho de agente que dependa da confiabilidade de ferramentas externas
Como Funciona
Etapa 1: Validação Pré-Chamada
Antes de cada chamada de ferramenta, o Guardian valida:
- Parâmetros obrigatórios estão presentes e com o tipo correto
- A ferramenta não está marcada como "não confiável" por falhas anteriores
- O tamanho da requisição está dentro dos limites conhecidos
Etapa 2: Classificação de Falha
Quando uma chamada de ferramenta falha, o Guardian classifica a falha em uma de 9 categorias:
| Tipo de Falha | Ação de Recuperação |
|---|---|
| JSON Truncado | Refazer com paginação ou blocos menores |
| Tempo Limite da API | Tentar novamente uma vez com requisição mais simples, depois decompor |
| Limite de Taxa (429) | Backoff exponencial, máximo de 3 tentativas |
| Autenticação Expirada | Sinalizar para intervenção do usuário |
| Quebra no Meio da Cadeia | Retomar do último ponto de verificação bem-sucedido |
| Erro como 200 | Detectar {"error": "..."} disfarçado de sucesso |
| Incompatibilidade de Esquema | Tentar coerção automática, avisar se houver perda de dados |
| Falha de Rede | Tentar novamente com jitter, máximo de 2 tentativas |
| Erro Desconhecido | Registrar contexto completo, escalar para o usuário |
Etapa 3: Proteção da Cadeia
Para cadeias de ferramentas de várias etapas, o Guardian mantém pontos de verificação. Se a etapa 4 de 7 falhar, ele retoma da etapa 4 — nunca reinicia do zero.
Etapa 4: Aprendizado
O Guardian rastreia padrões de falha por ferramenta. Após 3 ou mais falhas do mesmo tipo, ele marca a ferramenta como não confiável e sugere alternativas.
Melhores Práticas
- ✅ Deixe o Guardian envolver todas as chamadas de ferramentas externas automaticamente
- ✅ Revise os relatórios de confiabilidade do Guardian para identificar ferramentas instáveis
- ✅ Use a recuperação de ponto de verificação para cadeias longas
- ❌ Não desative a lógica de nova tentativa para APIs com limite de taxa
- ❌ Não ignore avisos de falha repetida
Habilidades Relacionadas
@recallmax- Aprimoramento de memória de contexto longo (também grátis do Genesis Marketplace)
Links
- Repositório: https://github.com/christopherlhammer11-ai/tool-use-guardian
- Marketplace: https://genesis-node-api.vercel.app
- Navegar por habilidades: https://genesis-marketplace.vercel.app
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.
Perguntas frequentes
O que acontece se uma ferramenta falhar?
Ele tenta consertar a resposta, chama a ferramenta novamente ou aprende que a ferramenta não é confiável e sugere outra.
O que é 'chain of thought'?
É a sequência de passos que a IA segue para completar uma tarefa. Se um passo falha, a IA pode se perder. Este assistente ajuda a manter a sequência funcionando.
É seguro usar?
Sim, ele foi feito para tornar as interações da IA com outras ferramentas mais confiáveis e seguras.
Detalhes
Descrição original do autor
FREE — Intelligent tool-call reliability wrapper. Monitors, retries, fixes, and learns from tool failures. Auto-recovers from truncated JSON, timeouts, rate limits, and mid-chain failures.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4390
- 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
bun-runtime
Faz seu agente usar o Bun para rodar, organizar e testar código. Ajuda a escolher o Bun em vez de outras ferramentas e a migrar projetos existentes.
affaan-m/ECC
database-migrations
Ajuda seu agente a fazer mudanças seguras em bancos de dados. Ele garante que as alterações possam ser desfeitas e minimiza o tempo de inatividade.
affaan-m/ECC
deployment-patterns
Configura fluxos de implantação e CI/CD, containerização e estratégias de rollback para garantir lançamentos seguros.
affaan-m/ECC