# Habilidad de Agente de Escritura de Blogs con IA para Claude Code > 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. - Canonical: https://nanoskill.ai/es/skills/ai-blog-writing-skill - Markdown: https://nanoskill.ai/es/skills/ai-blog-writing-skill.md - Author: AgriciDaniel - Published: 2026-05-24T06:35:19.314Z - Updated: 2026-07-25T04:39:13.470Z - Language: es - Source type: github - Popularity signal: 818 ## Sources - https://github.com/AgriciDaniel/claude-blog ## Install ```shell npx skills add https://github.com/AgriciDaniel/claude-blog ``` ## About 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. ## Key features - **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. ## Use cases - **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. ## Result preview Ve un listículo real sobre las mejores herramientas de PPT con IA creado por esta Habilidad de Agente. ![blog-writing-demo-01](https://file.nanoskill.ai/blog-writing-demo-01) ![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02) ![blog-writing-demo-03](https://file.nanoskill.ai/blog-writing-demo-03) ![blog-writing-demo-4](https://file.nanoskill.ai/blog-writing-demo-4) ## Result walkthrough ### Paso 1: Instalar Añade la habilidad a tu agente. ![blog-writing-step-1](https://file.nanoskill.ai/blog-writing-step-1) ### Paso 2:Generar Contenido Usa un comando específico para generar contenido de blog. ![blog-writing-step-2](https://file.nanoskill.ai/blog-writing-step-2) ### Paso 3:Revisar y Editar Revisa el contenido y edita en el documento de Word generado. ![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03) ## Skill definition # 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`](https://github.com/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`](https://github.com/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](https://www.skool.com/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`](docs/PUBLISHING.md). > **Blog:** [Ve cómo funciona claude-blog](https://agricidaniel.com/blog/claude-code-blog-writer) **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`: ```markdown --- 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//` para el contenido de la habilidad, `~/.claude/agents/.md` para los agentes, y `~/.claude/scripts/.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.` (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](#demostración) - [Inicio Rápido](#inicio-rápido) - [Comandos](#comandos) - [¿Cómo se compara claude-blog?](#cómo-se-compara-claude-blog) - [Características](#características) - [Contrato de entrega (v1.9.0)](#contrato-de-entrega-v190) - [Arquitectura](#arquitectura) - [Requisitos](#requisitos) - [Preguntas Frecuentes](#preguntas-frecuentes) - [Hoja de Ruta](#hoja-de-ruta) - [Desinstalación](#desinstalación) - [Integración](#integración) - [Documentación](#documentación) - [Cómo citar](#cómo-citar) - [Seguridad y Código de Conducta](#seguridad-y-código-de-conducta) - [Contribuciones](#contribuciones) - [Licencia](#licencia) - [Proyectos relacionados](#proyectos-relacionados) - [Autor](#autor) ## Demostración [Ver la Demostración en YouTube](https://www.youtube.com/watch?v=AeLC4iutG8w)

Demostración del comando claude-blog: enrutando subcomandos /blog a través del orquestador

--- ## 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`](https://github.com/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](https://www.skool.com/ai-marketing-hub-pro) para que te agreguen. **Instalación del Complemento (Claude Code 1.0.33+):** ```bash # 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): ```bash 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):** ```bash curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash ``` **Instalación con un Solo Comando (Windows PowerShell):** ```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):** ```bash # 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](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh) 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 ` para definir el alcance de tu blog, `/blog write ` para generar tu primer artículo (el contrato de 5 compuertas se ejecuta automáticamente), y `/blog analyze ` para puntuarlo en la rúbrica de 100 puntos.

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

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

