NanoSkill
Invia la tua skill

Skill dell'Agente di Scrittura Blog IA per Codice Claude

diAgriciDaniel818stelle GitHubGitHub

Genera, ottimizza e verifica i contenuti del blog su larga scala con questa skill dell'agente di scrittura blog IA per Codice Claude. Produce articoli a doppia ottimizzazione per il posizionamento su Google e le piattaforme di citazione IA, garantendo contenuti di alta qualità e ottimizzati per la SEO ogni volta.

blogScansione di sicurezza superata
Anteprima risultato

Demo completa

Guarda un vero listicle sui migliori strumenti per PPT IA creato da questa Skill dell'Agente.

Per iniziare

Esegui il primo task

  1. blog-writing-step-1
    01

    Passo 1:Installa

    Aggiungi la skill al tuo agente.

  2. blog-writing-step-2
    02

    Passo 2:Genera contenuto

    Usa un comando specifico per generare contenuti del blog.

  3. blog-writing-step-03
    03

    Passo 3:Revisiona e modifica

    Revisiona il contenuto e modifica nel documento Word generato.

Comando di installazione

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

Segnali di installazione

Attività di installazione

Informazioni

La Skill di Scrittura Blog IA e Ottimizzazione SEO per Codice Claude, nota come claude-blog, è una suite completa progettata per automatizzare e migliorare il flusso di lavoro della creazione di contenuti. Questa potente skill scrive, ottimizza e verifica i contenuti del blog su larga scala, assicurando che ogni articolo sia meticolosamente creato sia per il posizionamento sui motori di ricerca di Google che per le piattaforme di citazione IA. È uno strumento indispensabile per chiunque desideri produrre contenuti di alta qualità e ottimizzati per la SEO in modo coerente ed efficiente.

Distinto per il suo solido Contratto di Consegna a 5 gate, claude-blog garantisce la qualità dei contenuti valutando ogni bozza con una griglia a 100 punti e bloccando tutto ciò che è al di sotto di 90. Offre una doppia ottimizzazione, puntando alla conformità con l'Aggiornamento Core di Dicembre 2025 e ai segnali E-E-A-T per Google, preparando al contempo i contenuti per le piattaforme di citazione IA come ChatGPT e Perplexity. Con 30 sotto-competenze, 5 agenti e 12 modelli di contenuto, gestisce l'intero ciclo di vita dei contenuti dalla ricerca e strutturazione alla generazione di schemi e verifica delle citazioni.

Che tu sia un blogger solitario che punta a un post settimanale di alta qualità, un team di marketing che gestisce portafogli di contenuti diversificati, o un creatore di skill per Codice Claude in cerca di un riferimento di livello produttivo, claude-blog offre soluzioni su misura. Supporta la pianificazione di cluster di argomenti, la pubblicazione multilingue, i profili vocali basati sulla persona e include funzionalità avanzate come il rilevamento della cannibalizzazione delle parole chiave e una pipeline di verifica dei fatti per garantire accuratezza e prevenire conflitti di contenuto.

Funzioni chiave

Cosa la rende potente

  • Contratto di Consegna a 5 Fasi

    Ogni bozza passa attraverso un rigoroso contratto di consegna a 5 fasi (Capacità, Formato, Aspetto visivo, Revisione dei contenuti, Integrità degli asset) con una griglia da 100 punti, bloccando tutto ciò che è sotto 90 prima che arrivi a te.

  • Ottimizzazione Doppia per SEO e Citazioni AI

    Ogni articolo è ottimizzato per il posizionamento su Google (Core Update di dicembre 2025, E-E-A-T) e le piattaforme di citazione AI (ChatGPT, Perplexity, AI Overviews), massimizzando visibilità e citabilità.

  • Generazione Completa di Contenuti

    Un motore di blog a ciclo di vita completo con 30 sotto-competenze, 5 agenti e 12 modelli di contenuto, che copre ricerca, scaletta, bozza, schema, collegamenti interni e verifica delle citazioni in un'unica invocazione.

  • Scrittura Guidata da Persona e Verifica dei Fatti

    Gestisci personaggi di scrittura configurabili con framework di tono e fasce di leggibilità, insieme a una pipeline di verifica dei fatti che controlla le statistiche rispetto alle fonti citate per garantire l'accuratezza.

  • Rilevamento della Cannibalizzazione delle Parole Chiave

    Identifica e risolve la sovrapposizione di parole chiave tra i post del blog con punteggio di gravità e raccomandazioni per evitare che i contenuti competano tra loro nelle SERP.

Casi d’uso

Quando usarla

  • Genera Post di Blog di Alta Qualità

    Blogger e creator singoli possono pubblicare un post di alta qualità a settimana senza checklist SEO manuali, gestendo ricerca, scaletta, bozza, schema, link interni e verifica delle citazioni.

  • Gestisci Contenuti su Larga Scala per Team

    I team di marketing e le agenzie possono gestire molti post su argomenti e lingue diverse con funzionalità come la pianificazione di cluster di argomenti, la pubblicazione multilingue e profili vocali guidati da persona.

  • Verifica e Ottimizza i Contenuti Esistenti

    Utilizza la competenza per analizzare i post del blog esistenti con un punteggio di qualità da 0 a 100, eseguire la validazione SEO dopo la scrittura e rilevare la cannibalizzazione delle parole chiave su tutto il sito.

