Pipeline de blog
Lo que obtienes: una entrada que responde a una búsqueda real, en tu tono, con hechos verificados, una imagen de 1200x630 y un frontmatter válido, esperando tu revisión en su propia carpeta.
Lo primero que debes hacer: coloca un archivo BLOG.md completo en la raíz de tu proyecto (la plantilla está en este repositorio). Cada etapa lo lee.
Lee primero, cada vez
BLOG.mden la raíz del proyecto: sitio, lector, objetivo, tono, palabras a evitar, categorías, cadencia, reglas de SEO e imágenes, valores predeterminados de frontmatter y la lista de Correcciones. Cuando BLOG.md y esta skill discrepan, BLOG.md gana.references/frontmatter-contract.mdantes de escribir cualquier frontmatter.- El archivo de referencia para la etapa que estás ejecutando, y nada más que no necesites.
¿Aún no tienes BLOG.md? Detente y ofrece crear uno. Lee de 3 a 5 de las entradas o páginas existentes de la persona, haz las preguntas de cada sección de la plantilla, escribe el archivo y pídele que lo revise. Una entrada escrita sin él suena a nadie en particular.
Cómo funciona
Una entrada de blog es la respuesta a algo que una persona escribe en Google. El conocimiento puede venir de una charla, un boletín o una llamada con un cliente; la entrada lo reconstruye alrededor de una búsqueda: un título que coincida con la búsqueda, la respuesta cerca del principio, encabezados redactados como la gente busca.
Refresca antes de escribir algo nuevo. Verifica si una entrada o página existente ya apunta a la búsqueda. Una entrada que Google ya muestra, con vistas y sin clics, vale más que una entrada nueva desde cero, y requiere una fracción del trabajo. Dos páginas dirigidas a una misma búsqueda suelen perder ambas.
La carpeta de trabajo
Una carpeta por entrada, en el proyecto de la persona: posts/<AAAA-MM-DD>-<slug>/. La fecha es el día de publicación previsto. El slug es la dirección final y el nombre del archivo. Cada etapa escribe un archivo en la carpeta, por lo que la carpeta es la memoria: cualquier etapa puede volver a ejecutarse o retomarse más tarde sin rehacer las etapas anteriores.
| # | Etapa | Lee | Escribe | Instrucciones |
|---|---|---|---|---|
| 1 | Ideación | BLOG.md, datos de búsqueda, entradas y páginas existentes | posts/_ideas/topic-ideas.md | references/01-ideacion.md |
| 2 | Brief | un tema | brief.md | references/02-brief.md |
| 3 | Investigación | brief.md | research.md | references/03-investigacion.md |
| 4 | Borrador | research.md, brief.md, BLOG.md | draft.md | references/04-borrador.md |
| 5 | Visuales | draft.md | visuals.md, <slug>.svg, <slug>.png | references/05-visuales.md |
| 6 | Publicar | draft.md, visuals.md | la entrada en src/content/blog/, imágenes en public/images/blog/, publish.md | references/06-publicar.md |
La cadena completa: etapas 2 a 6 en orden para un tema. La etapa 1 es un paso por lotes: ejecútalo cuando la lista de ideas se agote, aproximadamente una vez al mes para una cadencia semanal.
"Planifica mi primera entrada" (o "planifica mi próxima entrada"): etapa 1, luego etapa 2. Ejecuta la ideación, muestra la lista corta, deja que la persona elija un tema (no tiene que ser el #1; registra la elección y el motivo en topic-ideas.md), luego escribe su brief. Detente después del brief y di qué etapa viene después. Cuando la persona pida "encontrar ideas de temas", ejecuta solo la etapa 1; cuando pida "escribir el brief para ", ejecuta solo la etapa 2.
Una sola etapa: la persona nombra la etapa y la entrada. Lee el archivo de esa etapa y sus entradas, y omite el resto.
Un refresco: omite las etapas 1 y 2. Crea la carpeta posts/<hoy>-<slug>-refresco/, ejecuta la etapa 3 y la etapa 4 en modo de refresco, luego la etapa 6.
Las rutas anteriores son las del sitio inicial. Si BLOG.md enumera otras carpetas, usa esas.
Reglas
Estas anulan cualquier archivo de etapa. BLOG.md puede agregar más.
- Nunca inventes una fuente, estadística, cita o enlace. Cada URL en una entrada fue abierta durante la investigación. Una afirmación que no puedas verificar se elimina, o se marca como
[NO VERIFICADO]para que la persona la confirme. La experiencia propia de la persona cuenta como fuente cuando está etiquetada como suya. Una cifra de su trabajo necesita un archivo en el proyecto o una cita de chat fechada registrada enresearch.md(etapa 3); sin ella es[NO VERIFICADO]y se queda fuera del archivo publicado. - Verifica los hechos sobre herramientas y plataformas con la documentación actual. Las características y los límites cambian, y el cómo se hizo del año pasado a menudo es incorrecto hoy.
- Los números de búsqueda son datos o están etiquetados. El volumen y la dificultad provienen de una herramienta que alguien ejecutó, con la fecha, o el archivo dice "no estimado". Un número adivinado presentado como dato es peor que ningún número.
- La persona revisa cada borrador antes de que se publique. Las entradas nuevas obtienen
draft: true. La skill nunca envía, despliega ni cambiadraftpor sí sola. La única excepción es un refresco de una entrada ya publicada, que mantienedraft: false(consulta la etapa 6). - Aprobación: cuándo, cómo y dónde van las ediciones. Este es el único lugar donde la skill lo define; la etapa 6 lo sigue.
- Cuándo: en cualquier momento después de que la etapa 6 haya escrito el archivo publicado y la persona haya leído la entrada. La misma sesión está bien.
- Cómo: un cambio. La persona establece
draft: falseensrc/content/blog/<slug>.md, o le dice a Claude que lo haga. Confirma quedatesea el día de publicación al mismo tiempo. - Dónde van las ediciones: antes de la etapa 6, en
posts/<carpeta>/draft.md. Después de la etapa 6, solo en el archivo publicado.draft.mdpermanece como el borrador que se entregó, ypublish.mdenumera cada cambio realizado después. - Qué lo retrasa: cualquier cosa que aún quede por hacer antes de la fecha (una página faltante, una afirmación
[NO VERIFICADO], una línea que imprime la auditoría de enlaces) mantiene la entrada endraft: truehasta que esté terminado.
- La fecha es la puerta de publicación. El sitio inicial mantiene oculta una entrada con fecha futura hasta su día y la enumera en Próximas Entradas.
- El trabajo del cliente permanece anónimo a menos que el cliente haya aceptado ser nombrado. Eliminar el nombre es el comienzo: verifica combinaciones de categoría, lugar y momento que aún lo identifiquen ("una tienda de velas en Vermont que se lanzó en marzo" es un nombre). Convierte los ingresos en proporciones o porcentajes.
- Responde primero. Un compás de contexto que el lector reconozca de su propio trabajo, luego la respuesta al final del tercer párrafo. Una pregunta nunca abre una entrada.
- Escribe para la búsqueda, con una llamada a la acción. Encabezados redactados como la gente busca, números en cifras, párrafos cortos. La acción principal es la de la sección 3 de BLOG.md, y coincide con
ctaensrc/site.config.mjs. El sitio inicial muestra ese botón, con un cuadro de suscripción, al final de cada entrada, por lo que el cuerpo no necesita un enlace de llamada a la acción de cierre. El cuerpo puede enlazar a la acción principal una vez, en el texto, solo donde encaje en la entrada, y solo a una página que exista o a la dirección decta. - Enlaza solo a páginas que estén activas en la fecha de publicación de la entrada. Eso significa cada enlace al dominio propio del sitio, tanto entradas como páginas. Escribe los enlaces al propio sitio como enlaces relativos (
/acerca-de/). La etapa 6 tiene la verificación. - El tono pertenece a la persona. Un borrador que suena a contenido competente pero de un extraño ha fallado, incluso si todas las reglas se cumplen.
Las correcciones se convierten en reglas
Cuando la persona corrige la misma cosa dos veces (una palabra, una apertura, un estilo de encabezado), ofrécele agregar una línea fechada a la sección de Correcciones de BLOG.md. La etapa 4 lee esa sección antes de cada borrador, por lo que una corrección hecha una vez se mantiene corregida.
Antes de entregar un borrador
Busca en el borrador cada palabra de la lista "Palabras a evitar" de BLOG.md, por ejemplo:
grep -n -i -E "palabra uno|palabra dos|—" posts/<carpeta>/draft.md
Una búsqueda de palabras se pierde las formas de las oraciones. Ejecuta la búsqueda de formas en la etapa 4 ("Formas que una búsqueda de palabras no capta"), luego lee el borrador una vez para las formas que BLOG.md enumera y que ninguna búsqueda capta, como una pregunta de apertura o un resumen de cierre. Verifica también cada oración factual contra research.md (etapa 4).
Luego, dile a la persona, en pocas líneas: dónde está el borrador, la búsqueda objetivo, la fecha prevista, cualquier cosa marcada como [NO VERIFICADO], cualquier problema de confidencialidad, y qué necesita decidir.
Opcional: una versión para el boletín
Si la persona también publica un boletín (Substack, Beehiiv, Kit o similar), el mismo conocimiento puede enviarse allí. Dale a la versión del boletín su propio título y su propia frase de búsqueda, para que las dos páginas no compitan en Google, y agrega el archivo del boletín a la verificación de superposición en las etapas 1 y 2.
Herramientas
Claude Code, o Claude con acceso a los archivos del proyecto. Los datos de búsqueda provienen de herramientas gratuitas: autocompletado de Google, Google Search Console, el plan gratuito de Ubersuggest y una búsqueda simple de Google para la primera página. Si una herramienta no está conectada, pídele a la persona que pegue lo que ve (Ubersuggest funciona bien en su sitio web), o marca el número como no estimado. Un sitio nuevo sin datos y sin herramientas aún puede continuar: references/01-ideacion.md tiene el camino.
Sin acceso web en esta sesión: la etapa 1 clasifica las ideas según la evidencia que tiene y marca el resto como "no verificado". La persona pega las sugerencias de autocompletado y la primera página para la búsqueda objetivo que eligió, en la etapa 2, antes de que se apruebe el brief. Nadie pega para toda la lista corta. Mantén las claves de API fuera de BLOG.md y fuera de las carpetas de las entradas.