---
name: configuracion-shellcheck
description: Guia completa para configurar y usar ShellCheck en analisis estatico de shell scripts. Ideal para establecer infraestructura de linting, integrar en CI/CD y garantizar la portabilidad del codigo.
license: MIT
metadata:
  id: bacab54e
  slug: configuracion-shellcheck
  titulo: "Configuracion de ShellCheck para calidad de scripts"
  servicio: IA-Ingenieria-MLOps
  categoria_recurso: Web-Desarrollo
  tipo: referencia
  nivel: intermedio
  idioma: es
  idioma_original: en
  acceso: gratis
  precio_eur: 0
  plataformas: [Linux, macOS, CI/CD, GitHub Actions, pre-commit]
  dependencias: [shellcheck]
  licencia: { spdx: MIT, redistribuible: true, uso_comercial: true }
  fuente:
    repo: wshobson/agents
    url: https://github.com/wshobson/agents/tree/main/plugins/shell-scripting/skills/shellcheck-configuration
    commit: cc37bfd
    autor: wshobson
    nombre_original: shellcheck-configuration
    duplicados_en: []
  seguridad: { veredicto: seguro, riesgo: bajo, escaneado: "2026-06-14", motor: "grep-estatico+auditor-llm" }
  ficha:
    que_hace: "Configura ShellCheck para analizar y corregir problemas de calidad en shell scripts."
    como_lo_hace: "Proporciona guias de configuracion, patrones de uso y mejores practicas para integrar ShellCheck en pipelines de desarrollo y CI/CD."
  content_hash: "bacab54ee25dd71f680be0859fec8088f633e2631ee99a77e1b099fe30bb9700"
  version: 1.0.0
---

# 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