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_v0 limites 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, Write silenciosamente sobrescreve arquivos existentes. No Claude.ai, create_file se recusa a sobrescrever. Mesma instrução, comportamento oposto.
• Caminhos relativos em references/ quebrados: O padrão oficialmente recomendado references/ 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.