| Comando | Descripción | |---------|-------------| | `/blog write ` | Escribir un nuevo artículo de blog desde cero | | `/blog rewrite ` | Optimizar un artículo de blog existente | | `/blog analyze ` | Auditoría de calidad con puntuación de 0-100 | | `/blog brief ` | Generar un resumen detallado de contenido | | `/blog calendar` | Generar un calendario editorial | | `/blog strategy ` | Estrategia de blog e ideación de temas | | `/blog outline ` | Esquema de contenido informado por SERP | | `/blog seo-check ` | Validación SEO posterior a la escritura | | `/blog schema ` | Generar marcado de esquema JSON-LD | | `/blog repurpose ` | Reutilizar para redes sociales, correo electrónico, YouTube | | `/blog geo ` | 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 ` | 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 ` | 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] ` | Planificación + ejecución de clústeres semánticos de temas (hub-and-spoke) | | `/blog multilingual --languages ` | Escribir, traducir, localizar y emitir hreflang en un solo comando | | `/blog translate --to ` | Traducción optimizada para SEO con preservación de formato | | `/blog localize --locale ` | Adaptación cultural profunda por configuración regional | | `/blog locale-audit ` | 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 ` | 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: | Capacidad | claude-blog | Solicitud directa a Claude / ChatGPT | Copy.ai / Jasper | Constrú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ía | Puntos | Enfoque | |----------|--------|-------| | Calidad del Contenido | 30 | Profundidad, legibilidad, originalidad, compromiso | | Optimización SEO | 25 | Encabezados, título, palabras clave, enlaces, meta | | Señales E-E-A-T | 15 | Autor, citas, confianza, experiencia | | Elementos Técnicos | 15 | Esquema, imágenes, velocidad, móvil, etiquetas OG | | Preparación para Citación de IA | 15 | Citabilidad, 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: | Referencia | Propósito | Usado por | |---|---|---| | `ai-slop-detection.md` | Detección de contenido de IA en dos niveles: primer orden (frases) + segundo orden (ritmo estructural) | `blog-rewrite`, `blog-reviewer`, `blog-analyze` | | `editorial-heuristics.md` | 10 heurísticas adaptadas de Nielsen con puntuación de 0-4 + etiquetado de gravedad P0-P3 | `blog-analyze --rubric` | | `cognitive-load.md` | Densidad 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.md` | Rúbrica de investigación de 5 dimensiones + 4 clases de trampa de palabras clave previas al vuelo + pisos de actualidad | `blog-researcher`, `blog-discourse`, `blog-brief`, `blog-strategy` | | `synthesis-contract.md` | 6 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`](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`](https://github.com/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.

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

## Contrato de entrega (v1.9.0)

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

Cada blog pasa un contrato de 5 compuertas antes de mostrarse al usuario. El usuario nunca es el primer revisor; las compuertas lo son. | Compuerta | Impone | Implementación | |---|---|---| | 1. Descubrimiento de Capacidad | Herramientas y agentes requeridos presentes antes de escribir | `scripts/blog_preflight.py --gate 1` | | 2. Integridad de Formato | `.md` + `.html` + `.pdf` + imagen de héroe real | `scripts/blog_render.py`, `scripts/generate_hero.py` | | 3. Verificación Visual | Sin desbordamiento SVG, JSON-LD válido, el modo oscuro se renderiza correctamente | `patchright` / `playwright` en 3 anchos de viewport | | 4. Revisión de Contenido (BLOQUEANTE) | Puntuación de `blog-reviewer` 90+ Y cero problemas P0 | `agents/blog-reviewer.md` (bloqueante, v1.9.0) | | 5. Integridad de Activos y Enlaces | Cada 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`](skills/blog/references/blog-delivery-contract.md). ## Arquitectura

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

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. | Capa | Cantidad | Ubicación | |---|---:|---| | Sub-habilidades (invocables por el usuario) | 29 | `skills/blog-*/SKILL.md` | | Sub-habilidades (internas) | 1 | `skills/blog-chart/SKILL.md` | | Agentes especializados | 5 | `agents/blog-*.md` | | Referencias bajo demanda | 21 | `skills/blog/references/*.md` | | Plantillas de contenido | 12 | `skills/blog/templates/*.md` | | Scripts Python de nivel raíz | 9 | `scripts/*.py` | | Pruebas | 160 | `tests/test_*.py` | Árbol de directorios completo, diagramas de flujo de datos, metodología de puntuación y puntos de extensión: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). ## Requisitos - [Claude Code](https://docs.anthropic.com/en/docs/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: ```bash 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`](https://github.com/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`](skills/blog/references/blog-delivery-contract.md). ### ¿Puedo usar claude-blog en varios idiomas? Sí. `/blog multilingual --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](#cómo-citar) más abajo o el archivo [`CITATION.cff`](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`](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`](SECURITY.md) para el modelo de amenazas completo. ## Hoja de Ruta

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)

