Sharp Writing
Reglas para prosa nítida y concisa en documentos, READMEs y habilidades de agente
Probado · Funciona
Qué hace
Una habilidad de archivo único de convenciones para escribir prosa y Markdown concisos y precisos tanto para lectores humanos como de IA. Se activa antes de escribir documentación, READMEs, instrucciones o habilidades de agente. Las reglas cubren el fraseo positivo, la estructura de una idea por oración, la eliminación de cierres redundantes y el uso de guiones largos específicos para la audiencia.
Informe de la prueba
Se ejecutó en una introducción de README de CLI: redujo un párrafo cargado de exageraciones de 55 palabras a 40, eliminó 'powerful/intuitive/essential' y borró una oración de cierre redundante que su regla 'stop at the last fact' prohíbe, mientras añadía un comportamiento concreto de código de salida. SKILL.md único y autocontenido sin scripts, por lo que no hay nada que romper o exfiltrar, y el comando de instalación lo colocó limpiamente en un HOME vacío. El cuerpo practica la concisión que predica, por lo que sus afirmaciones coinciden con el comportamiento observado.
Probado el: 2026-07-18 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/paleo/alignfirst mkdir -p ~/.claude/skills cd alignfirst && cp -r .agents/skills/sharp-writing ~/.claude/skills/sharp-writing
Comandos y prompts de ejemplo
/sharp-writingReglas para prosa nítida y concisa en documentos, READMEs y habilidades de agente
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Tighten the prose in this CLI tool's README introduction paragraph.Draft a concise docs page for this API without any filler language.Cut the hype and restate-y closer sentence in this agent skill's body.