NanoSkill
Enviar tu skill

Habilidad de Agente de Escritura de Blogs con IA para Claude Code

porAgriciDaniel818estrellas de GitHubGitHub

Genera, optimiza y audita contenido de blog a escala con esta habilidad de agente de escritura de blogs con IA para Claude Code. Produce artículos con optimización dual para rankings de Google y plataformas de citación de IA, garantizando contenido de alta calidad y amigable con SEO en todo momento.

blogEscaneo de seguridad aprobado
Vista previa del resultado

Demo completa

Ve un listículo real sobre las mejores herramientas de PPT con IA creado por esta Habilidad de Agente.

Primeros pasos

Ejecuta tu primera tarea

  1. blog-writing-step-1
    01

    Paso 1: Instalar

    Añade la habilidad a tu agente.

  2. blog-writing-step-2
    02

    Paso 2:Generar Contenido

    Usa un comando específico para generar contenido de blog.

  3. blog-writing-step-03
    03

    Paso 3:Revisar y Editar

    Revisa el contenido y edita en el documento de Word generado.

Comando de instalación

$ npx skills add https://github.com/AgriciDaniel/claude-blog

Acerca de

La Habilidad de Escritura de Blogs y Optimización SEO para Claude Code, conocida como claude-blog, es una suite integral diseñada para automatizar y mejorar tu flujo de trabajo de creación de contenido. Esta poderosa habilidad escribe, optimiza y audita contenido de blog a escala, asegurando que cada artículo esté meticulosamente elaborado tanto para los rankings de búsqueda de Google como para las plataformas de citación de IA. Es una herramienta indispensable para cualquiera que busque producir contenido de alta calidad y amigable con SEO de manera consistente y eficiente.

Distinguido por su robusto Contrato de Entrega de 5 puertas, claude-blog garantiza la calidad del contenido puntuando cada borrador contra una rúbrica de 100 puntos y bloqueando cualquier cosa por debajo de 90. Ofrece optimización dual, apuntando al cumplimiento de la Actualización Principal de diciembre de 2025 y las señales E-E-A-T para Google, mientras también prepara contenido para plataformas de citación de IA como ChatGPT y Perplexity. Con 30 sub-habilidades, 5 agentes y 12 plantillas de contenido, maneja todo el ciclo de vida del contenido, desde la investigación y el esquema hasta la generación de esquemas y la verificación de citas.

Ya seas un blogger solitario que busca una publicación semanal de alta calidad, un equipo de marketing que gestiona carteras de contenido diverso o un constructor de habilidades de Claude Code que busca una referencia de grado de producción, claude-blog ofrece soluciones personalizadas. Admite planificación de grupos de temas, publicación multilingüe, perfiles de voz basados en personas e incluye funciones avanzadas como detección de canibalización de palabras clave y un proceso de verificación de hechos para garantizar precisión y prevenir conflictos de contenido.

Funciones clave

Qué la hace potente

  • Contrato de Entrega de 5 Puertas

    Cada borrador pasa por un riguroso contrato de entrega de 5 puertas (Capacidad, Formato, Visual, Revisión de Contenido, Integridad de Activos) con una rúbrica de 100 puntos, bloqueando cualquier cosa por debajo de 90 para que no llegue a usted.

  • Optimización Dual para SEO y Citas de IA

    Cada artículo está optimizado para los rankings de Google (Actualización Principal de Diciembre de 2025, E-E-A-T) y plataformas de citación de IA (ChatGPT, Perplexity, AI Overviews), maximizando la visibilidad y la citabilidad.

  • Generación Integral de Contenido

    Un motor de blog de ciclo de vida completo con 30 sub-habilidades, 5 agentes y 12 plantillas de contenido, que cubre investigación, esquema, borrador, esquema, enlazado interno y verificación de citas en una sola invocación.

  • Escritura Basada en Personas y Verificación de Hechos

    Gestione personas de escritura configurables con marcos de tono y bandas de legibilidad, junto con un proceso de verificación de hechos que verifica estadísticas contra fuentes citadas para garantizar la precisión.

  • Detección de Canibalización de Palabras Clave

    Identifique y resuelva la superposición de palabras clave en las publicaciones del blog con puntuación de gravedad y recomendaciones para evitar que el contenido compita contra sí mismo en las SERPs.

Casos de uso

Cuándo usarla

  • Generar Publicaciones de Blog de Alta Calidad

    Blogueros y creadores individuales pueden publicar una publicación de alta calidad por semana sin listas de verificación SEO manuales, manejando investigación, esquema, borrador, esquema, enlazado interno y verificación de citas.

  • Gestionar Contenido a Escala para Equipos

    Los equipos de marketing y agencias pueden gestionar muchas publicaciones en diversos temas e idiomas con funciones como planificación de clústeres temáticos, publicación multilingüe y perfiles de voz basados en personas.

  • Auditar y Optimizar Contenido Existente

    Utilice la habilidad para analizar publicaciones de blog existentes con una puntuación de calidad de 0-100, realice validación SEO post-escritura y detecte canibalización de palabras clave en su sitio.