SKILL.md

Competenza di scrittura blog AI e ottimizzazione SEO per Claude Code (claude-blog)

Due versioni di questa competenza. Scegli quella che si adatta al tuo modo di lavorare:

  • 🌐 Open-source pubblico: AgriciDaniel/claude-blog. Con licenza MIT, rilasci pubblici, aperto a tutti. Usalo se vuoi la versione stabile, scaricabile, senza bisogno di abbonamento.
  • 🔒 Mirror privato della community (questo repo): AI-Marketing-Hub/claude-blog. Accesso anticipato ai lavori in sviluppo (v1.9.0+ Blog Delivery Contract, hero ladder, copertura di regressione con test di mutazione), e collaborazione diretta con la community AI Marketing Hub Pro. Richiede abbonamento.

I badge sopra tracciano il repo pubblico (AgriciDaniel/claude-blog) poiché il mirror privato non è visibile a shields.io. Il flusso di pubblicazione (sviluppo privato, revisione, rilascio pubblico) è documentato in docs/PUBLISHING.md.

Blog: Scopri come funziona claude-blog

claude-blog è una suite di competenze Claude Code che scrive, ottimizza e verifica contenuti blog su larga scala. Ogni articolo è ottimizzato dualmente per le classifiche Google (Aggiornamento Core di dicembre 2025, E-E-A-T) e per le piattaforme di citazione AI (ChatGPT, Perplexity, AI Overviews). Un contratto di consegna a 5 porte v1.9.0 valuta ogni bozza con una rubrica a 100 punti e blocca tutto ciò che è sotto 90 dal raggiungerti.

Punti chiave

  • Che cos'è: un motore di blog a ciclo completo: 30 sotto-competenze, 5 agenti, 12 modelli di contenuto, 21 riferimenti su richiesta, 9 script Python a livello root, 160 test superati.
  • Per chi è: blogger solitari, team di marketing, agenzie e sviluppatori di competenze Claude Code che vogliono output di contenuti di livello produttivo, non bozze una tantum.
  • Promessa principale: ogni bozza supera un contratto di consegna a 5 porte (Capacità, Formato, Visivo, Revisione Contenuti, Integrità degli Asset) oppure l'autore itera fino a 3 volte prima di passare a te.
  • Cosa lo rende diverso: mangia il proprio cibo per cani. La coerenza di versione è imposta dalla CI su 14 superfici, l'igiene della prosa viene eseguita su ogni PR, tre suite di regressione testate per mutazioni bloccano le correzioni v1.9.0 e blog-reviewer è una porta BLOCCANTE, non consultiva.
  • Oggi: v1.9.0, rilasciata il 2026-05-18. Funziona su Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML statico.

Per chi è claude-blog?

claude-blog serve tre tipi di pubblico con un unico motore:

Blogger solitari e creatori che vogliono pubblicare un post di alta qualità a settimana senza passare tre ore sulla checklist SEO. L'orchestratore gestisce ricerca, scaletta, bozza, schema, collegamenti interni e verifica delle citazioni in una singola invocazione /blog write.

Team di marketing e agenzie che gestiscono molti post su argomenti, lingue e piattaforme diverse. La competenza offre pianificazione di cluster di argomenti (/blog cluster), pubblicazione multilingue con un solo comando (/blog multilingual), rilevamento della cannibalizzazione (/blog cannibalization) e profili vocali basati su persona (/blog persona) in modo che lo stesso motore produca contenuti coerenti in tutto il team.

Sviluppatori di competenze Claude Code che desiderano un riferimento di livello produttivo per l'architettura delle competenze, il dispacciamento degli agenti, i contratti di consegna e il gating CI. Il repo dimostra lo standard aperto Agent Skills a complessità Tier 4 con 160 test, applicazione della coerenza di versione, test di regressione di sincronizzazione dell'installatore e il pattern di contratto a 5 porte v1.9.0. Leggi il sorgente per ispirazione; fai fork dei pattern nelle tue competenze.

Cosa produce claude-blog?

Ogni bozza viene consegnata come 8 artefatti in una singola cartella. Un esempio condensato dell'output .md:

---
title: "Where Should a Claude Code Skill Plugin Install Itself?"
description: "A working answer to the install-path question..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Where Should a Claude Code Skill Plugin Install Itself?

The short answer: most user-installable Claude Code skill plugins
should ship to `~/.claude/skills/<name>/` for skill content,
`~/.claude/agents/<name>.md` for agents, and
`~/.claude/scripts/<helper>.py` for any Python helpers.

## Key Takeaways
- `~/.claude/skills/` is the SKILL.md surface area.
- `~/.claude/agents/` holds agent markdown files.
- ... (full article, sourced citations, FAQ, schema JSON-LD)

