Plantilla de prompt: Escritura compatible con Gen AI

Este artículo ofrece una plantilla lista para usar para redactar o revisar documentación utilizando una herramienta de escritura con IA. El prompt está diseñado para producir contenido optimizado tanto para lectores humanos como para sistemas de recuperación de IA como Eddy AI.

Para conocer la lógica completa de cada regla en este prompt, consulta contenido compatible con Gen AI. Para verificar tu producción antes de publicar, utiliza la lista de verificación de contenido compatible con Gen AI.

Cuándo usar esta consigna

Usa este prompt cuando quieras:

• Redacta un nuevo artículo a partir de un tema o esquema usando un agente de escritura con IA.
• Revisa un artículo existente para hacerlo compatible con GenAI.
• Genera un primer borrador antes de aplicar tus propias ediciones y revisiones.

Prompt maestro para agente de IA

You are a technical documentation writer tasked with creating GenAI-friendly content that works effectively for both human readers and AI-powered assistants.
Follow these rules when drafting the article:

Follow These
Use clear, hierarchical headings (H1, H2, H3) with descriptive, keyword-rich titles.
Write short, focused sentences (<20 words) and one idea per paragraph.
Use bullet points for grouped info and numbered lists for steps (3–7 items max).
Present structured data in tables with clear labels (no merged cells, no empty placeholders).
Format code snippets cleanly, with syntax highlighting, consistent indentation, and meaningful comments.
Provide descriptive alt text for images and clear anchor text for links.
Write in a conversational, user-first tone, using plain language and "you" when guiding.
Apply SEO practices: natural keyword use, meta descriptions, glossary-approved terms.
Include a FAQ section (5–10 self-contained Q&A).
Make content modular and reusable so AI can extract, summarize, and repurpose easily.

Avoid These
Don't use generic headings like "Overview" or repeat the same heading multiple times.
Don't write long, complex sentences or dense paragraphs.
Don't include filler, background fluff, or unnecessary context inside instructional steps (link to supporting content instead).
Don't use vague anchor text like "here" or "this article."
Don't add placeholders in tables (like "Y/N," "—", emojis, or icons).
Don't format code blocks with line numbers or styling that prevents copy-paste.
Don't switch between synonyms or variations of glossary terms inconsistently.
Don't overuse jargon, acronyms, or unexplained abbreviations.
Don't stuff keywords unnaturally or repeat them excessively.

Instrucción de tareas para la IA

Generate a [type of article: how-to guide, feature explanation, or FAQ] for [topic/product/feature].
Ensure the output is clear, modular, and optimized for both human readers and AI systems. Include:

Headings/subheadings
Short paragraphs
Bullet/numbered lists where needed
Tables for structured data
At least 5 FAQs with clear answers
Proper SEO keywords (without stuffing)
Consistent glossary

Cómo personalizar el prompt

Ajusta la sección TAREAS al final para cada artículo que redactes:

También puedes añadir instrucciones adicionales a la sección TASK, por ejemplo:

• "El público objetivo son nuevos usuarios de Document360 sin conocimiento previo de la plataforma."
• "Consulte los siguientes términos del producto: [términos de lista]."
• "El artículo debería tener menos de 600 palabras."

Empaqueta tu prompt como una habilidad

El prompt maestro de arriba funciona para borradores puntuales. Para flujos de trabajo repetidos como documentar características de PRDs, especificaciones o notas preliminares, empaquetalo como un archivo SKILL.md para que agentes de IA como Claude sigan el mismo proceso cada vez sin volver a pegar el prompt.

Un SKILL.md es un archivo Markdown estructurado con dos partes: un bloque de frontmatter (nombre, descripción, frases desencadenantes) y un cuerpo (pasos, reglas de escritura, formato de salida). Instálalo una vez; Reutilízalo con todo tu equipo.

Ejemplo: Redactor Técnico - Habilidad para artículos de fondo

Esta habilidad ayuda a Claude a escribir artículos completos y listos para publicación sobre cualquier funcionalidad de software — siguiendo las convenciones MSTP (Microsoft Manual of Style for Technical Publications) en todo momento.
Instálala cuando necesites documentar una función desde cero o aportar estructura a las notas básicas. Una vez activada, describe tu característica (o pega un PRD, especificación o captura de pantalla) y Claude elabora un artículo completo que cubre cada sección en la que confían los lectores: una introducción precisa, requisitos previos, cuándo usar la función, instrucciones paso a paso, limitaciones, mejores prácticas, solución de problemas y preguntas frecuentes.

Para instalarlo:

1. Descarga el .skill archivo.

escritor-técnico-artículo-especial.habilidad
2. En Claude, ve a Configuración -> Conectores -> Personalizar -> Habilidades -> Añadir habilidad -> Seleccionar Crear habilidad -> Subir una habilidad.
Ahora puedes arrastrar y soltar o hacer clic para subir el archivo de habilidades instalado.
3. Una vez añadida la habilidad, simplemente comparte tu nombre de la característica, PRD o notas — Claude se encarga del resto.
Funciona mejor cuando le das a Claude un documento de requisitos de producto o una descripción de la característica. Cuanta más información compartas, menos necesita Claude preguntar.

Después de usar el prompt

La salida de la IA es un primer borrador, siempre revisa antes de publicar. Comprueba por:

• Pensamientos incompletos o pasos que faltan.
• Hechos alucinados o detalles inexactos del producto.
• Tono o fraseo que no coincida con tu guía de estilo documental.
• Términos del glosario que faltan o se usan de forma inconsistente.