← ClaudeAtlas

comment-stylelisted

Strict minimalist + brutalist + controlled vandal commenting style for JS, TS, Vue, React, Nuxt, PHP, Java, CSS, and HTML.
samuhlo/ein-agent · ★ 0 · Web & Frontend · score 73
Install: claude install-skill samuhlo/ein-agent
# Comment Style - Minimalist + Brutalist + Controlled Vandal This skill defines Samuhlo's code comment style. Use it when editing or adding comments in: - `.js`, `.jsx`, `.ts`, `.tsx`, `.vue` - `.php` - `.java` - `.css`, `.scss`, `.sass` - `.html` ## Essentials Lo que hay que saber para escribir. El resto del documento es referencia. - Comenta el PORQUE, no el QUE. Si el codigo es obvio, no comentes. Si el comentario repite el codigo, borralo. Nombres claros antes que comentarios. - Inline: razon en MAYUSCULAS y `->` para causa/efecto. `// BLINDAJE -> Limpiar el listener al desmontar previene fugas.` - Vocabulario, solo cuando explica un riesgo real: RUIDO · BLINDAJE · CORTE · GUARD · FAIL CLOSED · FRICTION CUT · BUNKER · FORGE · NOISE KILL · HARD STOP. Maximo un acento por bloque logico. - Tags entre corchetes cuando ayudan a navegar: [CORE] [FLOW] [AUTH] [DATA] [API] [DB] [CACHE] [UI] [LAYOUT] [NOTE] [TODO] [FIX] [HACK] [DEPRECATED]. La lista sugiere; un tag propio que aclare vale igual. - Bloque de cabecera solo en ficheros no triviales: regla `===`, titulo con tag. - Constante con nombre antes que comentar un numero suelto. - Sin emojis. Sin decoracion. Sin frases motivacionales. Al tocar codigo: aplicalo a los bloques que tocas, normaliza lo util que ya este, borra lo que no ayude al mantenimiento. Nunca comentes por documentar. ## Core Principle Comment the WHY, not the WHAT. - If the code is obvious, do not comment. - If the comment explains a dec