# Shellcheck Configuration

> Domina la configuración y el uso de ShellCheck para el análisis estático de shell scripts. Úsalo al montar infraestructura de linting, corregir problemas de código o garantizar la portabilidad de scripts.

Fuente: https://skillsagentes.com/skills/wshobson/agents/shellcheck-configuration
Markdown: https://skillsagentes.com/skills/wshobson/agents/shellcheck-configuration.md

Repositorio: https://github.com/wshobson/agents
Autor: wshobson
Licencia: MIT
Actualizado: hace 4 meses
Coste de contexto: 45 tok instalada, 403 tok al activarse, 2.4k tok con todos los archivos del bundle
Bundle: 2 archivos, 9 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent claude-code
# Cursor
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent cursor
# Codex
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent codex
# Gemini CLI
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent gemini
# Windsurf
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent windsurf
# Cline
npx -y skills add wshobson/agents --skill shellcheck-configuration --agent cline
```

## Qué hace

- 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

## Cuándo usarla

- 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

## Qué la activa

- "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"

## Antes de instalar

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

## Archivos

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

## SKILL.md

Reproducido tal cual desde wshobson/agents bajo MIT. Esta sección es el documento original y está en inglés.

# 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

## Dónde encaja

- Categoría: [Testing y QA](https://skillsagentes.com/categorias/testing-qa.md) — Flujos de testing unitario, de integración y end-to-end.
- Creador: [wshobson](https://skillsagentes.com/creators/wshobson.md) — 183 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Hermes Tweet](https://skillsagentes.com/skills/wshobson/agents/hermes-tweet.md): Instala y opera Hermes Tweet, un plugin de Hermes Agent para investigar X/Twitter, leer timelines, analizar tweets y ejecutar operaciones privadas o de cambio de estado con aprobación previa.
- [Superself](https://skillsagentes.com/skills/wshobson/agents/superself.md): Úsalo cuando un proyecto guarda su estado en Superself: lee `self context` al iniciar sesión, vincula el trabajo a una work unit, reporta con evidencia y registra decisiones confirmadas.
- [Grounded Vault](https://skillsagentes.com/skills/wshobson/agents/grounded-vault.md): Úsalo para mantener un almacén Markdown de conocimiento donde cada afirmación compilada se rastrea hasta una fuente inmutable y el drift se detecta con git diff sin gastar tokens.
- [Postgresql Table Design](https://skillsagentes.com/skills/wshobson/agents/postgresql-table-design.md): Úsalo al diseñar o revisar un esquema específico de PostgreSQL: buenas prácticas, tipos de datos, indexación, restricciones, patrones de rendimiento y funciones avanzadas.
- [Prompt Engineering Patterns](https://skillsagentes.com/skills/wshobson/agents/prompt-engineering-patterns.md): Úsalo cuando pidan optimizar un prompt, mejorar su rendimiento, diseñar una plantilla, aplicar chain-of-thought, few-shot prompting o técnicas avanzadas de prompt engineering para producción.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)