**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: ```bash chmod +x uninstall.sh && ./uninstall.sh ``` Windows (PowerShell): ```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): | Habilidad | Integración | |-------|-------------| | `/seo` | Análisis SEO profundo de páginas de blog publicadas | | `/seo-schema` | Validación y generación de marcado de esquema | | `/seo-geo` | Auditoría de optimización para citación de IA | | `/seo-google` | Datos de la API de Google (configuración compartida con blog-google) | ## Documentación La documentación detallada está en [`docs/`](docs/): - [Guía de Instalación](docs/INSTALLATION.md): Unix, macOS, Windows, instalación manual. - [Referencia de Comandos](docs/COMMANDS.md): Referencia completa de comandos con ejemplos. - [Arquitectura](docs/ARCHITECTURE.md): Diseño del sistema y descripción general de componentes. - [Flujo de Trabajo de Publicación](docs/PUBLISHING.md): Flujo de lanzamiento de privado a público (mantenedores Pro). - [Plantillas](docs/TEMPLATES.md): Referencia y personalización de plantillas. - [Solución de Problemas](docs/TROUBLESHOOTING.md): Problemas comunes y soluciones. - [Integración MCP](docs/MCP-INTEGRATION.md): Configuración opcional del servidor MCP. ## Cómo citar Si usas claude-blog en investigación o producción, por favor cita el proyecto: ```bibtex @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`](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`](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`](SECURITY.md). - **Código de Conducta**: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Pacto de Colaboradores. Sé excelente con los demás. ## Contribuciones Contribuciones bienvenidas. Consulta [`CONTRIBUTING.md`](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`](docs/PUBLISHING.md)). ## Licencia Licencia MIT. Consulta [`LICENSE`](LICENSE) para más detalles. ## Proyectos relacionados - **[Rankenstein](https://rankenstein.pro)**: Flujo de trabajo de publicación de contenido basado en GUI; de la investigación a la publicación en una plataforma. - **[Marco FLOW](https://github.com/AgriciDaniel/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](https://github.com/AgriciDaniel/claude-ads)** y **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**: habilidades hermanas que comparten el mismo kit de marca (banner + diagramas generados con la paleta naranja de la marca). - **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)**: Comunidad gratuita, más de 2,800 miembros. El nivel Pro en [`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro) aloja el espejo privado de esta habilidad. ## Historial de estrellas Historial de estrellas de AgriciDaniel/claude-blog en GitHub Si claude-blog te ahorra tiempo, una estrella en el [repositorio público](https://github.com/AgriciDaniel/claude-blog) es la forma más fácil de decir gracias (y ayuda a otros creadores de contenido a encontrarlo). ## Autor Construido por [Daniel Agrici](https://agricidaniel.com/about), Arquitecto de Flujos de Trabajo de IA, con Claude Code. - [Blog](https://agricidaniel.com/blog): Inmersiones profundas en automatización de marketing con IA. - [YouTube](https://www.youtube.com/@AgriciDaniel): Tutoriales y demostraciones. - [Todas las herramientas de código abierto](https://github.com/AgriciDaniel): Otras habilidades de Claude Code. - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub): Comunidad gratuita para marketing impulsado por IA. ## FAQ ### ¿Qué es la habilidad claude-blog? claude-blog es un conjunto de habilidades de Claude Code diseñado para escribir, optimizar y auditar contenido de blog a gran escala. Garantiza que cada artículo esté optimizado tanto para los rankings de Google como para las plataformas de citación de IA. ### ¿Para quién es esta habilidad de escritura de blog con IA? Es para blogueros y creadores individuales que quieren publicar posts de alta calidad de manera eficiente, equipos de marketing y agencias que gestionan grandes carteras de contenido, y constructores de habilidades de Claude Code que buscan una referencia de nivel de producción para la arquitectura de habilidades. ### ¿Cómo funciona el Contrato de Entrega de 5 puertas? El Contrato de Entrega de 5 puertas califica cada borrador contra una rúbrica de 100 puntos en las áreas de Capacidad, Formato, Visual, Revisión de Contenido e Integridad de Activos. Cualquier borrador que obtenga menos de 90 puntos se bloquea y el escritor itera hasta tres veces antes de escalarlo a usted. ### ¿Qué tipo de contenido produce claude-blog? Produce 8 artefactos en una sola carpeta, incluyendo un archivo markdown con título, descripción, fecha, autor, etiquetas y URL canónica, además de HTML renderizado, PDF, imágenes hero, capturas de pantalla, una tarjeta de puntuación de revisión y un informe de auditoría previa. ### ¿Puede esta habilidad manejar contenido multilingüe? Sí, soporta publicación multilingüe con un solo comando, incluyendo escritura, traducción, localización y emisión de hreflang. También ofrece traducción optimizada para SEO con preservación de formato y adaptación cultural profunda por región. ### ¿Cómo garantiza claude-blog la calidad y precisión del contenido? Utiliza un sistema de puntuación de calidad de 5 categorías, detección de contenido de IA para marcar texto generado por máquinas, escritura basada en personas con aplicación de estilo, y un proceso de verificación de hechos que comprueba estadísticas contra fuentes citadas.