SKILL.md

Habilidad de Escritura de Blogs con IA y Optimización SEO para Claude Code (claude-blog)

Dos versiones de esta habilidad. Elige la que se adapte a tu forma de trabajar:

  • 🌐 Código abierto público: AgriciDaniel/claude-blog. Con licencia MIT, lanzamientos públicos, abierto a cualquiera. Úsala si quieres la versión estable, descargable y sin necesidad de membresía.
  • 🔒 Espejo privado comunitario (este repositorio): AI-Marketing-Hub/claude-blog. Acceso anticipado a trabajos en desarrollo (v1.9.0+ Contrato de Entrega de Blog, escalera de héroe, cobertura de regresión probada por mutación), y colaboración directa con la comunidad de AI Marketing Hub Pro. Requiere membresía.

Las insignias de arriba hacen seguimiento al repositorio público (AgriciDaniel/claude-blog) ya que el espejo privado no es visible para shields.io. El flujo de trabajo de publicación (desarrollo privado, revisión, lanzamiento público) está documentado en docs/PUBLISHING.md.

Blog: Ve cómo funciona claude-blog

claude-blog es un conjunto de habilidades de Claude Code que escribe, optimiza y audita contenido de blog a escala. Cada artículo está doblemente optimizado para los rankings de Google (Actualización de Diciembre de 2025, E-E-A-T) y plataformas de citación de IA (ChatGPT, Perplexity, AI Overviews). Un Contrato de Entrega de 5 compuertas v1.9.0 puntúa cada borrador contra una rúbrica de 100 puntos y bloquea cualquier cosa por debajo de 90 antes de que llegue a ti.

Puntos clave

  • Qué es: un motor de blog de ciclo de vida completo: 30 sub-habilidades, 5 agentes, 12 plantillas de contenido, 21 referencias bajo demanda, 9 scripts Python de nivel raíz, 160 pruebas que pasan.
  • Para quién es: bloggers solitarios, equipos de marketing, agencias y constructores de habilidades de Claude Code que desean contenido de calidad de producción, no borradores de un solo intento.
  • Promesa central: cada borrador pasa un contrato de entrega de 5 compuertas (Descubrimiento de Capacidad, Integridad de Formato, Verificación Visual, Revisión de Contenido, Integridad de Activos) o el escritor itera hasta 3 veces antes de escalarlo a ti.
  • Lo que lo hace diferente: se come su propia comida para perros. La coherencia de versión se aplica por CI en 14 superficies, la higiene de prosa se ejecuta en cada PR, tres suites de regresión probadas por mutación bloquean las correcciones de v1.9.0, y blog-reviewer es una compuerta BLOQUEANTE, no consultiva.
  • Hoy: v1.9.0, lanzado el 18 de mayo de 2026. Funciona en Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby y HTML estático.

¿Para quién es claude-blog?

claude-blog sirve a tres audiencias con un solo motor:

Bloggers y creadores solitarios que quieren publicar una publicación de alta calidad por semana sin pasar tres horas en la lista de verificación de SEO. El orquestador maneja la investigación, esquema, borrador, esquema de datos, enlaces internos y verificación de citas en una sola invocación de /blog write.

Equipos de marketing y agencias que gestionan muchas publicaciones en temas, idiomas y plataformas. La habilidad incluye planificación de clústeres de temas (/blog cluster), publicación multilingüe con un solo comando (/blog multilingual), detección de canibalización (/blog cannibalization), y perfiles de voz impulsados por personas (/blog persona) para que el mismo motor produzca contenido consistente en todo el equipo.

Constructores de habilidades de Claude Code que quieren una referencia de calidad de producción para arquitectura de habilidades, despacho de agentes, contratos de entrega y compuertas de CI. El repositorio demuestra el estándar abierto Agent Skills en complejidad de Nivel 4 con 160 pruebas, aplicación de coherencia de versión, pruebas de regresión de sincronización del instalador y el patrón de contrato de 5 compuertas v1.9.0. Lee el código fuente para inspirarte; bifurca los patrones en tus propias habilidades.

¿Qué produce claude-blog?

Cada borrador se entrega como 8 artefactos en una sola carpeta. Un espécimen condensado de la salida .md:

---
title: "¿Dónde debería instalarse un complemento de habilidad de Claude Code?"
description: "Una respuesta práctica a la pregunta de la ruta de instalación..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, habilidades, complementos, instalación]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# ¿Dónde debería instalarse un complemento de habilidad de Claude Code?

La respuesta corta: la mayoría de los complementos de habilidad de Claude Code instalables por el usuario
deberían enviarse a `~/.claude/skills/<name>/` para el contenido de la habilidad,
`~/.claude/agents/<name>.md` para los agentes, y
`~/.claude/scripts/<helper>.py` para cualquier ayudante Python.

