# Shellcheck Configuration

> Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.

Source: https://skillsagentes.com/skills/wshobson/agents/shellcheck-configuration
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 45 tok installed, 403 tok once triggered, 2.4k tok with every bundled file
Bundle: 2 files, 9 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent claude-code
```

## What it does

- Configura ShellCheck para analizar scripts de shell de forma estática
- Explica códigos de error y advertencias de ShellCheck
- Guía la supresión de falsos positivos y la configuración de reglas
- Integra ShellCheck en pipelines de CI/CD, pre-commit y editores

## Use it when

- Configurar linting para scripts de shell en pipelines de CI/CD
- Analizar scripts de shell existentes en busca de problemas
- Configurar ShellCheck para requisitos específicos del proyecto
- Migrar scripts para cumplir con quality gates

## What triggers it

- "Configura ShellCheck para mi pipeline de CI/CD"
- "Ayúdame a entender este warning de ShellCheck"
- "Configura reglas de ShellCheck para mis scripts bash"
- "Necesito suprimir un falso positivo en ShellCheck"

## Before you install

- Requiere tener ShellCheck instalado para ejecutar el análisis estático.

## Files

- SKILL.md — 2 KB
- references/details.md — 8 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# ShellCheck Configuration and Static Analysis

Comprehensive guidance for configuring and using ShellCheck to improve shell script quality, catch common pitfalls, and enforce best practices through static code analysis.

## When to Use This Skill

- Setting up linting for shell scripts in CI/CD pipelines
- Analyzing existing shell scripts for issues
- Understanding ShellCheck error codes and warnings
- Configuring ShellCheck for specific project requirements
- Integrating ShellCheck into development workflows
- Suppressing false positives and configuring rule sets
- Enforcing consistent code quality standards
- Migrating scripts to meet quality gates

## Detailed patterns and worked examples

Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient.

## Best Practices

1. **Run ShellCheck in CI/CD** - Catch issues before merging
2. **Configure for your target shell** - Don't analyze bash as sh
3. **Document exclusions** - Explain why violations are suppressed
4. **Address violations** - Don't just disable warnings
5. **Enable strict mode** - Use `--enable=all` with careful exclusions
6. **Update regularly** - Keep ShellCheck current for new checks
7. **Use pre-commit hooks** - Catch issues locally before pushing
8. **Integrate with editors** - Get real-time feedback during development

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/shellcheck-configuration