Coding Principles

Principios de codificación agnósticos al lenguaje para mantenibilidad, legibilidad y calidad del código

Por shinpr · shinpr/claude-code-workflows

Probado · Funciona ★ 8.8/10

Coding Principles — Principios de codificación agnósticos al lenguaje para mantenibilidad, legibilidad y calidad del código

Qué hace

Una lista de verificación agnóstica al lenguaje de principios de codificación que cubre diseño de funciones, manejo de errores, inyección de dependencias, comentarios, refactorización y valores predeterminados seguros, además de una referencia de verificaciones de seguridad para revisión. Se activa al implementar características, refactorizar o revisar la calidad del código. Dirige el código generado hacia consultas parametrizadas, registro seguro de secretos, hashing seguro, constantes nombradas y funciones pequeñas de responsabilidad única.

Informe de la prueba

Se obtuvieron SKILL.md y su único archivo referenciado (references/security-checks.md, HTTP 200) de la copia de dev-skills; el frontmatter tiene name+description y no hay rutas codificadas ni problemas de seguridad. Para la salida, escribí la misma función registerUser dos veces: una referencia escrita naturalmente, luego una siguiendo estrictamente el cuerpo. La versión de la habilidad corrigió concretamente defectos reales en mi referencia — la concatenación de cadenas SQL se convirtió en una consulta parametrizada, un console.log que filtraba la contraseña en texto plano se convirtió en un registro solo de nombre de usuario, MD5 se convirtió en pbkdf2 con sal, el número mágico 13 se convirtió en MINIMUM_AGE, y e.message sin procesar dejó de filtrarse al llamador. Frases de activación juzgadas: "refactorizar este UserService de 300 líneas" SÍ, "revisar mi PR para calidad de código" SÍ, "implementar una capa de caché con una estructura limpia y mantenible" SÍ, "¿cuál es la diferencia entre TCP y UDP?" NO, "configurar una pipeline de CI de GitHub Actions" NO — las 5 correctas.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/coding-principles-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-principles-src/dev-skills/skills/coding-principles ~/.claude/skills/coding-principles
# Places SKILL.md at ~/.claude/skills/coding-principles/SKILL.md plus references/security-checks.md
# No deps, no scripts, no API keys — pure guidance skill.
# Identical copies also live under dev-workflows-frontend/ and dev-workflows-fullstack/ in the same repo.
# Plugin alternative: /plugin marketplace add shinpr/claude-code-workflows then /plugin install dev-workflows@claude-code-workflows

Comandos y prompts de ejemplo

/coding-principlesPrincipios de codificación agnósticos al lenguaje para mantenibilidad, legibilidad y calidad del código

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Review this function for maintainability issues
Refactor this code to be more readable
Check this feature implementation against coding principles

Informe completo →