## Puntos Clave
- `~/.claude/skills/` es el área superficial de SKILL.md.
- `~/.claude/agents/` contiene archivos markdown de agente.
- ... (artículo completo, citas con fuentes, preguntas frecuentes, esquema JSON-LD)

Junto al .md, el contrato también produce: .html renderizado (JSON-LD seguro contra XSS, CSS consciente del modo oscuro), .pdf (Playwright o weasyprint), hero.<ext> (1200x630, generado vía Banana MCP, Gemini, APIs de stock, o Openverse), 3 capturas de pantalla de viewport (mobile-375.png, tablet-768.png, desktop-1280.png), review.md (tarjeta de puntuación de 5 categorías con línea BLOQUEANTE), y preflight-report.json (la pista de auditoría completa).

Índice

  • Demostración
  • Inicio Rápido
  • Comandos
  • ¿Cómo se compara claude-blog?
  • Características
  • Contrato de entrega (v1.9.0)
  • Arquitectura
  • Requisitos
  • Preguntas Frecuentes
  • Hoja de Ruta
  • Desinstalación
  • Integración
  • Documentación
  • Cómo citar
  • Seguridad y Código de Conducta
  • Contribuciones
  • Licencia
  • Proyectos relacionados
  • Autor

Demostración

Ver la Demostración en YouTube

<p align="center"> <img src="assets/blog-command-demo.gif" alt="Demostración del comando claude-blog: enrutando subcomandos /blog a través del orquestador" width="100%"> </p>

Inicio Rápido

ℹ️ ¿Qué versión estás instalando?

  • ¿No eres miembro de AI Marketing Hub Pro? Instala desde el repositorio público: AgriciDaniel/claude-blog. Todos los comandos de instalación a continuación funcionan allí. Solo cambia AI-Marketing-Hub/claude-blog por AgriciDaniel/claude-blog y el slug del complemento claude-blog@ai-marketing-hub-claude-blog por claude-blog@agricidaniel-claude-blog. Los lanzamientos públicos se publican allí; este espejo privado va por delante.
  • ¿Miembro Pro? Los comandos a continuación instalan la versión comunitaria con acceso anticipado a características en desarrollo. Requieren una sesión autenticada gh auth login (o PAT de GitHub) con acceso a la organización AI-Marketing-Hub. Si /plugin marketplace add falla con un 404, tu cuenta aún no está en la organización. Envía un mensaje directo en la comunidad de Skool para que te agreguen.

Instalación del Complemento (Claude Code 1.0.33+):

# Agregar marketplace (una vez)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Instalar complemento
/plugin install claude-blog@ai-marketing-hub-claude-blog

Recomendado: clonar, verificar y luego instalar (te permite inspeccionar install.sh y fijar una etiqueta de lanzamiento):

git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # fijar a una etiqueta de lanzamiento (última al 18 de mayo de 2026)
chmod +x install.sh && ./install.sh

Instalación con un Solo Comando (Unix/macOS):

curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash

Instalación con un Solo Comando (Windows PowerShell):

irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex

Entubar curl o irm a un shell otorga al script autoridad de ejecución en tu máquina. El flujo de clonar, luego cambiar a la etiqueta es más seguro porque puedes inspeccionar lo que se ejecuta. Ambos flujos se autentican contra el repositorio privado usando tus credenciales existentes de gh auth / GitHub.

Verificar la integridad del instalador (recomendado, endurecimiento VULN-IAC-001):

# Descargar, verificar SHA-256 y luego ejecutar si el hash coincide.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh

El SHA-256 anterior es para el install.sh actual en HEAD en main. Verifica contra el archivo canónico antes de ejecutar. El hash compañero install.ps1 es 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98. Los hashes se actualizan en este README en cada cambio del instalador.

Reinicia Claude Code después de la instalación para activarlo.

Comandos

🚀 ¿Primera vez? Prueba estos tres comandos primero: /blog strategy <niche> para definir el alcance de tu blog, /blog write <topic> para generar tu primer artículo (el contrato de 5 compuertas se ejecuta automáticamente), y /blog analyze <file> para puntuarlo en la rúbrica de 100 puntos.

