shellcheck-configuration
Ajuda seu agente a verificar a qualidade de scripts de shell. É útil para encontrar e corrigir erros, e para garantir que os scripts funcionem em diferentes sistemas.
O que ela faz
Este guia ensina como usar o ShellCheck para encontrar erros e melhorar a qualidade de seus scripts de programação. Ele ajuda a garantir que seus scripts funcionem bem em diferentes ambientes.
Quando usar
- ✓Ao configurar ferramentas para verificar seus scripts automaticamente.
- ✓Quando você quer corrigir problemas em um script já existente.
- ✓Para entender os avisos e erros que o ShellCheck mostra.
Exemplo do que pedir para a IA
“Como configuro o ShellCheck para verificar meus scripts antes de enviá-los para o controle de versão?”
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
O ShellCheck analisa seu código de script sem executá-lo, procurando por padrões que geralmente causam problemas. Ele te avisa sobre esses problemas para que você possa corrigi-los.
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 wshobson/agents --skill shellcheck-configurationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/shell-scripting/skills/shellcheck-configuration/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.
Configuração e Análise Estática do ShellCheck
Orientação abrangente para configurar e usar o ShellCheck para melhorar a qualidade de scripts shell, identificar armadilhas comuns e impor melhores práticas através de análise estática de código.
Quando Usar Esta Habilidade
- Configurar linting para scripts shell em pipelines de CI/CD
- Analisar scripts shell existentes em busca de problemas
- Entender códigos de erro e avisos do ShellCheck
- Configurar o ShellCheck para requisitos específicos do projeto
- Integrar o ShellCheck em fluxos de trabalho de desenvolvimento
- Suprimir falsos positivos e configurar conjuntos de regras
- Impor padrões consistentes de qualidade de código
- Migrar scripts para atender a portões de qualidade
Padrões Detalhados e Exemplos Práticos
A documentação detalhada de padrões está em references/details.md. Leia esse arquivo quando o nível de navegação acima for insuficiente.
Melhores Práticas
- Execute o ShellCheck em CI/CD - Identifique problemas antes de mesclar
- Configure para seu shell de destino - Não analise bash como sh
- Documente exclusões - Explique por que as violações são suprimidas
- Resolva violações - Não apenas desabilite avisos
- Habilite o modo rigoroso - Use
--enable=allcom exclusões cuidadosas - Atualize regularmente - Mantenha o ShellCheck atualizado para novas verificações
- Use hooks de pré-commit - Identifique problemas localmente antes de enviar
- Integre com editores - Obtenha feedback em tempo real durante o desenvolvimento
Perguntas frequentes
O que é 'linting'?
Linting é o processo de analisar seu código para encontrar erros de estilo, bugs potenciais e outros problemas antes de executar o programa.
Por que é importante configurar o ShellCheck para o meu 'shell' específico?
Diferentes 'shells' (como bash ou sh) têm regras ligeiramente diferentes. Configurar corretamente garante que o ShellCheck verifique seu script de acordo com as regras do 'shell' que você pretende usar.
O que significa 'suprimir falsos positivos'?
Às vezes, o ShellCheck pode avisar sobre algo que não é realmente um problema no seu caso específico. 'Suprimir' significa dizer ao ShellCheck para ignorar esse aviso específico, mas é bom explicar por que você está fazendo isso.
Detalhes
Descrição original do autor
Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4952
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
screen-reader-testing
Faz seu agente testar sites usando leitores de tela para garantir que sejam acessíveis.
wshobson/agents
wcag-audit-patterns
Ajuda seu agente a auditar sites para acessibilidade e corrigir problemas de acordo com as diretrizes WCAG.
wshobson/agents
multi-reviewer-patterns
Faz seu agente coordenar revisões de código paralelas, deduplicando achados e consolidando relatórios.
wshobson/agents
parallel-debugging
Permite ao agente depurar problemas complexos com investigações paralelas e análise de causa raiz.
wshobson/agents
Skills parecidas
cpp-testing
Faz seu agente escrever e melhorar testes para código C++. Ajuda a configurar ferramentas de teste e a corrigir erros.
affaan-m/ECC
csharp-testing
Ajuda seu agente a criar testes para código C# e .NET. Ele usa as melhores práticas para garantir que os testes sejam eficientes e confiáveis.
affaan-m/ECC
django-tdd
Faz seu agente aplicar estratégias de teste para Django com pytest-django e TDD. É útil para escrever testes robustos e garantir a qualidade do código, especialmente para APIs DRF.
affaan-m/ECC