shellcheck-configuration
Configurar ShellCheck para linting de shell confiable
Los problemas de scripts de shell se ocultan hasta producción y ralentizan las revisiones de código. Esta skill explica la configuración de ShellCheck, las reglas de configuración y los flujos de integración para detectar problemas antes de fusionar.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Pruébalo
Usando "shellcheck-configuration". Necesito ayuda para entender SC2086 y cómo corregirlo
Resultado esperado:
- SC2086 es la advertencia de expansión de variable sin cotización
- Corrige cotizando variables o usando sintaxis de array
- Ejemplo: cambia 'for i in $list' a 'for i in "$list"' o 'for i in "${list[@]}"'
Usando "shellcheck-configuration". Crear un .shellcheckrc para un proyecto de Bash
Resultado esperado:
- Establece shell=bash para análisis de dialecto Bash
- Habilita verificaciones opcionales como require-variable-braces
- Deshabilita SC1091 para archivos fuente que pueden no existir
- Documenta cada código deshabilitado con un comentario explicando por qué
Auditoría de seguridad
SeguroPure documentation skill containing only markdown guidance for ShellCheck, a legitimate open-source static analysis tool. All static findings are false positives. References like SC2009, SC2086 are ShellCheck error codes (not C2 keywords), sha256sum is appropriate for caching (not weak crypto), and shell examples are documentation (not malicious patterns).
Factores de riesgo
🌐 Acceso a red (5)
⚙️ Comandos externos (72)
📁 Acceso al sistema de archivos (5)
Puntuación de calidad
Lo que puedes crear
Agregar linting de shell en CI
Configurar ShellCheck en pipelines de CI con indicadores consistentes y reglas de fallo.
Corregir advertencias comunes
Entender códigos clave de ShellCheck y aplicar patrones más seguros de cotización y flujo.
Estandarizar reglas de lint
Definir configuraciones compartidas de .shellcheckrc y políticas de supresión documentadas.
Prueba estos prompts
Explica cómo instalar ShellCheck y ejecutarlo en un solo script. Incluye comandos de ejemplo para instalar en Ubuntu y ejecutar contra un archivo de Bash.
Borra un .shellcheckrc para scripts de Bash con algunas verificaciones habilitadas y dos códigos deshabilitados. Explica cada configuración.
Proporciona un paso mínimo de GitHub Actions que instala ShellCheck y lo ejecuta en todos los archivos .sh, fallando en advertencias.
Muestra cómo suprimir SC1091 y SC2119 en un script de shell y documenta por qué cada supresión es segura.
Mejores prácticas
- Establece el shell objetivo explícitamente antes de hacer lint para coincidir con tu entorno de despliegue
- Documenta cada código suprimido con un comentario explicando la justificación
- Ejecuta ShellCheck tanto en hooks pre-commit como en CI para detección temprana local y remota
Evitar
- Deshabilitar advertencias ampliamente sin justificación específica para cada código
- Hacer lint de scripts de Bash como POSIX sh sin entender los requisitos de compatibilidad
- Ignorar fallos de ShellCheck en CI o sobrescribir códigos de salida sin revisión
Preguntas frecuentes
¿Es compatible con Bash y POSIX sh?
¿Cuáles son los límites de esta skill?
¿Puede integrarse con sistemas CI?
¿Accede a mis archivos o credenciales?
¿Qué pasa si ShellCheck reporta demasiadas advertencias?
¿Cómo se compara con linters genéricos?
Detalles del desarrollador
Autor
wshobsonLicencia
MIT
Repositorio
https://github.com/wshobson/agents/tree/main/plugins/shell-scripting/skills/shellcheck-configurationRef.
main
Estructura de archivos
📄 SKILL.md