~/lab/plating
Plating
Un solo estándar de escritura para cada respuesta y cada archivo de prosa, en inglés y en español
claude --plugin-dir /path/to/hidkit| Type | Where | Sentence limit |
|---|---|---|
| Procedural | Files under `skills/` and `agents/` | 20 words |
| Descriptive | Every other file, PR text, commit messages, and the chat reply | 25 words |Por qué un estándar de escritura
Hidkit escribe mucha prosa: respuestas en el chat, mensajes de commit, textos de PR y las propias skills. Una skill es un prompt, así que su redacción moldea lo que hace el modelo. Plating le da a todo ese texto un solo estándar, en inglés y en español.
Plating se carga con el plugin de Hidkit. Las otras skills lo enlazan: Cheffy, Sharpener, Fill-me-in, Doodle y Rolling-boil lo siguen cuando escriben sus respuestas.
Reglas para los dos idiomas
- Usa la voz activa y escribe cada instrucción en imperativo.
- Dale a cada palabra un solo significado. No cambies de sinónimo para variar.
- Usa los términos de
GLOSSARY.md. Cada entrada define un término y lista los sinónimos que nunca usas para él. - En español, conserva el término del glosario en inglés, salvo que su entrada dé uno en español, como receta, rol o el pase.
- Escribe en mayúsculas las palabras clave de RFC 2119 para separar una restricción de una preferencia: MUST, SHOULD, MAY y, en español, DEBE, DEBERÍA, PUEDE.
Tipos de texto
La ruta de un archivo define su tipo de texto, como muestra el snippet. El texto procedimental le dice a un agente qué hacer, así que lleva una instrucción por oración.
El texto descriptivo conserva los conectores causales como “porque” y “así que”. Sin ellos, el lector pierde el vínculo cuando una causa y su efecto quedan en dos fragmentos.
Lo completo le gana a lo breve. Nunca quites contenido para acortar un texto.
El español, y el lint
El inglés sigue ASD-STE100. El español aplica estas reglas en orden:
- Español Técnico Simplificado: nombra a quien actúa, pon el sujeto antes del verbo y escribe una idea por oración.
- Las palabras clave de RFC 2119.
- UNE-ISO 24495-1:2024: cada texto es pertinente, fácil de encontrar, comprensible y utilizable.
- ISO 704:2022 para las definiciones: primero el género, después la diferencia.
Cheffy corre el lint de prosa como gate 9 del pase:
node /path/to/hidkit/skills/cheffy/scripts/lint.mjs --prose <files>Corrige cada error. Corrige cada advertencia, salvo que la oración más corta pierda sentido. También pasé este lint sobre estas notas del lab.