<p align="center"> <img src="assets/blog-write-demo.gif" alt="Demostración de /blog write de claude-blog: generación de artículo de extremo a extremo con el Contrato de Entrega de 5 compuertas" width="100%"> </p> <p align="center"> <img src="assets/diagrams/03-sub-skill-map-B.svg" alt="Ecosistema de sub-habilidades de claude-blog: centro del orquestador con 30 sub-habilidades organizadas en 8 clústeres temáticos (escritura, estrategia, calidad, IA y búsqueda, multilingüe, investigación, medios, distribución); los tamaños de los paneles se escalan automáticamente según el número de habilidades" width="100%"> </p>
ComandoDescripción
/blog write <topic>Escribir un nuevo artículo de blog desde cero
/blog rewrite <file>Optimizar un artículo de blog existente
/blog analyze <file>Auditoría de calidad con puntuación de 0-100
/blog brief <topic>Generar un resumen detallado de contenido
/blog calendarGenerar un calendario editorial
/blog strategy <niche>Estrategia de blog e ideación de temas
/blog outline <topic>Esquema de contenido informado por SERP
/blog seo-check <file>Validación SEO posterior a la escritura
/blog schema <file>Generar marcado de esquema JSON-LD
/blog repurpose <file>Reutilizar para redes sociales, correo electrónico, YouTube
/blog geo <file>Auditoría de preparación para citación de IA
/blog image [generate|edit|setup]Generación de imágenes con IA vía Gemini
/blog audit [directory]Evaluación completa de la salud del blog
/blog cannibalization [directory]Detectar superposición de palabras clave entre publicaciones
/blog factcheck <file>Verificar estadísticas contra las fuentes citadas
/blog persona [create|list|apply]Gestionar personas de escritura y perfiles de voz
/blog taxonomy [sync|audit|suggest]Gestión de etiquetas/categorías del CMS
/blog notebooklm <question>Consultar NotebookLM para investigación basada en fuentes
/blog audio [generate|voices|setup]Generar narración de audio vía Gemini TTS
/blog google [command] [args]Datos de la API de Google: PSI, CrUX, GSC, GA4, NLP, YouTube, Palabras Clave
/blog cluster [plan|execute] <seed>Planificación + ejecución de clústeres semánticos de temas (hub-and-spoke)
/blog multilingual <topic> --languages <codes>Escribir, traducir, localizar y emitir hreflang en un solo comando
/blog translate <file> --to <codes>Traducción optimizada para SEO con preservación de formato
/blog localize <file> --locale <code>Adaptación cultural profunda por configuración regional
/blog locale-audit <directory>Control de calidad de contenido multilingüe (integridad, hreflang, paridad, actualidad)
/blog flow [find|optimize|win|prompts|sync]Prompts del marco FLOW (liderados por evidencia, 30 aplicables al blog)
/blog brand [init|show|update]Generar contexto BRAND.md + VOICE.md cargado automáticamente por todas las sub-habilidades
/blog discourse <topic>Investigación de discurso de los últimos 30 días sin API; produce DISCOURSE.md

Total de 30 directorios de sub-habilidades: 29 invocables por el usuario (28 comandos slash distintos + /blog update alias de rewrite) + 1 solo interno (blog-chart, invocado por blog-write/blog-rewrite para gráficos SVG en línea). blog-image es invocable por el usuario Y también se puede llamar internamente.

¿Cómo se compara claude-blog?

claude-blog es un pipeline estructurado. La solicitud directa a LLM es de un solo intento. Las herramientas SaaS alojadas son de código cerrado. Aquí está la matriz de compensación honesta:

Capacidadclaude-blogSolicitud directa a Claude / ChatGPTCopy.ai / JasperConstrúyelo tú mismo
Artículo completo en un comando, con bucle de iteración✅ (contrato de 5 compuertas, hasta 3 reintentos)⚠️ un solo intento
Estadísticas con fuentes verificadas/blog factcheck obtiene las URLs de las fuentes❌ alucina⚠️ manual
Optimización para citación de IA (GEO / AEO)✅ auditoría dedicada /blog geo⚠️
Revisión de contenido bloqueante (puntuación >= 90 para entregar)✅ agente blog-reviewer
Multilingüe + hreflang en un solo comando/blog multilingual⚠️ sin hreflang⚠️
Planificación de clústeres de temas (hub-and-spoke)/blog cluster⚠️
Narración de audio✅ Gemini TTS, 30 voces
Generación de imagen de héroe (escalera de 4 pasos)✅ Banana, Gemini, stock, Openverse⚠️ solo stock⚠️
Contexto persistente de marca y voz✅ BRAND.md + VOICE.md cargado automáticamente❌ por solicitud⚠️ limitado
Código abierto, MIT, sin costo de uso✅ gratis❌ suscripción❌ suscripción

claude-blog no es mejor en todo. La solicitud directa es más rápida para un borrador único desechable. El SaaS alojado es más fácil para no desarrolladores. El bricolaje es más flexible para pipelines únicos. claude-blog encaja cuando quieres contenido de calidad de producción a escala sin una suscripción SaaS.

Características

12 plantillas de contenido

Seleccionadas automáticamente por tema e intención: guía práctica, lista, caso de estudio, comparación, página pilar, reseña de producto, liderazgo de pensamiento, resumen, tutorial, análisis de noticias, investigación de datos, base de conocimiento de preguntas frecuentes.

Puntuación de calidad en 5 categorías (100 puntos)

CategoríaPuntosEnfoque
Calidad del Contenido30Profundidad, legibilidad, originalidad, compromiso
Optimización SEO25Encabezados, título, palabras clave, enlaces, meta
Señales E-E-A-T15Autor, citas, confianza, experiencia
Elementos Técnicos15Esquema, imágenes, velocidad, móvil, etiquetas OG
Preparación para Citación de IA15Citabilidad, formato de preguntas y respuestas, claridad de entidad

