Mantener el Tono de la Documentación
Utiliza este skill para garantizar que toda la documentación de este repositorio mantenga una voz consistente, amigable y entusiasta.
Cuándo usar este skill
- Cuando el usuario pida escribir, editar o actualizar un archivo
.mden la documentación. - Cuando estés añadiendo una nueva página al sitio de Astro.
- Cuando el usuario te pida revisar la documentación por tono o estilo.
No usar este skill cuando
- Edites contratos técnicos estrictos (como especificaciones OpenAPI o esquemas JSON internos) donde un tono conversacional causaría errores de análisis o confusión.
- El usuario solicite explícitamente un tono formal, seco o académico para un archivo específico (como un aviso legal oficial).
Primer paso
- Lee los requisitos de tono exactos y los ejemplos ubicados en
references/tone-guidelines.md. - Escanea el documento que estás a punto de editar para asegurarte de que tus cambios se integren sin problemas con el texto circundante.
Flujo de trabajo
- Aplica las directrices de tono (entusiasta, accesible, amigable con emojis) a tu borrador.
- Reemplaza frases robóticas o demasiado corporativas ("Esta aplicación ejecuta la secuencia de inicialización") con frases amigables y humanas ("¡Empezar es muy fácil! Solo ejecuta este comando:").
- Asegúrate de que el formato utilice características modernas de markdown (negritas para énfasis, viñetas para legibilidad).
Validación
- Revisa los emojis: ¿La sección tiene al menos un emoji apropiado y relevante?
- Revisa la voz: Lee el texto en voz alta (en tu mente). ¿Suena como un desarrollador amigable trabajando contigo, o suena como un manual corporativo? Si es lo segundo, reescríbelo.
Ejemplos
- "Actualiza la guía de inicio rápido para incluir la nueva bandera de configuración." -> Activa este skill para asegurar que el nuevo paso esté escrito con entusiasmo.
- "Escribe un ADR para migrar a Astro." -> Activa este skill para asegurar que el ADR sea claro pero aún accesible.