Remote Frog

AKA “Un PDF de 434 páginas para escribir más conciso y claro” :troll:

Hace un par de días leí un comentario de un compañero que compartía una idea de Andrej Karpathy (@karpathy): si quieres que tu modelo te escriba más clarito y conciso tienes la opción de pedirle al LLM que explique algo siguiendo ASD-STE100.

ASD-STE100 es una especificación de inglés técnico, pero controlado, creada para documentación aeroespacial. Según Karpathy (este tío es cofundador de OpenAI y ahora está en Anthropic), los LLM se desenvuelven bien con ella y las restricciones que impone ayudan a producir textos más claros y legibles. A veces el resultado puede quedar como un poco rígido o robótico y propone pedir algo como ‘respondeme un 80 % como ASD-STE100’.

Parecía buen plan (yo siempre acabo diciendo cuando quiero escribir algo ‘reescribe para claridad y concisión’. Así que me bajé el libraco. Y jodo. No es precisamente conciso. Tiene 434 páginas.

El resumen rápido: la primera parte contiene 53 reglas de escritura, agrupadas en nueve secciones. Cubren desde las palabras y los verbos hasta las frases, los procedimientos y las instrucciones de seguridad. La segunda parte es un diccionario que define qué palabras se pueden usar y con qué significado.

Las reglas en cuestión (Codex Recap)

(Disclaimer: no me he leído el libro, esto es un recap de Codex). ASD-STE100 da reglas para escribir documentación técnica en inglés de forma clara, coherente y fácil de traducir. El estándar se organiza principalmente en dos partes: reglas de escritura y vocabulario controlado.

• Usa palabras aprobadas y con un significado definido. Una palabra puede estar permitida para un sentido concreto y no para otros. Si el término necesario no está en el diccionario, se puede usar siguiendo las reglas para términos técnicos.
• Prefiere palabras comunes y concretas. Evita sinónimos innecesarios, expresiones vagas, modismos y verbos con varios sentidos.
• Usa frases cortas y una idea por oración. Divide las oraciones largas y evita estructuras gramaticales complejas.
• Escribe instrucciones en voz activa y en imperativo. Indica claramente quién debe hacer la acción y qué debe hacer.
• Usa tiempos verbales y formas gramaticales de manera controlada. Por ejemplo, evita construcciones que puedan hacer confuso quién hace qué o cuándo.
• Mantén los nombres y términos consistentes. No cambies de palabra para referirte al mismo componente o acción.
• Evita pronombres ambiguos. Repite el nombre del componente si “it”, “they” o “this” pudiera referirse a más de una cosa.
• Expresa condiciones y excepciones con claridad. Sitúalas junto a la acción a la que afectan; evita instrucciones que permitan interpretaciones distintas.
• Usa unidades, números, símbolos y formatos de forma uniforme, según las convenciones del estándar y del proyecto.
• Comprueba que cada paso sea verificable. Una instrucción debe permitir al lector saber qué hacer y, cuando corresponda, cómo confirmar el resultado.

¿En qué se traduce todo esto?

En lugar de ‘Asegúrate que la puerta está cerrada antes de que comiences el test’ pues, qué tal algo más directo como ‘Cierra la puerta. Empieza el test’.

Y el skill

No es que vaya a descubrir la rueda porque lo más fácil es pedirle a tu LLM que lo escriba, pero aquí está el mío (para Codex)

---
name: asd-ste100-explanations
description: Explain procedures and how-to tasks in clear, direct language inspired by ASD-STE100. Use when the user asks how to do something or requests a step-by-step explanation.
---

# ASD-STE100 style for explanations

Use this style when explaining how to do something. Aim for about 80% of the strictness of ASD-STE100. Keep the explanation natural and conversational.

## Writing rules

- Use familiar, concrete words.
- Keep sentences short. Use one main idea per sentence.
- Use the same term for the same thing throughout.
- Prefer active voice and direct instructions.
- Put steps in the order the user must do them.
- State conditions, warnings, and expected results next to the step they affect.
- Explain technical terms when the reader may not know them.
- Keep details needed to complete the task safely and correctly.
- Remove repetition, vague wording, idioms, and unnecessary synonyms.

## Accuracy

Do not simplify a step if this could change its meaning or make the task unsafe. If a key detail is unknown, say what is unknown. Ask a question only when the missing detail changes the instructions.

ASD-STE100 is a controlled-English specification. Describe the answer as “inspired by ASD-STE100”; do not claim formal compliance unless the text has been checked against the specification.

Use this style for other answers only when it clearly helps. If it may help but the user did not ask for it, ask whether they want that style.