Bandas de puntuación: Excepcional (90-100), Fuerte (80-89), Aceptable (70-79), Por Debajo del Estándar (60-69), Reescribir (<60). El contrato v1.9.0 bloquea la entrega por debajo de 90.

Detección de contenido de IA

Puntuación de explosividad en la varianza de longitud de oraciones, detección de frases conocidas de IA (17 frases) y diversidad de vocabulario (TTR). Marca el contenido que suena generado por máquina antes de que llegue al revisor.

Escritura basada en personas

Personas de escritura configurables con el marco de tono de 4 dimensiones de NNGroup (formal/informal, serio/divertido, respetuoso/irreverente, objetivo/entusiasta). Gestiona perfiles de voz por blog o autor, con bandas de legibilidad (Consumidor, Profesional, Técnico) y aplicación de estilo en el momento del borrador.

Pipeline de verificación de hechos

/blog factcheck obtiene cada URL de fuente citada y puntúa la confianza de la afirmación como coincidencia exacta, paráfrasis o no encontrada. Asegura que cada dato sea preciso y rastreable, no inventado.

Detección de canibalización de palabras clave

/blog cannibalization identifica la superposición de palabras clave entre publicaciones de blog usando análisis grep local o la API de DataForSEO. Puntuación de gravedad con recomendaciones de fusionar o diferenciar evita que las publicaciones compitan entre sí en los SERPs.

Gestión de taxonomía del CMS

Sincronización de etiquetas y categorías compatible con WordPress REST, Shopify GraphQL, Ghost, Strapi y Sanity. Incluye flujos de trabajo de sugerencia, sincronización y auditoría de etiquetas.

Optimización dual

Cada artículo apunta tanto a los rankings de Google como a las plataformas de citación de IA:

  • Google: Cumplimiento de la Actualización de Diciembre de 2025, señales E-E-A-T, marcado de esquema, enlaces internos, conciencia de Core Web Vitals a través de blog-google.
  • Citas de IA: Formato de respuesta primero, cápsulas de citas, citabilidad a nivel de pasaje (bloques de 120-180 palabras), esquema de preguntas frecuentes, claridad de entidad.

Medios visuales

  • Búsqueda de imágenes de Pixabay, Unsplash y Pexels con verificación HTTP 200 y texto alternativo generado automáticamente.
  • Generación de imágenes con IA vía Gemini para imágenes de héroe, ilustraciones en línea y tarjetas sociales. Requiere una clave API gratuita de Google AI.
  • Generación de gráficos SVG incorporados en 7 estilos (barras, barras agrupadas, piruleta, dona, línea, área, radar).
  • Incrustación de videos de YouTube con carga diferida srcdoc y respaldo para rastreadores de IA con noscript.
  • Densidad de imágenes objetivo calibrada por tipo de contenido.

Integración con la API de Google (v1.6.5+)

13 comandos en 4 niveles de credenciales, todos gratuitos en uso normal:

  • Nivel 0 (clave API): PageSpeed Insights, CrUX Core Web Vitals (historial de 25 semanas), búsqueda de videos de YouTube, análisis de entidades NLP.
  • Nivel 1 (OAuth): rendimiento de Search Console, Inspección de URL, API de Indexación.
  • Nivel 2 (GA4): Informes de tráfico orgánico.
  • Nivel 3 (Ads): Planificador de Palabras Clave de Google Ads.

Investigación con NotebookLM

Consulta Google NotebookLM para investigación basada en fuentes de documentos subidos por el usuario. Calidad de datos de Nivel 1 con riesgo cero de alucinación porque las respuestas se extraen de documentos que subiste.

Narración de audio

/blog audio genera narración de audio vía Gemini TTS. Tres modos: resumen (200-300 palabras), artículo completo, diálogo de dos hablantes. 30 voces, más de 80 idiomas.

Soporte de plataformas

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby y HTML estático.

Metodologías fundacionales (v1.8.0)

Cinco documentos de referencia bajo skills/blog/references/ definen la metodología editorial y de investigación aplicada en todas las sub-habilidades. Se cargan bajo demanda por el orquestador:

ReferenciaPropósitoUsado por
ai-slop-detection.mdDetección de contenido de IA en dos niveles: primer orden (frases) + segundo orden (ritmo estructural)blog-rewrite, blog-reviewer, blog-analyze
editorial-heuristics.md10 heurísticas adaptadas de Nielsen con puntuación de 0-4 + etiquetado de gravedad P0-P3blog-analyze --rubric
cognitive-load.mdDensidad de concepto por sección (entidades, números, jerga, referencias hacia adelante, profundidad de cláusulas)blog-analyze --cognitive-load, scripts/cognitive_load.py
research-quality.mdRúbrica de investigación de 5 dimensiones + 4 clases de trampa de palabras clave previas al vuelo + pisos de actualidadblog-researcher, blog-discourse, blog-brief, blog-strategy
synthesis-contract.md6 LEYES que rigen la síntesis de investigación (sin bloque de Fuentes al final, citas en línea, etc.)Todas las sub-habilidades de síntesis de investigación

