Article Generator

Article Generator Skill

Este skill genera artículos estructurados y bien redactados a partir de notas e ideas en formato markdown.

Estructura de Entrada

El skill espera encontrar en el directorio blog/draft/<nombre-articulo>/:

• notes.md (requerido): Archivo con las ideas principales, puntos clave y contenido del artículo
• content-structure.md (opcional): Define la estructura específica que debe seguir el artículo (secciones, orden, etc.)
• assets/ (opcional): Carpeta con imágenes, archivos y recursos para el artículo

Estructura de Salida

El skill generará:

• article.md: Artículo final con metadata YAML y contenido estructurado

Formato de Metadata YAML

El archivo article.md debe comenzar con la siguiente metadata YAML:

---
title: Título del artículo
description: Descripción breve del artículo (1-2 oraciones)
cover: ./assets/cover.png
lang: es
author:
  name: Jonathan Delgado
  email: hi@jon.soy
  website: https://jon.soy
  github: "@jondotsoy"
date: YYYY-MM-DD
publications:
  - url: https://...
    date: YYYY-MM-DD
---

Campos de Metadata

• title: Título principal del artículo
• description: Resumen conciso del contenido (máximo 2-3 oraciones)
• cover: Ruta relativa a la imagen de portada (siempre en ./assets/)
• lang: Código de idioma (es, en, etc.)
• author: Información del autor
  • name: Nombre completo
  • email: Correo electrónico
  • website: Sitio web personal
  • github: Usuario de GitHub con @
• date: Fecha de creación en formato YYYY-MM-DD
• publications: Lista de publicaciones (opcional inicialmente)
  • url: URL donde fue publicado
  • date: Fecha de publicación

Formato del Contenido Markdown

El contenido del artículo debe seguir estas reglas de formato:

Separadores de página

• NO usar --- como separador de página en el contenido del artículo
• Los únicos --- permitidos son los que delimitan el bloque de metadata YAML al inicio del archivo
• Las secciones se separan simplemente con espacio en blanco (línea vacía) entre ellas

Tablas vs. Bullet Points

• Preferir bullet points sobre tablas para presentar información estructurada
• Las tablas solo deben usarse cuando la información es genuinamente tabular y requiere columnas relacionadas
• Para comparaciones, especificaciones o listas de características, usar bullet points con formato anidado

Ejemplo correcto (bullet points):

**Plataformas soportadas:**

- **Claude**
  - URL base: `https://claude.ai/new`
  - Parámetro: `?q=`
  - Comportamiento: Precarga el prompt en la caja de texto

- **ChatGPT**
  - URL base: `https://chat.openai.com/?q=`
  - Parámetro: `?q=`
  - Comportamiento: Precarga el prompt y puede auto-enviar

Ejemplo a evitar (tabla):

| Plataforma | URL base | Parámetro |
|------------|----------|-----------|
| Claude     | ...      | ?q=       |

Otros elementos de formato

• Usar títulos jerárquicos apropiados (##, ###, ####)
• Usar bloques de código con syntax highlighting cuando sea relevante
• Usar negritas para enfatizar términos importantes
• Usar cursivas para referencias o expresiones
• Usar listas ordenadas solo cuando el orden sea relevante
• Usar citas (>) para destacar definiciones o conceptos clave

Instrucciones de Ejecución

Cuando el usuario solicite generar un artículo:

1. Leer el contexto:

   • Lee blog/draft/<nombre-articulo>/notes.md para obtener las ideas principales
   • Si existe, lee blog/draft/<nombre-articulo>/content-structure.md para conocer la estructura deseada
   • Verifica los archivos disponibles en blog/draft/<nombre-articulo>/assets/

2. Analizar y estructurar:

   • Identifica los temas principales de las notas
   • Si hay content-structure.md, sigue esa estructura; de lo contrario, crea una estructura lógica basada en las notas
   • Organiza las ideas en secciones coherentes con títulos claros

3. Generar el artículo:

   • Crea la metadata YAML con la información del autor (usar datos por defecto de Jonathan Delgado)
   • Usa la fecha actual para el campo date
   • Deja publications como array vacío inicialmente
   • Redacta el contenido de manera clara, profesional y bien estructurada
   • Usa markdown apropiadamente (títulos, listas, código, citas, etc.)
   • Si hay imágenes en assets/, referéncialas correctamente con rutas relativas

4. Estilo de redacción:

   • Escribe en el idioma indicado en las notas o en español por defecto
   • Usa un tono profesional pero accesible
   • Incluye ejemplos prácticos cuando sea relevante
   • Divide el contenido en secciones bien definidas
   • Usa listas, código y otros elementos markdown para mejorar la legibilidad

5. Validación:

   • Asegúrate de que la metadata YAML sea válida
   • Verifica que todas las referencias a archivos en assets/ sean correctas
   • Confirma que el contenido sigue la estructura definida (si existe content-structure.md)

6. Guardar:

   • Escribe el archivo completo en blog/draft/<nombre-articulo>/article.md
   • Confirma al usuario que el artículo fue generado exitosamente

Ejemplo de Uso

Usuario: "Genera el artículo para 'porque-usar-runbook'"

El skill:

1. Lee blog/draft/porque-usar-runbook/notes.md
2. Lee blog/draft/porque-usar-runbook/content-structure.md (si existe)
3. Verifica assets disponibles
4. Genera blog/draft/porque-usar-runbook/article.md con metadata completa y contenido estructurado

Notas Importantes

• Siempre incluye la metadata YAML completa al inicio del archivo
• Las imágenes deben referenciarse con rutas relativas: ./assets/imagen.png
• El campo date debe usar el formato ISO: YYYY-MM-DD
• Si no hay información específica del autor, usa los datos por defecto de Jonathan Delgado
• El contenido debe ser original y bien redactado, no una simple copia de las notas
• Respeta la estructura definida en content-structure.md si existe
• El artículo debe ser autocontenido y comprensible sin necesidad de leer las notas originales
• NO usar --- como separadores de página en el contenido (solo en el frontmatter YAML)
• Preferir bullet points en lugar de tablas para presentar información estructurada