Insieme al .md, il contratto produce anche: .html renderizzato (JSON-LD sicuro contro XSS, CSS consapevole della modalità scura), .pdf (Playwright o weasyprint), hero.<ext> (1200x630, generato tramite Banana MCP, Gemini, API stock o Openverse), 3 screenshot per viewport (mobile-375.png, tablet-768.png, desktop-1280.png), review.md (scorecard a 5 categorie con riga BLOCCANTE) e preflight-report.json (l'intera traccia di audit).

Indice dei contenuti

  • Demo
  • Avvio rapido
  • Comandi
  • Come si confronta claude-blog?
  • Funzionalità
  • Contratto di consegna (v1.9.0)
  • Architettura
  • Requisiti
  • Domande frequenti
  • Roadmap
  • Disinstallazione
  • Integrazione
  • Documentazione
  • Come citare
  • Sicurezza e Codice di Condotta
  • Contribuire
  • Licenza
  • Progetti correlati
  • Autore

Demo

Guarda la Demo su YouTube

<p align="center"> <img src="assets/blog-command-demo.gif" alt="demo del comando claude-blog: instradamento dei sottocomandi /blog attraverso l'orchestratore" width="100%"> </p>

Avvio rapido

ℹ️ Quale versione stai installando?

  • Non sei un membro AI Marketing Hub Pro? Installa dal repository pubblico: AgriciDaniel/claude-blog. Tutti i comandi di installazione qui sotto funzionano lì. Basta sostituire AI-Marketing-Hub/claude-blog con AgriciDaniel/claude-blog e lo slug del plugin claude-blog@ai-marketing-hub-claude-blog con claude-blog@agricidaniel-claude-blog. Le versioni pubbliche vengono rilasciate lì; questo mirror privato è più avanti.
  • Membro Pro? I comandi qui sotto installano la versione community con accesso anticipato alle funzionalità in sviluppo. Richiedono una sessione autenticata gh auth login (o GitHub PAT) con accesso all'organizzazione AI-Marketing-Hub. Se /plugin marketplace add fallisce con un errore 404, il tuo account non fa ancora parte dell'organizzazione. Invia un messaggio nella community Skool per essere aggiunto.

Installazione Plugin (Claude Code 1.0.33+):

# Add marketplace (one-time)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Install plugin
/plugin install claude-blog@ai-marketing-hub-claude-blog

Consigliato: clona, verifica, quindi installa (ti permette di ispezionare install.sh e fissare un tag di rilascio):

git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # pin to a release tag (latest as of 2026-05-18)
chmod +x install.sh && ./install.sh

Installazione con un solo comando (Unix/macOS):

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

Installazione con un solo comando (Windows PowerShell):

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

Eseguire il pipe di curl o irm in una shell concede allo script l'autorità di esecuzione sulla tua macchina. Il flusso clone-poi-checkout-tag è più sicuro perché puoi ispezionare cosa viene eseguito. Entrambi i flussi si autenticano al repository privato usando le tue credenziali gh auth / GitHub esistenti.

Verifica l'integrità dell'installatore (consigliato, hardening VULN-IAC-001):

# Scarica, verifica SHA-256, quindi esegui se l'hash corrisponde.
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

L'hash SHA-256 sopra è per l'attuale install.sh al HEAD su main. Verifica rispetto al file canonico prima di eseguire. L'hash del compagno install.ps1 è 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98. Gli hash vengono aggiornati in questo README ad ogni modifica dell'installatore.

Riavvia Claude Code dopo l'installazione per attivarlo.

Comandi

🚀 Prima volta? Prova prima questi tre comandi: /blog strategy <niche> per definire l'ambito del tuo blog, /blog write <topic> per generare il tuo primo articolo (il contratto a 5 fasi viene eseguito automaticamente), e /blog analyze <file> per valutarlo sulla rubrica a 100 punti.

<p align="center"> <img src="assets/blog-write-demo.gif" alt="demo di claude-blog /blog write: generazione di articoli end-to-end con il contratto di consegna a 5 fasi" width="100%"> </p> <p align="center"> <img src="assets/diagrams/03-sub-skill-map-B.svg" alt="ecosistema delle sotto-competenze di claude-blog: hub orchestratore al centro con 30 sotto-competenze organizzate in 8 cluster tematici (scrittura, strategia, qualità, AI e ricerca, multilingue, ricerca, media, distribuzione); le dimensioni dei pannelli si adattano automaticamente al numero di competenze" width="100%"> </p>
ComandoDescrizione
/blog write <topic>Scrivi un nuovo post del blog da zero
/blog rewrite <file>Ottimizza un post del blog esistente
/blog analyze <file>Verifica della qualità con punteggio da 0 a 100
/blog brief <topic>Genera un brief di contenuti dettagliato
/blog calendarGenera un calendario editoriale
/blog strategy <niche>Strategia del blog e ideazione degli argomenti
/blog outline <topic>Schema di contenuti informato dalla SERP
/blog seo-check <file>Validazione SEO post-scrittura
/blog schema <file>Genera markup schema JSON-LD
/blog repurpose <file>Riutilizza per social, email, YouTube
/blog geo <file>Verifica della prontezza per le citazioni AI
/blog image [generate|edit|setup]Generazione di immagini AI tramite Gemini
/blog audit [directory]Valutazione dello stato di salute dell'intero blog
/blog cannibalization [directory]Rilevamento della sovrapposizione di parole chiave tra i post
/blog factcheck <file>Verifica le statistiche rispetto alle fonti citate
/blog persona [create|list|apply]Gestisci le persona di scrittura e i profili vocali
/blog taxonomy [sync|audit|suggest]Gestione di tag/categorie CMS
/blog notebooklm <question>Interroga NotebookLM per ricerche basate sulle fonti
/blog audio [generate|voices|setup]Genera narrazione audio tramite Gemini TTS
/blog google [command] [args]Dati dell'API Google: PSI, CrUX, GSC, GA4, NLP, YouTube, Keywords
/blog cluster [plan|execute] <seed>Pianificazione ed esecuzione di cluster tematici semantici (hub-and-spoke)
/blog multilingual <topic> --languages <codes>Scrivi, traduci, localizza e genera hreflang in un unico comando
/blog translate <file> --to <codes>Traduzione ottimizzata per SEO con preservazione del formato
/blog localize <file> --locale <code>Adattamento culturale profondo per locale
/blog locale-audit <directory>Controllo qualità dei contenuti multilingua (completezza, hreflang, parità, freschezza)
/blog flow [find|optimize|win|prompts|sync]Prompt del framework FLOW (guidato da prove, applicabili a 30 blog)
/blog brand [init|show|update]Genera il contesto BRAND.md + VOICE.md caricato automaticamente da tutte le sotto-competenze
/blog discourse <topic>Ricerca di discorsi senza API sugli ultimi 30 giorni; produce DISCOURSE.md

30 directory di sotto-competenze in totale: 29 invocabili dall'utente (28 comandi slash distinti + /blog update alias di rewrite) + 1 solo interna (blog-chart, invocato da blog-write/blog-rewrite per grafici SVG incorporati). blog-image è invocabile dall'utente E richiamabile internamente.

Come si confronta claude-blog?

claude-blog è una pipeline strutturata. Il prompt diretto del LLM è un one-shot. Gli strumenti SaaS hosted sono closed-source. Ecco la matrice onesta dei compromessi:

Capacitàclaude-blogPrompt diretto Claude / ChatGPTCopy.ai / JasperCostruiscilo da te
Articolo completo in un comando, con loop di iterazione✅ (contratto a 5 gate, fino a 3 tentativi)⚠️ one-shot
Statistiche da fonti con verifica/blog factcheck recupera gli URL delle fonti❌ allucina⚠️ manuale
Ottimizzazione delle citazioni AI (GEO / AEO)✅ audit dedicato /blog geo⚠️
Revisione dei contenuti bloccante (punteggio >= 90 per consegnare)✅ agente blog-reviewer
Comando unico multilingua + hreflang/blog multilingual⚠️ nessun hreflang⚠️
Pianificazione del cluster tematico (hub-and-spoke)/blog cluster⚠️
Narrazione audio✅ Gemini TTS, 30 voci
Generazione di immagini hero (scala a 4 gradini)✅ Banana, Gemini, stock, Openverse⚠️ solo stock⚠️
Contesto persistente del brand e della voce✅ BRAND.md + VOICE.md caricato automaticamente❌ per prompt⚠️ limitato
Open-source, MIT, senza costi di utilizzo✅ gratuito❌ abbonamento❌ abbonamento

claude-blog non è migliore in tutto. Il prompting diretto è più veloce per una singola bozza usa e getta. Il SaaS ospitato è più facile per i non sviluppatori. Il DIY è più flessibile per pipeline uniche. claude-blog si adatta dove si desidera contenuti di livello professionale su larga scala senza abbonamento SaaS.

Caratteristiche

12 modelli di contenuto

Selezionati automaticamente per argomento e intento: guida pratica, listicolo, caso studio, confronto, pagina pilastro, recensione di prodotto, leadership di pensiero, raccolta, tutorial, analisi di notizie, ricerca dati, base di conoscenza FAQ.

Punteggio qualità a 5 categorie (100 punti)

CategoriaPuntiFocus
Qualità del Contenuto30Approfondimento, leggibilità, originalità, coinvolgimento
Ottimizzazione SEO25Intestazioni, titolo, parole chiave, link, meta
Segnali E-E-A-T15Autore, citazioni, fiducia, esperienza
Elementi Tecnici15Schema, immagini, velocità, mobile, tag OG
Predisposizione alle Citazioni AI15Citabilità, formato domande e risposte, chiarezza delle entità

Fasce di punteggio: Eccezionale (90-100), Forte (80-89), Accettabile (70-79), Sotto lo Standard (60-69), Riscrittura (<60). Il contratto v1.9.0 impedisce la consegna al di sotto di 90.

Rilevamento contenuti AI

Punteggio di variabilità basato sulla varianza della lunghezza delle frasi, rilevamento di frasi AI note (17 frasi) e diversità lessicale (TTR). Contrassegna i contenuti che sembrano generati da una macchina prima che raggiungano il revisore.

Scrittura basata su persona

Personaggi di scrittura configurabili con il framework di tono a 4 dimensioni NNGroup (formale/informale, serio/divertente, rispettoso/irriverente, oggettivo/entusiasta). Gestisci profili vocali per blog o autore, con fasce di leggibilità (Consumatore, Professionale, Tecnico) e applicazione dello stile al momento della bozza.

Pipeline di verifica dei fatti

/blog factcheck recupera ogni URL sorgente citata e valuta la confidenza dell'affermazione come corrispondenza esatta, parafrasi o non trovata. Assicura che ogni dato sia accurato e tracciabile, non inventato.

Rilevamento cannibalizzazione parole chiave

/blog cannibalization identifica la sovrapposizione di parole chiave tra i post del blog utilizzando l'analisi grep locale o l'API DataForSEO. Il punteggio di gravità con raccomandazioni di fusione o differenziazione impedisce ai post di competere tra loro nelle SERP.

Gestione tassonomia CMS

Sincronizzazione di tag e categorie con supporto per WordPress REST, Shopify GraphQL, Ghost, Strapi e Sanity. Include suggerimento, sincronizzazione e flussi di lavoro di audit dei tag.

Doppia ottimizzazione

Ogni articolo mira sia al posizionamento su Google che alle piattaforme di citazione AI:

  • Google: conformità all'aggiornamento Core di Dicembre 2025, segnali E-E-A-T, markup schema, linking interno, consapevolezza dei Core Web Vitals tramite blog-google.
  • Citazioni AI: formattazione con risposta in primo piano, capsule di citazione, citabilità a livello di paragrafo (blocchi di 120-180 parole), schema FAQ, chiarezza delle entità.

Contenuti visivi

  • Approvvigionamento immagini da Pixabay, Unsplash e Pexels con verifica HTTP 200 e testo alternativo generato automaticamente.
  • Generazione di immagini AI tramite Gemini per immagini hero, illustrazioni inline e schede social. Richiede una chiave API Google AI gratuita.
  • Generazione di grafici SVG integrata in 7 stili (barra, barra raggruppata, lecca-lecca, ciambella, linea, area, radar).
  • Incorporamento video YouTube con caricamento lazy srcdoc e fallback noscript per crawler AI.
  • Obiettivi di densità delle immagini calibrati per tipo di contenuto.

Integrazione API Google (v1.6.5+)

13 comandi su 4 livelli di credenziali, tutti gratuiti per un utilizzo normale:

  • Livello 0 (chiave API): PageSpeed Insights, CrUX Core Web Vitals (cronologia di 25 settimane), ricerca video YouTube, analisi delle entità NLP.
  • Livello 1 (OAuth): performance Search Console, Ispezione URL, API di indicizzazione.
  • Livello 2 (GA4): Report sul traffico organico.
  • Livello 3 (Ads): Google Ads Keyword Planner.

Ricerca NotebookLM

Interroga Google NotebookLM per ricerche basate su fonti da documenti caricati dall'utente. Qualità dati di Livello 1 con rischio zero di allucinazioni perché le risposte sono estratte dai documenti che hai caricato.

Narrazione audio

/blog audio genera narrazione audio tramite Gemini TTS. Tre modalità: riassunto (200-300 parole), articolo completo, dialogo a due voci. 30 voci, oltre 80 lingue.

Supporto piattaforma

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML statico.

Metodologie fondamentali (v1.8.0)

Cinque documenti di riferimento sotto skills/blog/references/ definiscono la metodologia editoriale e di ricerca applicata a tutte le sotto-competenze. Sono caricati su richiesta dall'orchestratore:

RiferimentoScopoUsato da
ai-slop-detection.mdRilevamento contenuti AI a due livelli: primo ordine (frasi) + secondo ordine (ritmo strutturale)blog-rewrite, blog-reviewer, blog-analyze
editorial-heuristics.md10 euristiche adattate da Nielsen con punteggio 0-4 + etichettatura gravità P0-P3blog-analyze --rubric
cognitive-load.mdDensità di concetti per sezione (entità, valori numerici, gergo, riferimenti in avanti, profondità delle clausole)blog-analyze --cognitive-load, scripts/cognitive_load.py
research-quality.mdGriglia di ricerca a 5 dimensioni + 4 classi di trappole per parole chiave pre-volo + soglie di freschezzablog-researcher, blog-discourse, blog-brief, blog-strategy
synthesis-contract.md6 LEGGI che governano la sintesi della ricerca (nessun blocco Fonti finale, citazioni inline, ecc.)Tutte le sotto-competenze di sintesi della ricerca

Adattato da pbakaus/impeccable (Apache 2.0) e mvanhorn/last30days-skill (MIT). Vedi CONTRIBUTORS.md per l'attribuzione.

Framework FLOW

Il framework FLOW (Trova, Sfrutta, Ottimizza, Vinci) è il flusso di lavoro basato sull'evidenza condiviso con AgriciDaniel/flow (CC BY 4.0). Ogni fase contribuisce con prompt alla pipeline dell'orchestratore; /blog flow espone 30 prompt pronti per l'esecuzione indicizzati per fase.

<p align="center"> <img src="assets/diagrams/04-framework-B.svg" alt="Ruota radiale del framework FLOW: quattro fasi (Trova per la scoperta degli argomenti, Sfrutta per l'amplificazione degli asset, Ottimizza per il miglioramento dei contenuti, Vinci per la conversione dei lettori) disposte attorno a un fulcro centrale, con 10 prompt rappresentativi sull'anello esterno" width="100%"> </p>

Contratto di consegna (v1.9.0)

<p align="center"> <img src="assets/diagrams/02-pipeline-A.svg" alt="Pipeline del Contratto di Consegna Blog a 5 gate: Scoperta Capacità, Completezza Formato, Verifica Visiva, Revisione Contenuti (gate BLOCCANTE, il punteggio deve essere 90 o superiore con zero problemi P0), e Integrità Asset e Link. Itera fino a 3 volte in caso di fallimento prima di passare all'utente" width="100%"> </p>

Ogni blog supera un contratto a 5 gate prima di essere mostrato all'utente. L'utente non è mai il primo revisore; lo sono i gate.

GateApplicaImplementazione
1. Scoperta CapacitàStrumenti e agenti richiesti presenti prima della scritturascripts/blog_preflight.py --gate 1
2. Completezza Formato.md + .html + .pdf + immagine eroe realescripts/blog_render.py, scripts/generate_hero.py
3. Verifica VisivaNessun overflow SVG, JSON-LD valido, rendering corretto della modalità scurapatchright / playwright a 3 larghezze viewport
4. Revisione Contenuti (BLOCCANTE)Punteggio blog-reviewer 90+ E zero problemi P0agents/blog-reviewer.md (bloccante, v1.9.0)
5. Integrità Asset + LinkOgni img si risolve, og:image esiste, i link restituiscono 200, wordCount entro il 5%scripts/blog_preflight.py --gate 5

Scala delle immagini eroe: Banana MCP, API Gemini diretta, stock premium (Unsplash, Pexels, Pixabay), API pubblica Openverse. Vince il primo disponibile. Blocca e itera fino a 3 volte su qualsiasi fallimento del gate prima di passare all'utente. Specifiche complete: skills/blog/references/blog-delivery-contract.md.

Architettura

<p align="center"> <img src="assets/diagrams/01-architecture-B.svg" alt="Architettura del sistema claude-blog: pipeline da sinistra a destra dal comando utente attraverso il routing dell'orchestratore, l'esecuzione delle sotto-competenze e l'invio degli agenti al contratto di consegna a 5 gate prima di raggiungere l'utente" width="100%"> </p>

claude-blog viene fornito con un orchestratore più 29 sotto-competenze, 5 agenti, 21 riferimenti, 12 modelli e 9 script a livello radice. L'orchestratore instrada i comandi utente verso le sotto-competenze, che generano agenti e chiamano script tramite Bash.

LivelloConteggioDove
Sotto-competenze (invocabili dall'utente)29skills/blog-*/SKILL.md
Sotto-competenze (interne)1skills/blog-chart/SKILL.md
Agenti specializzati5agents/blog-*.md
Riferimenti su richiesta21skills/blog/references/*.md
Modelli di contenuto12skills/blog/templates/*.md
Script Python a livello radice9scripts/*.py
Test160tests/test_*.py

Albero delle directory completo, diagrammi di flusso dati, metodologia di punteggio e punti di estensione: docs/ARCHITECTURE.md.

Requisiti

  • Claude Code CLI installata e configurata.
  • Python 3.11+ (per il punteggio di qualità, i runner del contratto di consegna a 5 gate e il lint).
  • Opzionale: pip install -r requirements.txt per analisi avanzate (punteggio di leggibilità, rilevamento schema).

Gate di qualità (applicati dalla CI su ogni PR)

  1. pytest: 160 test tra suite di sicurezza, comportamentali, di regressione e del contratto di consegna.
  2. Validazione plugin: claude plugin validate . più controlli manuali JSON/regex.
  3. Stale-path lint: rileva discrepanze nei riferimenti incrociati di references/ e templates/.
  4. Igiene della prosa: scripts/lint_prose.py (consapevole dei blocchi di codice e dei backtick) applica la regola di CONTRIBUTING.md di nessun trattino em, nessun trattino en, nessun --.
  5. Coerenza di versione: tests/test_version_coherence.py verifica che pyproject.toml, plugin.json, CITATION.cff e il frontmatter di skills/blog/SKILL.md corrispondano tutti.
  6. Coerenza dei comandi: tests/test_command_coherence.py verifica che skills/blog/SKILL.md e docs/COMMANDS.md dichiarino lo stesso insieme di comandi.

Esegui localmente prima di fare push:

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

Domande frequenti

Cos'è claude-blog?

claude-blog è una suite di competenze Claude Code per scrivere, ottimizzare e verificare contenuti blog. Esegue 30 sotto-competenze e 5 agenti attraverso un contratto di consegna a 5 gate in modo che ogni articolo raggiunga una soglia di qualità di 90/100 prima di raggiungerti.

Come si differenzia claude-blog dal prompt diretto a Claude o ChatGPT?

Il prompt diretto ti dà una bozza da un prompt. claude-blog ti offre una pipeline strutturata: ricerca con statistiche fontificate, approvazione dello schema, generazione della bozza, punteggio di qualità multi-passaggio, rilevamento di contenuti AI, verifica dei fatti, iniezione di schema e una revisione bloccante che itera fino a 3 volte prima della consegna. La competenza impone ciò che un redattore senior farebbe altrimenti manualmente.

Ho bisogno di un abbonamento AI Marketing Hub Pro per usare claude-blog?

No. La versione open-source pubblica su AgriciDaniel/claude-blog è con licenza MIT e gratuita per chiunque abbia Claude Code. Il mirror privato su AI-Marketing-Hub/claude-blog è per i membri Pro che desiderano accesso anticipato alle funzionalità in sviluppo e collaborazione diretta con la comunità.

Quali piattaforme blog supporta claude-blog?

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML statico. L'orchestratore rileva automaticamente la piattaforma dai segnali del progetto e regola di conseguenza frontmatter, incorporamento immagini e iniezione di schema.

claude-blog allucina statistiche?

No. Ogni statistica citata passa attraverso /blog factcheck, che recupera l'URL della fonte e valuta la confidenza dell'affermazione (corrispondenza esatta, parafrasi, non trovata). L'agente blog-reviewer blocca la pubblicazione se una citazione non può essere verificata o se il rilevamento di contenuti AI segnala la prosa come generata da macchina.

Cos'è il Contratto di Consegna Blog a 5 gate?

Una pipeline di pre-presentazione applicata automaticamente dal codice che viene eseguita su ogni bozza: Scoperta delle Capacità, Completezza del Formato, Verifica Visiva a 3 larghezze di viewport, Revisione del Contenuto (BLOCCANTE; punteggio 90+ e zero P0), e Integrità degli Asset e dei Link. L'orchestratore itera con l'autore fino a 3 volte in caso di fallimento di qualsiasi gate prima di passare a te. Specifiche complete in skills/blog/references/blog-delivery-contract.md.

Posso usare claude-blog in più lingue?

Sì. /blog multilingual <argomento> --languages en,de,fr,es,ja scrive l'articolo, lo traduce preservando il frontmatter e lo schema, esegue un adattamento culturale approfondito per ciascuna località, ed emette i tag hreflang più una mappa delle lingue pronta per il CMS in un unico comando.

Come cito claude-blog in lavori accademici?

Vedi la sezione Come citare più sotto o il file CITATION.cff nella root del repository. GitHub mostra il file di citazione strutturato tramite il pulsante "Cita questo repository" sulla pagina del mirror pubblico.

È sicuro installare claude-blog?

L'installer distribuisce solo script Python e file markdown, non esegue mai codice remoto oltre a ciò che pip install -r requirements.txt importa, ed è verificato rispetto alla policy del progetto SECURITY.md ad ogni modifica. Il flusso di installazione clone-then-checkout-tag ti permette di ispezionare install.sh prima di eseguirlo. Vedi SECURITY.md per il modello di minaccia completo.

Tabella di marcia

<p align="center"> <img src="assets/diagrams/05-roadmap-A.svg" alt="roadmap a onde di claude-blog su una timeline orizzontale: v1.6.0 fondamenta (Mar 2026), v1.7.0 framework FLOW (Apr 2026), v1.8.0 metodologia impeccabile (Mag 2026), v1.9.0 contratto di consegna (attuale, Mag 2026), v2.0.0 pubblicazione multi-CMS (Q3 2026), v3.0.0 blog-come-codice (Q1 2027)" width="100%"> </p>

v1.9.1 (prossima)

  • Funzione condivisa _count_body_words(html) tra blog_render e blog_preflight per chiudere il residuo di audit v1.9.0.
  • Semantica del codice di uscita di generate_hero.py: diverso da zero se non c'è un percorso di generazione immagine (attualmente restituisce un errore JSON con uscita 0).
  • Test di copertura del ciclo di iterazione che verifica che l'orchestratore passi a te dopo 3 BLOCCHI del revisore, non 4.
  • Analizza i documenti rimanenti (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) per eventuali residui di deriva dello strato v1.x.

v1.10 (visione)

  • Perfezionamento della scaletta informato dalla SERP in tempo reale tramite DataForSEO durante la scrittura.
  • Impianto di valutazione che misura la qualità del blog attraverso le configurazioni (presenza di BRAND.md, variante della persona, modalità multilingue).
  • Contatore di iterazioni applicato dal codice (attualmente come istruzione dell'orchestratore; promosso a livello di script).

v2.0 (a lungo termine)

  • Integrazione con server di anteprima headless: il contratto a 5 gate viene eseguito su un'anteprima su dominio reale invece che su HTML locale.
  • Connettori di pubblicazione CMS per piattaforma (WordPress, Ghost, Sanity) con ripubblicazione idempotente in caso di riscrittura.
  • Dashboard in tempo reale di tracciamento delle citazioni AI (quali post vengono citati da ChatGPT, Perplexity, AI Overviews; mappa di calore della visibilità).

Apri una issue con l'etichetta roadmap se vuoi proporre o votare qualcosa.

Disinstallazione

Unix/macOS:

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

Windows (PowerShell):

.\uninstall.ps1

Integrazione

La generazione di grafici e l'incorporamento di video YouTube sono integrati. I dati delle API di Google richiedono una chiave API gratuita (vedi /blog google setup).

Competenze opzionali complementari (analisi approfondita delle pagine pubblicate):

SkillIntegrazione
/seoAnalisi SEO approfondita delle pagine blog pubblicate
/seo-schemaValidazione e generazione del markup Schema
/seo-geoAudit di ottimizzazione delle citazioni AI
/seo-googleDati API Google (configurazione condivisa con blog-google)

Documentazione

La documentazione dettagliata è in docs/:

  • Guida all'installazione: Unix, macOS, Windows, installazione manuale.
  • Riferimento comandi: Riferimento completo dei comandi con esempi.
  • Architettura: Progettazione del sistema e panoramica dei componenti.
  • Flusso di pubblicazione: Flusso di rilascio da privato a pubblico (maintainer Pro).
  • Modelli: Riferimento e personalizzazione dei modelli.
  • Risoluzione dei problemi: Problemi comuni e soluzioni.
  • Integrazione MCP: Configurazione opzionale del server MCP.

Come citare

Se utilizzi claude-blog nella ricerca o in produzione, cita il progetto:

@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: AI Blog Writing and SEO Optimization Skill for Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}

GitHub espone anche il file strutturato CITATION.cff tramite "Cita questo repository" sulla pagina mirror pubblica.

Sicurezza e Codice di condotta

  • Politica di sicurezza + modello di minaccia: SECURITY.md. Il passaggio di hardening v1.8.x ha chiuso ogni segnalazione nota; v1.9.0 aggiunge JSON-LD sicuro contro XSS, rifiuto dei symlink O_NOFOLLOW e validazione del frontmatter, tutto verificato con test di mutazione. Per segnalare una vulnerabilità in privato, segui la procedura di divulgazione in SECURITY.md.
  • Codice di condotta: CODE_OF_CONDUCT.md. Contributor Covenant. Siate eccellenti gli uni con gli altri.

Contribuire

I contributi sono benvenuti. Vedi CONTRIBUTING.md per le linee guida. Prima di aprire una PR:

  1. Esegui python -m pytest tests/ (tutti i 160 devono passare).
  2. Esegui python3 scripts/lint_prose.py --root . (zero violazioni).
  3. Esegui claude plugin validate . (deve passare).
  4. Incrementa le versioni in modo coerente se modifichi conteggi o comportamenti visibili all'utente (vedi docs/PUBLISHING.md).

Licenza

Licenza MIT. Vedi LICENSE per i dettagli.

Progetti correlati

  • Rankenstein: Flusso di lavoro di pubblicazione dei contenuti basato su GUI; dalla ricerca alla pubblicazione in un'unica piattaforma.
  • Framework FLOW: Prompt Trova, Ottimizza, Vinci basati su evidenze (CC BY 4.0). Integrato come sotto-abilità tramite /blog flow.
  • Claude Ads e Claude SEO: abilità gemelle che condividono lo stesso kit di branding (banner + diagrammi generati con la tavolozza brand-arancione).
  • AI Marketing Hub: Comunità gratuita, oltre 2.800 membri. Il livello Pro su ai-marketing-hub-pro ospita il mirror privato di questa abilità.

Cronologia delle stelle

<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="Cronologia delle stelle di AgriciDaniel/claude-blog su GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> </picture> </a>

Se claude-blog ti fa risparmiare tempo, una stella sul repo pubblico è il modo più semplice per ringraziare (e aiuta altri creatori di contenuti a trovarlo).

Autore

Realizzato da Daniel Agrici, Architetto di flussi di lavoro AI, con Claude Code.

  • Blog: Approfondimenti sull'automazione del marketing AI.
  • YouTube: Tutorial e demo.
  • Tutti gli strumenti open-source: Altre abilità Claude Code.
  • AI Marketing Hub: Comunità gratuita per il marketing potenziato dall'AI.

FAQ