Adaptado de pbakaus/impeccable (Apache 2.0) y mvanhorn/last30days-skill (MIT). Consulta CONTRIBUTORS.md para la atribución.

Marco FLOW

El marco FLOW (Find, Leverage, Optimize, Win) es el flujo de trabajo liderado por evidencia compartido con AgriciDaniel/flow (CC BY 4.0). Cada fase contribuye con prompts al pipeline del orquestador; /blog flow expone 30 prompts listos para ejecutar indexados por fase.

<p align="center"> <img src="assets/diagrams/04-framework-B.svg" alt="Rueda radial del marco FLOW: cuatro fases (Find para descubrimiento de temas, Leverage para amplificación de activos, Optimize para mejora de contenido, Win para conversión del lector) dispuestas alrededor de un centro, con 10 prompts representativos en el anillo exterior" width="100%"> </p>

Contrato de entrega (v1.9.0)

<p align="center"> <img src="assets/diagrams/02-pipeline-A.svg" alt="Pipeline del Contrato de Entrega de Blog de 5 compuertas: Descubrimiento de Capacidad, Integridad de Formato, Verificación Visual, Revisión de Contenido (compuerta BLOQUEANTE, la puntuación debe ser 90 o superior con cero problemas P0), e Integridad de Activos y Enlaces. Itera hasta 3 veces en caso de falla antes de escalar al usuario" width="100%"> </p>

Cada blog pasa un contrato de 5 compuertas antes de mostrarse al usuario. El usuario nunca es el primer revisor; las compuertas lo son.

CompuertaImponeImplementación
1. Descubrimiento de CapacidadHerramientas y agentes requeridos presentes antes de escribirscripts/blog_preflight.py --gate 1
2. Integridad de Formato.md + .html + .pdf + imagen de héroe realscripts/blog_render.py, scripts/generate_hero.py
3. Verificación VisualSin desbordamiento SVG, JSON-LD válido, el modo oscuro se renderiza correctamentepatchright / playwright en 3 anchos de viewport
4. Revisión de Contenido (BLOQUEANTE)Puntuación de blog-reviewer 90+ Y cero problemas P0agents/blog-reviewer.md (bloqueante, v1.9.0)
5. Integridad de Activos y EnlacesCada imagen se resuelve, og:image existe, los enlaces devuelven 200, wordCount dentro del 5%scripts/blog_preflight.py --gate 5

Escalera de imagen de héroe: Banana MCP, API directa de Gemini, stock premium (Unsplash, Pexels, Pixabay), API pública de Openverse. El primero disponible gana. Bloquear e iterar hasta 3 veces en cualquier falla de compuerta antes de escalar al usuario. Especificación completa: skills/blog/references/blog-delivery-contract.md.

Arquitectura

<p align="center"> <img src="assets/diagrams/01-architecture-B.svg" alt="Arquitectura del sistema claude-blog: pipeline de izquierda a derecha desde el comando del usuario a través del enrutamiento del orquestador, ejecución de sub-habilidades y despacho de agentes hasta el contrato de entrega de 5 compuertas antes de llegar al usuario" width="100%"> </p>

claude-blog se distribuye como un orquestador más 29 sub-habilidades, 5 agentes, 21 referencias, 12 plantillas y 9 scripts de nivel raíz. El orquestador enruta los comandos del usuario a las sub-habilidades, que generan agentes y llaman scripts vía Bash.

