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:

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

Instrucciones de Ejecución

Cuando el usuario solicite generar un artículo:

•
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/
•
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
•
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
•
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
•
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)
•
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:

•Lee blog/draft/porque-usar-runbook/notes.md
•Lee blog/draft/porque-usar-runbook/content-structure.md (si existe)
•Verifica assets disponibles
•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