Habilidades do Claude Silenciosamente Substituem Instruções: Armadilhas Não Documentadas Expostas

Um usuário do Reddit investigando Claude Skills encontrou múltiplos comportamentos silenciosos que substituem instruções explícitas, sem documentação em skill-creator. Aqui está o que eles descobriram.
Armadilhas Principais em Claude Skills
ask_user_input_v0limites rígidos: A ferramenta impõe um máximo de 3 perguntas e 4 opções por pergunta. Se uma skill solicitar mais, Claude silenciosamente as compacta. Nenhum erro é gerado.- Inconsistência na escrita de arquivos: No Code/Desktop,
Writesilenciosamente sobrescreve arquivos existentes. No Claude.ai,create_filese recusa a sobrescrever. Mesma instrução, comportamento oposto. - Caminhos relativos em
references/quebrados: O padrão oficialmente recomendadoreferences/não resolve caminhos relativos a partir do diretório da skill em nenhuma plataforma. - Fallback silencioso para ferramentas ausentes: Se uma skill referencia uma ferramenta que não existe na plataforma em execução, Claude recorre a prosa sem qualquer erro ou aviso.
Soluções Práticas
A correção do autor: atualizar skills para fazer múltiplas rodadas quando mais entrada for necessária, contornando os limites do ask_user_input_v0. Para operações de arquivo, sempre use Write no Code/Desktop e create_file com verificações de plataforma no Claude.ai. Evite caminhos relativos em references/; use caminhos absolutos ou conteúdo inline.
Repositório Compartilhado pela Comunidade
As descobertas estão sendo coletadas em um repositório GitHub: github.com/livlign/claude-skills-pitfalls. Contribuições são bem-vindas.
Quem Deve se Importar
Qualquer pessoa construindo ou mantendo Claude Skills, especialmente aqueles que dependem de fluxos de entrada do usuário ou comportamentos entre plataformas.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also

LLM Skirmish: Um Benchmark de Jogo de Estratégia em Tempo Real para Agentes de IA de Codificação
LLM Skirmish é um benchmark onde agentes de IA escrevem código para jogar jogos de estratégia em tempo real 1v1 uns contra os outros. Ele usa uma API modificada do Screeps e testa o aprendizado em contexto ao longo de cinco rodadas de torneio.

Codeset melhora os agentes de codificação com contexto específico do repositório a partir do histórico do git.
O Codeset gera arquivos estáticos a partir do histórico do git que fornecem contexto como bugs anteriores, causas raiz e relações de co-mudança. Testes mostraram uma melhoria de 5,3pp no codeset-gym-python e 2pp no SWE-Bench Pro com o OpenAI Codex.

Escalonador de Habilidades: Crie Habilidades OpenClaw Sem Escrever Código
Skill Scaffolder é uma ferramenta de código aberto que permite aos usuários criar habilidades para o OpenClaw descrevendo o que desejam em inglês simples. Ela gerencia todo o processo — entrevistando os usuários, escrevendo os arquivos da habilidade, testando e instalando — sem exigir YAML, Python ou arquivos de configuração.

ClawProxy: Proxy de Roteamento de IA Auto-Hospedado para Rotação de Chaves de API de Camada Gratuita
ClawProxy é um proxy de roteamento de IA auto-hospedado que gerencia várias chaves de API gratuitas de IA para evitar limites de taxa e sobrecargas de provedores. Ele apresenta rotação de chaves em tempo real, balanceamento de carga ponderado, tradução de modelos e um painel com logs analisados profundamente.