CapaCantidadUbicación
Sub-habilidades (invocables por el usuario)29skills/blog-*/SKILL.md
Sub-habilidades (internas)1skills/blog-chart/SKILL.md
Agentes especializados5agents/blog-*.md
Referencias bajo demanda21skills/blog/references/*.md
Plantillas de contenido12skills/blog/templates/*.md
Scripts Python de nivel raíz9scripts/*.py
Pruebas160tests/test_*.py

Árbol de directorios completo, diagramas de flujo de datos, metodología de puntuación y puntos de extensión: docs/ARCHITECTURE.md.

Requisitos

  • Claude Code CLI instalado y configurado.
  • Python 3.11+ (para puntuación de calidad, los ejecutores del contrato de entrega de 5 compuertas y lint).
  • Opcional: pip install -r requirements.txt para análisis avanzado (puntuación de legibilidad, detección de esquemas).

Compuertas de calidad (aplicadas por CI en cada PR)

  1. pytest: 160 pruebas en suites de seguridad, comportamiento, regresión y contrato de entrega.
  2. Validación de complemento: claude plugin validate . más comprobaciones JSON/regex manuales.
  3. Lint de rutas obsoletas: detecta desincronización en referencias cruzadas de references/ y templates/.
  4. Higiene de prosa: scripts/lint_prose.py (consciente de vallas, consciente de acentos graves) aplica la regla CONTRIBUTING.md de no guiones largos, no guiones cortos, no --.
  5. Coherencia de versión: tests/test_version_coherence.py afirma que pyproject.toml, plugin.json, CITATION.cff y el frontmatter de skills/blog/SKILL.md coinciden.
  6. Coherencia de comandos: tests/test_command_coherence.py afirma que skills/blog/SKILL.md y docs/COMMANDS.md declaran el mismo conjunto de comandos.

Ejecuta localmente antes de enviar:

python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .

Preguntas Frecuentes

¿Qué es claude-blog?

claude-blog es un conjunto de habilidades de Claude Code para escribir, optimizar y auditar contenido de blog. Ejecuta 30 sub-habilidades y 5 agentes a través de un contrato de entrega de 5 compuertas para que cada artículo cumpla con un estándar de calidad de 90/100 antes de llegarte.

¿En qué se diferencia claude-blog de pedir directamente a Claude o ChatGPT?

La solicitud directa te da un borrador de una sola indicación. claude-blog te da un pipeline estructurado: investigación con estadísticas con fuentes, aprobación del esquema, generación de borrador, puntuación de calidad de múltiples pasadas, detección de contenido de IA, verificación de hechos, inyección de esquema y una revisión bloqueante que itera hasta 3 veces antes de la entrega. La habilidad impone lo que un editor senior haría manualmente de otra manera.

¿Necesito una membresía de AI Marketing Hub Pro para usar claude-blog?

No. La versión pública de código abierto en AgriciDaniel/claude-blog tiene licencia MIT y es gratuita para cualquiera con Claude Code. El espejo privado en AI-Marketing-Hub/claude-blog es para miembros Pro que desean acceso anticipado a características en desarrollo y colaboración directa con la comunidad.

¿Qué plataformas de blog soporta claude-blog?

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby y HTML estático. El orquestador detecta automáticamente la plataforma a partir de las señales del proyecto y ajusta el frontmatter, la incrustación de imágenes y la inyección de esquemas en consecuencia.

¿Alucina estadísticas claude-blog?

No. Cada estadística citada pasa por /blog factcheck, que obtiene la URL de la fuente y puntúa la confianza de la afirmación (coincidencia exacta, paráfrasis, no encontrada). El agente blog-reviewer bloquea la publicación si una cita no puede verificarse o si la detección de contenido de IA marca la prosa como generada por máquina.

¿Qué es el Contrato de Entrega de Blog de 5 compuertas?

Un pipeline de pre-presentación aplicado por código que se ejecuta en cada borrador: Descubrimiento de Capacidad, Integridad de Formato, Verificación Visual en 3 anchos de viewport, Revisión de Contenido (BLOQUEANTE; puntuación 90+ y cero P0) e Integridad de Activos y Enlaces. El orquestador itera al escritor hasta 3 veces en cualquier falla de compuerta antes de escalar a ti. Especificación completa en skills/blog/references/blog-delivery-contract.md.

¿Puedo usar claude-blog en varios idiomas?

Sí. /blog multilingual <topic> --languages en,de,fr,es,ja escribe la publicación, la traduce preservando el frontmatter y el esquema, realiza una adaptación cultural profunda por configuración regional y emite etiquetas hreflang más un mapa de idiomas listo para CMS en un solo comando.

¿Cómo cito claude-blog en un trabajo académico?

Consulta la sección Cómo citar más abajo o el archivo CITATION.cff en la raíz del repositorio. GitHub muestra el archivo de citación estructurado a través del botón "Cite this repository" en la página del espejo público.

¿Es seguro instalar claude-blog?

El instalador solo distribuye scripts Python y archivos markdown, nunca ejecuta código remoto más allá de lo que pip install -r requirements.txt trae, y se revisa contra la política SECURITY.md del proyecto en cada cambio. El flujo de instalación de clonar y luego cambiar a la etiqueta te permite inspeccionar install.sh antes de ejecutarlo. Consulta SECURITY.md para el modelo de amenazas completo.

Hoja de Ruta

<p align="center"> <img src="assets/diagrams/05-roadmap-A.svg" alt="Hoja de ruta en ondas de claude-blog en una línea de tiempo horizontal: v1.6.0 fundación (mar 2026), v1.7.0 marco FLOW (abr 2026), v1.8.0 metodología impecable (may 2026), v1.9.0 contrato de entrega (actual, may 2026), v2.0.0 publicación multi-CMS (Q3 2026), v3.0.0 blog-como-código (Q1 2027)" width="100%"> </p>

v1.9.1 (próxima)

  • Función compartida _count_body_words(html) entre blog_render y blog_preflight para cerrar el residual de auditoría v1.9.0.
  • Semántica de código de salida de generate_hero.py: distinto de cero en caso de no haber ruta de generación de imagen (actualmente devuelve error JSON con salida 0).
  • Prueba de cobertura del bucle de iteración que verifica que el orquestador escala después de 3 BLOQUEOS del revisor, no 4.
  • Barrer los documentos restantes (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) en busca de cualquier desviación residual del estrato v1.x.

v1.10 (visión)

  • Refinamiento del esquema en vivo informado por SERP a través de DataForSEO a mitad de la escritura.
  • Arnés de evaluación que mide la calidad del blog en diferentes configuraciones (presencia de BRAND.md, variante de persona, modo multilingüe).
  • Contador de iteraciones aplicado por código (actualmente instrucción del orquestador; promover a nivel de script).

v2.0 (largo plazo)

  • Integración de servidor de vista previa sin cabeza: el contrato de 5 compuertas se ejecuta contra una vista previa de dominio real en lugar de HTML local.
  • Conectores de publicación CMS por plataforma (WordPress, Ghost, Sanity) con republicación idempotente al reescribir.
  • Panel de seguimiento de citas de IA en tiempo real (qué publicaciones son citadas por ChatGPT, Perplexity, AI Overviews; mapa de calor de visibilidad).

Abre un issue con la etiqueta roadmap si quieres proponer o votar algo.

Desinstalación

Unix/macOS:

chmod +x uninstall.sh && ./uninstall.sh

Windows (PowerShell):

.\uninstall.ps1

Integración

La generación de gráficos y la incrustación de videos de YouTube están integradas. Los datos de la API de Google requieren una clave API gratuita (consulta /blog google setup).

Habilidades complementarias opcionales (análisis más profundo de páginas publicadas):

HabilidadIntegración
/seoAnálisis SEO profundo de páginas de blog publicadas
/seo-schemaValidación y generación de marcado de esquema
/seo-geoAuditoría de optimización para citación de IA
/seo-googleDatos de la API de Google (configuración compartida con blog-google)

Documentación

La documentación detallada está en docs/:

  • Guía de Instalación: Unix, macOS, Windows, instalación manual.
  • Referencia de Comandos: Referencia completa de comandos con ejemplos.
  • Arquitectura: Diseño del sistema y descripción general de componentes.
  • Flujo de Trabajo de Publicación: Flujo de lanzamiento de privado a público (mantenedores Pro).
  • Plantillas: Referencia y personalización de plantillas.
  • Solución de Problemas: Problemas comunes y soluciones.
  • Integración MCP: Configuración opcional del servidor MCP.

Cómo citar

Si usas claude-blog en investigación o producción, por favor cita el proyecto:

@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: Habilidad de Escritura de Blogs con IA y Optimización SEO para Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}

GitHub también muestra el archivo estructurado CITATION.cff a través de "Cite this repository" en la página del espejo público.

Seguridad y Código de Conducta

  • Política de seguridad + modelo de amenazas: SECURITY.md. El pase de endurecimiento v1.8.x cerró todos los hallazgos conocidos; v1.9.0 agrega JSON-LD seguro contra XSS, rechazo de enlaces simbólicos O_NOFOLLOW y validación de frontmatter, todo verificado por pruebas de mutación. Para reportar una vulnerabilidad de forma privada, sigue el procedimiento de divulgación en SECURITY.md.
  • Código de Conducta: CODE_OF_CONDUCT.md. Pacto de Colaboradores. Sé excelente con los demás.

Contribuciones

Contribuciones bienvenidas. Consulta CONTRIBUTING.md para las pautas. Antes de abrir un PR:

  1. Ejecuta python -m pytest tests/ (deben pasar las 160).
  2. Ejecuta python3 scripts/lint_prose.py --root . (cero violaciones).
  3. Ejecuta claude plugin validate . (debe pasar).
  4. Incrementa las versiones de manera coherente si tocas conteos o comportamientos visibles para el usuario (consulta docs/PUBLISHING.md).

Licencia

Licencia MIT. Consulta LICENSE para más detalles.

Proyectos relacionados

  • Rankenstein: Flujo de trabajo de publicación de contenido basado en GUI; de la investigación a la publicación en una plataforma.
  • Marco FLOW: Prompts liderados por evidencia para Encontrar, Optimizar, Ganar (CC BY 4.0). Integrado como sub-habilidad a través de /blog flow.
  • Claude Ads y Claude SEO: habilidades hermanas que comparten el mismo kit de marca (banner + diagramas generados con la paleta naranja de la marca).
  • AI Marketing Hub: Comunidad gratuita, más de 2,800 miembros. El nivel Pro en ai-marketing-hub-pro aloja el espejo privado de esta habilidad.

Historial de estrellas

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> <img alt="Historial de estrellas de AgriciDaniel/claude-blog en GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> </picture> </a>

Si claude-blog te ahorra tiempo, una estrella en el repositorio público es la forma más fácil de decir gracias (y ayuda a otros creadores de contenido a encontrarlo).

Autor

Construido por Daniel Agrici, Arquitecto de Flujos de Trabajo de IA, con Claude Code.

  • Blog: Inmersiones profundas en automatización de marketing con IA.
  • YouTube: Tutoriales y demostraciones.
  • Todas las herramientas de código abierto: Otras habilidades de Claude Code.
  • AI Marketing Hub: Comunidad gratuita para marketing impulsado por IA.

FAQ