Umiejętność Pisania Bloga AI i Optymalizacji SEO dla Claude Code (claude-blog)
Dwie wersje tej umiejętności. Wybierz tę, która pasuje do Twojego sposobu pracy:
- 🌐 Publiczna open-source:
AgriciDaniel/claude-blog. Na licencji MIT, publiczne wydania, dostępne dla każdego. Użyj jej, jeśli chcesz stabilną, gotową do pobrania wersję bez wymogu członkostwa.- 🔒 Prywatne lustro społeczności (to repozytorium):
AI-Marketing-Hub/claude-blog. Wczesny dostęp do prac rozwojowych (Kontrakt Dostarczania Bloga v1.9.0, drabina hero, pokrycie regresyjne testowane mutacyjnie) i bezpośrednia współpraca ze społecznością AI Marketing Hub Pro. Wymaga członkostwa.Powyższe odznaki śledzą publiczne repozytorium (
AgriciDaniel/claude-blog), ponieważ prywatne lustro nie jest widoczne dla shields.io. Przepływ pracy publikacyjnej (prywatne dewelopowanie, recenzja, publiczne wydanie) jest udokumentowany wdocs/PUBLISHING.md.
Blog: Zobacz, jak działa claude-blog
claude-blog to zestaw umiejętności Claude Code, który pisze, optymalizuje i audytuje treści blogowe na dużą skalę. Każdy artykuł jest podwójnie optymalizowany pod kątem rankingów Google (Aktualizacja Główna Grudzień 2025, E-E-A-T) oraz platform cytujących AI (ChatGPT, Perplexity, AI Overviews). Kontrakt Dostarczania v1.9.0 z 5 bramkami ocenia każdy szkic według 100-punktowej rubryki i blokuje wszystko poniżej 90 przed dotarciem do Ciebie.
Kluczowe wnioski
- Czym jest: pełnożyciowy silnik blogowy: 30 pod-umiejętności, 5 agentów, 12 szablonów treści, 21 referencji na żądanie, 9 skryptów Pythona na poziomie głównym, 160 zaliczonych testów.
- Dla kogo jest: solo blogerów, zespołów marketingowych, agencji oraz twórców umiejętności Claude Code, którzy chcą produkcyjnej jakości treści, a nie jednorazowych szkiców.
- Główna obietnica: każdy szkic przechodzi kontrakt dostarczania z 5 bramkami (Zdolność, Format, Wizualna, Recenzja Treści, Integralność Zasobów) lub pisarz iteruje do 3 razy przed eskalacją do Ciebie.
- Co go wyróżnia: zjada własną karmę dla psa. Spójność wersji jest wymuszana przez CI na 14 powierzchniach, higiena prozy uruchamiana przy każdym PR, trzy zestawy testów regresyjnych testowanych mutacyjnie blokują poprawki v1.9.0, a
blog-reviewerjest bramką BLOKUJĄCĄ, a nie doradczą. - Dziś: v1.9.0, wydana 18.05.2026. Działa na Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby i statycznym HTML.
Dla kogo jest claude-blog?
claude-blog obsługuje trzy grupy odbiorców za pomocą jednego silnika:
Solo blogerzy i twórcy, którzy chcą publikować jeden wysokiej jakości post tygodniowo bez spędzania trzech godzin na liście kontrolnej SEO. Orkiestrator obsługuje badania, konspekt, szkic, schemat, linkowanie wewnętrzne i weryfikację cytowań w jednym wywołaniu /blog write.
Zespoły marketingowe i agencje zarządzające wieloma postami w różnych tematach, językach i platformach. Umiejętność dostarcza planowanie klastrów tematycznych (/blog cluster), wielojęzyczne publikowanie jednym poleceniem (/blog multilingual), wykrywanie kanibalizacji (/blog cannibalization) i profile głosu oparte na personach (/blog persona), dzięki czemu ten sam silnik tworzy spójne treści w całym zespole.
Twórcy umiejętności Claude Code, którzy chcą produkcyjnego punktu odniesienia dla architektury umiejętności, wysyłania agentów, kontraktów dostarczania i bramkowania CI. Repozytorium demonstruje otwarty standard Agent Skills na poziomie złożoności Tier 4 ze 160 testami, wymuszaniem spójności wersji, testami regresyjnymi synchronizacji instalatora i wzorcem kontraktu 5-bramkowego v1.9.0. Czytaj źródło dla inspiracji; rozwidlaj wzorce do własnych umiejętności.
Co produkuje claude-blog?
Każdy szkic jest dostarczany jako 8 artefaktów w jednym folderze. Skrócony przykład wyjścia .md:
---
title: "Gdzie Powinna Się Zainstalować Wtyczka Umiejętności Claude Code?"
description: "Praktyczna odpowiedź na pytanie o ścieżkę instalacji..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, umiejętności, wtyczki, instalacja]
canonical: "https://example.com/blog/skill-plugin-install-path"
---
# Gdzie Powinna Się Zainstalować Wtyczka Umiejętności Claude Code?
Krótka odpowiedź: większość wtyczek umiejętności Claude Code instalowanych przez użytkownika
powinna trafiać do `~/.claude/skills/<nazwa>/` dla treści umiejętności,
`~/.claude/agents/<nazwa>.md` dla agentów i
`~/.claude/scripts/<pomocnik>.py` dla wszelkich pomocników Pythona.
## Kluczowe Wnioski
- `~/.claude/skills/` to obszar powierzchni SKILL.md.
- `~/.claude/agents/` przechowuje pliki markdown agentów.
- ... (pełny artykuł, cytaty źródłowe, FAQ, schemat JSON-LD)
Oprócz .md, kontrakt tworzy również: renderowany .html (bezpieczny przed XSS JSON-LD, CSS świadomy trybu ciemnego), .pdf (Playwright lub weasyprint), hero.<ext> (1200x630, generowane przez Banana MCP, Gemini, API stockowe lub Openverse), 3 zrzuty ekranu w widokach (mobile-375.png, tablet-768.png, desktop-1280.png), review.md (karta wyników 5-kategorii z linią BLOKUJĄCĄ) i preflight-report.json (pełny ślad audytu).
Spis Treści
- Demo
- Szybki Start
- Polecenia
- Jak claude-blog wypada na tle?
- Funkcje
- Kontrakt dostarczania (v1.9.0)
- Architektura
- Wymagania
- Często Zadawane Pytania
- Mapa Drogowa
- Odinstalowanie
- Integracja
- Dokumentacja
- Jak cytować
- Bezpieczeństwo i Kodeks Postępowania
- Współtworzenie
- Licencja
- Powiązane Projekty
- Autor
Demo
Obejrzyj Demo na YouTube
<p align="center"> <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/blog-command-demo.gif" alt="demo polecenia claude-blog: routing podpoleceń /blog przez orkiestrator" width="100%"> </p>Szybki Start
ℹ️ Którą wersję instalujesz?
- Nie jesteś członkiem AI Marketing Hub Pro? Zainstaluj z publicznego repozytorium:
AgriciDaniel/claude-blog. Wszystkie poniższe polecenia instalacyjne tam działają. Wystarczy zamienićAI-Marketing-Hub/claude-blognaAgriciDaniel/claude-bloga slug wtyczkiclaude-blog@ai-marketing-hub-claude-blognaclaude-blog@agricidaniel-claude-blog. Tam trafiają wydania publiczne; to prywatne lustro wyprzedza.- Członek Pro? Poniższe polecenia instalują wersję społecznościową z wczesnym dostępem do funkcji w fazie rozwoju. Wymagają uwierzytelnionej sesji
gh auth login(lub PAT GitHub) z dostępem do organizacjiAI-Marketing-Hub. Jeśli/plugin marketplace addnie powiedzie się z kodem 404, Twoje konto nie jest jeszcze w organizacji. DM w społeczności Skool aby zostać dodanym.
Instalacja Wtyczki (Claude Code 1.0.33+):
# Dodaj marketplace (jednorazowo)
/plugin marketplace add AI-Marketing-Hub/claude-blog
# Zainstaluj wtyczkę
/plugin install claude-blog@ai-marketing-hub-claude-blog
Zalecane: sklonuj, zweryfikuj, a następnie zainstaluj (pozwala sprawdzić install.sh i przypiąć tag wydania):
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0 # przypnij do tagu wydania (najnowszy na 2026-05-18)
chmod +x install.sh && ./install.sh
Instalacja Jednym Poleceniem (Unix/macOS):
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
Instalacja Jednym Poleceniem (Windows PowerShell):
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
Przekazywanie
curllubirmdo powłoki daje skryptowi uprawnienia wykonawcze na Twojej maszynie. Przepływ klonowania, a następnie sprawdzenia tagu jest bezpieczniejszy, ponieważ możesz sprawdzić, co jest uruchamiane. Oba przepływy uwierzytelniają się wobec prywatnego repozytorium przy użyciu istniejących poświadczeńgh auth/ GitHub.
Weryfikacja integralności instalatora (zalecane, hartowanie VULN-IAC-001):
# Pobierz, zweryfikuj SHA-256, a następnie uruchom, jeśli hash się zgadza.
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
Powyższy SHA-256 dotyczy bieżącego install.sh na HEAD gałęzi main. Zweryfikuj z pliku kanonicznego przed uruchomieniem. Hash towarzyszący install.ps1 to 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98. Hashe są aktualizowane w tym README przy każdej zmianie instalatora.
Zrestartuj Claude Code po instalacji, aby aktywować.
Polecenia
<p align="center"> <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/blog-write-demo.gif" alt="demo /blog write claude-blog: generowanie artykułu od początku do końca z 5-bramkowym Kontraktem Dostarczania" width="100%"> </p> <p align="center"> <img src="https://file.nanoskill.ai/03-sub-skill-map-B-3.svg" alt="ekosystem pod-umiejętności claude-blog: centrum orkiestratora z 30 pod-umiejętnościami zorganizowanymi w 8 klastrów tematycznych (pisanie, strategia, jakość, AI i wyszukiwanie, wielojęzyczność, badania, media, dystrybucja); rozmiary paneli skalują się automatycznie do liczby umiejętności" width="100%"> </p>🚀 Pierwszy raz? Wypróbuj najpierw te trzy polecenia:
/blog strategy <nisza>aby określić zakres bloga,/blog write <temat>aby wygenerować pierwszy artykuł (kontrakt 5-bramkowy uruchamia się automatycznie) i/blog analyze <plik>aby ocenić go według 100-punktowej rubryki.
| Polecenie | Opis |
|---|---|
/blog write <temat> | Napisz nowy post na blogu od podstaw |
/blog rewrite <plik> | Zoptymalizuj istniejący post na blogu |
/blog analyze <plik> | Audyt jakości z wynikiem 0-100 |
/blog brief <temat> | Wygeneruj szczegółowy brief treści |
/blog calendar | Wygeneruj kalendarz redakcyjny |
/blog strategy <nisza> | Strategia bloga i generowanie pomysłów na tematy |
/blog outline <temat> | Konspekt treści oparty na SERP |
/blog seo-check <plik> | Walidacja SEO po napisaniu |
/blog schema <plik> | Wygeneruj znaczniki schematu JSON-LD |
/blog repurpose <plik> | Przekształć dla mediów społecznościowych, e-mail, YouTube |
/blog geo <plik> | Audyt gotowości do cytowania przez AI |
/blog image [generate|edit|setup] | Generowanie obrazów AI przez Gemini |
/blog audit [katalog] | Pełna ocena zdrowia bloga w witrynie |
/blog cannibalization [katalog] | Wykryj nakładanie się słów kluczowych między postami |
/blog factcheck <plik> | Zweryfikuj statystyki w oparciu o cytowane źródła |
/blog persona [create|list|apply] | Zarządzaj personami pisarskimi i profilami głosu |
/blog taxonomy [sync|audit|suggest] | Zarządzanie tagami/kategoriami w CMS |
/blog notebooklm <pytanie> | Zapytaj NotebookLM o badania oparte na źródłach |
/blog audio [generate|voices|setup] | Generuj narrację audio przez Gemini TTS |
/blog google [polecenie] [argumenty] | Dane API Google: PSI, CrUX, GSC, GA4, NLP, YouTube, Keywords |
/blog cluster [plan|execute] <seed> | Planowanie + wykonanie semantycznego klastra tematycznego (hub-and-spoke) |
/blog multilingual <temat> --languages <kody> | Pisz, tłumacz, lokalizuj i emituj hreflang w jednym poleceniu |
/blog translate <plik> --to <kody> | Tłumaczenie zoptymalizowane pod SEO z zachowaniem formatu |
/blog localize <plik> --locale <kod> | Głęboka adaptacja kulturowa dla lokalizacji |
/blog locale-audit <katalog> | QA treści wielojęzycznych (kompletność, hreflang, spójność, świeżość) |
/blog flow [find|optimize|win|prompts|sync] | Prompty ramowe FLOW (oparte na dowodach, 30 stosowanych w blogu) |
/blog brand [init|show|update] | Generuj BRAND.md + VOICE.md kontekst automatycznie ładowany przez wszystkie pod-umiejętności |
/blog discourse <temat> | Badania dyskursu z ostatnich 30 dni bez API; tworzy DISCOURSE.md |
Łącznie 30 katalogów pod-umiejętności: 29 wywoływalnych przez użytkownika (28 odrębnych poleceń slash +
/blog updatealias do rewrite) + 1 tylko wewnętrzna (blog-chart, wywoływana przez blog-write/blog-rewrite dla wykresów SVG w linii).blog-imagejest wywoływalna przez użytkownika ORAZ może być wywoływana wewnętrznie.
Jak claude-blog wypada na tle?
claude-blog to ustrukturyzowany potok. Bezpośrednie promptowanie LLM to jednorazowe. Hostowane narzędzia SaaS to zamknięte źródło. Oto uczciwa macierz kompromisów:
| Możliwość | claude-blog | Bezpośredni prompt Claude / ChatGPT | Copy.ai / Jasper | Zbuduj sam |
|---|---|---|---|---|
| Pełen artykuł jednym poleceniem, z pętlą iteracji | ✅ (kontrakt 5-bramkowy, do 3 ponownych prób) | ⚠️ jednorazowe | ✅ | ❌ |
| Statystyki źródłowe z weryfikacją | ✅ /blog factcheck pobiera URL-e źródłowe | ❌ halucynuje | ❌ | ⚠️ ręcznie |
| Optymalizacja pod cytowania AI (GEO / AEO) | ✅ dedykowany audyt /blog geo | ❌ | ❌ | ⚠️ |
| Blokująca recenzja treści (wynik >= 90 do dostarczenia) | ✅ agent blog-reviewer | ❌ | ❌ | ❌ |
| Wielojęzyczność + hreflang jednym poleceniem | ✅ /blog multilingual | ⚠️ brak hreflang | ⚠️ | ❌ |
| Planowanie klastrów tematycznych (hub-and-spoke) | ✅ /blog cluster | ❌ | ⚠️ | ❌ |
| Narracja audio | ✅ Gemini TTS, 30 głosów | ❌ | ❌ | ❌ |
| Generowanie obrazu bohatera (4-stopniowa drabina) | ✅ Banana, Gemini, stock, Openverse | ❌ | ⚠️ tylko stock | ⚠️ |
| Trwały kontekst marki i głosu | ✅ BRAND.md + VOICE.md auto-ładowane | ❌ na prompt | ⚠️ ograniczone | ❌ |
| Open-source, MIT, bez kosztów użytkowania | ✅ darmowe | ❌ subskrypcja | ❌ subskrypcja | ✅ |
claude-blog nie jest lepszy we wszystkim. Bezpośrednie promptowanie jest szybsze dla pojedynczego jednorazowego szkicu. Hostowane SaaS jest łatwiejsze dla osób nietechnicznych. DIY jest bardziej elastyczne dla unikalnych potoków. claude-blog pasuje tam, gdzie chcesz produkcyjnej jakości treści na skalę bez subskrypcji SaaS.
Funkcje
12 szablonów treści
Automatycznie wybierane według tematu i intencji: poradnik, lista, studium przypadku, porównanie, strona filarowa, recenzja produktu, przywództwo myślowe, zestawienie, samouczek, analiza wiadomości, badanie danych, baza wiedzy FAQ.
5-kategorii oceniania jakości (100 punktów)
| Kategoria | Punkty | Skupienie |
|---|---|---|
| Jakość Treści | 30 | Głębia, czytelność, oryginalność, zaangażowanie |
| Optymalizacja SEO | 25 | Nagłówki, tytuł, słowa kluczowe, linki, meta |
| Sygnały E-E-A-T | 15 | Autor, cytowania, zaufanie, doświadczenie |
| Elementy Techniczne | 15 | Schemat, obrazy, szybkość, mobilność, tagi OG |
| Gotowość do Cytowania przez AI | 15 | Cytowalność, format Q&A, przejrzystość encji |
Przedziały punktacji: Wyjątkowy (90-100), Silny (80-89), Akceptowalny (70-79), Poniżej Standardu (60-69), Przepisz (<60). Kontrakt v1.9.0 blokuje dostarczenie poniżej 90.
Wykrywanie treści AI
Ocena burstiness na podstawie wariancji długości zdań, wykrywanie znanych fraz AI (17 fraz) i różnorodność słownictwa (TTR). Oznacza treści, które brzmią jak wygenerowane maszynowo, zanim trafią do recenzenta.
Pisanie oparte na personach
Konfigurowalne persony pisarskie z ramą tonu 4-wymiarową NNGroup (formalny/swobodny, poważny/zabawny, pełen szacunku/lekceważący, rzeczowy/entuzjastyczny). Zarządzaj profilami głosu dla blogu lub autora, z pasmami czytelności (Konsument, Profesjonalny, Techniczny) i wymuszaniem stylu w czasie tworzenia szkicu.
Potok sprawdzania faktów
/blog factcheck pobiera każdy cytowany URL źródłowy i ocenia pewność twierdzenia jako dokładne dopasowanie, parafraza lub nie znaleziono. Zapewnia, że każdy punkt danych jest dokładny i możliwy do prześledzenia, a nie wymyślony.
Wykrywanie kanibalizacji słów kluczowych
/blog cannibalization identyfikuje nakładanie się słów kluczowych między postami na blogu za pomocą lokalnej analizy grep lub API DataForSEO. Punktacja dotkliwości z rekomendacjami scalania lub różnicowania zapobiega konkurowaniu postów ze sobą w SERP.
Zarządzanie taksonomią CMS
Synchronizacja tagów i kategorii obsługująca WordPress REST, Shopify GraphQL, Ghost, Strapi i Sanity. Obejmuje przepływy pracy sugerowania tagów, synchronizacji i audytu.
Podwójna optymalizacja
Każdy artykuł celuje zarówno w rankingi Google, jak i platformy cytujące AI:
- Google: zgodność z Aktualizacją Główną Grudzień 2025, sygnały E-E-A-T, znaczniki schematu, linkowanie wewnętrzne, świadomość Core Web Vitals przez blog-google.
- Cytowania AI: formatowanie odpowiedzi na pierwszym planie, kapsuły cytowań, cytowalność na poziomie fragmentu (bloki 120-180 słów), schemat FAQ, przejrzystość encji.
Media wizualne
- Pozyskiwanie obrazów z Pixabay, Unsplash i Pexels z weryfikacją HTTP 200 i auto-generowanym tekstem alternatywnym.
- Generowanie obrazów AI przez Gemini dla obrazów bohaterów, ilustracji wbudowanych i kart społecznościowych. Wymaga darmowego klucza Google AI API.
- Wbudowane generowanie wykresów SVG w 7 stylach (słupkowy, grupowany słupkowy, lizakowy, pączkowy, liniowy, warstwowy, radarowy).
- Osadzanie filmów YouTube z leniwym ładowaniem
srcdoci fallbackiem noscript dla crawlerów AI. - Cele gęstości obrazów skalibrowane według typu treści.
Integracja z Google API (v1.6.5+)
13 poleceń na 4 poziomach poświadczeń, wszystkie darmowe przy normalnym użytkowaniu:
- Poziom 0 (klucz API): PageSpeed Insights, CrUX Core Web Vitals (25-tygodniowa historia), wyszukiwanie filmów YouTube, analiza encji NLP.
- Poziom 1 (OAuth): wydajność Search Console, Inspekcja URL, API Indeksowania.
- Poziom 2 (GA4): raporty ruchu organicznego.
- Poziom 3 (Ads): Planer słów kluczowych Google Ads.
Badania NotebookLM
Zapytaj Google NotebookLM o badania oparte na źródłach z dokumentów przesłanych przez użytkownika. Jakość danych na Poziomie 1 z zerowym ryzykiem halucynacji, ponieważ odpowiedzi są wyodrębniane z przesłanych przez Ciebie dokumentów.
Narracja audio
/blog audio generuje narrację audio przez Gemini TTS. Trzy tryby: podsumowanie (200-300 słów), pełny artykuł, dialog dwóch mówców. 30 głosów, 80+ języków.
Wsparcie platform
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby i statyczny HTML.
Metodologie fundamentalne (v1.8.0)
Pięć dokumentów referencyjnych pod skills/blog/references/ definiuje metodologię redakcyjną i badawczą stosowaną we wszystkich pod-umiejętnościach. Są one ładowane na żądanie przez orkiestrator:
| Referencja | Cel | Używane przez |
|---|---|---|
ai-slop-detection.md | Dwupoziomowe wykrywanie treści AI: pierwszego rzędu (frazy) + drugiego rzędu (rytm strukturalny) | blog-rewrite, blog-reviewer, blog-analyze |
editorial-heuristics.md | 10 heurystyk adaptowanych z Nielsena z punktacją 0-4 + tagowanie dotkliwości P0-P3 | blog-analyze --rubric |
cognitive-load.md | Gęstość koncepcyjna na sekcję (encje, liczebniki, żargon, odwołania do przodu, głębokość zdań) | blog-analyze --cognitive-load, scripts/cognitive_load.py |
research-quality.md | 5-wymiarowa rubryka badawcza + 4 klasy pułapek słów kluczowych przed lotem + minimalne progi świeżości | blog-researcher, blog-discourse, blog-brief, blog-strategy |
synthesis-contract.md | 6 PRAW rządzących syntezą badań (brak bloku Źródła na końcu, cytowania w tekście itp.) | Wszystkie pod-umiejętności syntezy badań |
Zaadaptowane z pbakaus/impeccable (Apache 2.0) i mvanhorn/last30days-skill (MIT). Zobacz CONTRIBUTORS.md dla atrybucji.
Ramy FLOW
Ramy FLOW (Find, Leverage, Optimize, Win) to oparty na dowodach przepływ pracy udostępniony z AgriciDaniel/flow (CC BY 4.0). Każda faza wnosi prompty do potoku orkiestratora; /blog flow udostępnia 30 gotowych do uruchomienia promptów indeksowanych według fazy.
Kontrakt dostarczania (v1.9.0)
<p align="center"> <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/diagrams/02-pipeline-A.svg" alt="Potok 5-bramkowego Kontraktu Dostarczania Bloga: Odkrywanie Możliwości, Kompletność Formatu, Weryfikacja Wizualna, Recenzja Treści (bramka BLOKUJĄCA, wynik musi być 90 lub wyższy z zerem problemów P0) oraz Integralność Zasobów i Linków. Iteruje do 3 razy przy niepowodzeniu przed eskalacją do użytkownika" width="100%"> </p>Każdy blog przechodzi kontrakt 5-bramkowy zanim zostanie pokazany użytkownikowi. Użytkownik nigdy nie jest pierwszym recenzentem; bramki są.
| Bramka | Wymusza | Implementacja |
|---|---|---|
| 1. Odkrywanie Możliwości | Wymagane narzędzia i agenci obecni przed pisaniem | scripts/blog_preflight.py --gate 1 |
| 2. Kompletność Formatu | .md + .html + .pdf + prawdziwy obraz bohatera | scripts/blog_render.py, scripts/generate_hero.py |
| 3. Weryfikacja Wizualna | Brak przepełnienia SVG, poprawny JSON-LD, poprawny tryb ciemny | patchright / playwright w 3 szerokościach widoku |
| 4. Recenzja Treści (BLOKUJĄCA) | blog-reviewer wynik 90+ ORAZ zero problemów P0 | agents/blog-reviewer.md (blokujące, v1.9.0) |
| 5. Integralność Zasobów + Linków | Każdy obraz się ładuje, og:image istnieje, linki zwracają 200, wordCount w granicach 5% | scripts/blog_preflight.py --gate 5 |
Drabina obrazu bohatera: Banana MCP, bezpośrednie Gemini API, stock premium (Unsplash, Pexels, Pixabay), publiczne API Openverse. Pierwszy dostępny wygrywa. Blokuj i iteruj do 3 razy przy niepowodzeniu którejkolwiek bramki przed eskalacją do użytkownika. Pełna specyfikacja: skills/blog/references/blog-delivery-contract.md.
Architektura
<p align="center"> <img src="https://file.nanoskill.ai/01-architecture-B-4.svg" alt="architektura systemu claude-blog: potok od lewej do prawej od polecenia użytkownika przez routing orkiestratora, wykonanie pod-umiejętności i wysyłanie agentów do 5-bramkowego kontraktu dostarczania przed dotarciem do użytkownika" width="100%"> </p>claude-blog dostarcza jeden orkiestrator plus 29 pod-umiejętności, 5 agentów, 21 referencji, 12 szablonów i 9 skryptów na poziomie głównym. Orkiestrator kieruje polecenia użytkownika do pod-umiejętności, które uruchamiają agentów i wywołują skrypty przez Bash.
| Warstwa | Liczba | Gdzie |
|---|---|---|
| Pod-umiejętności (wywoływalne przez użytkownika) | 29 | skills/blog-*/SKILL.md |
| Pod-umiejętności (wewnętrzne) | 1 | skills/blog-chart/SKILL.md |
| Wyspecjalizowani agenci | 5 | agents/blog-*.md |
| Referencje na żądanie | 21 | skills/blog/references/*.md |
| Szablony treści | 12 | skills/blog/templates/*.md |
| Skrypty Python na poziomie głównym | 9 | scripts/*.py |
| Testy | 160 | tests/test_*.py |
Pełne drzewo katalogów, diagramy przepływu danych, metodologia punktacji i punkty rozszerzeń: docs/ARCHITECTURE.md.
Wymagania
- Claude Code CLI zainstalowany i skonfigurowany.
- Python 3.11+ (do punktacji jakości, uruchamiania kontraktu 5-bramkowego i lintowania).
- Opcjonalnie:
pip install -r requirements.txtdla zaawansowanej analizy (punktacja czytelności, wykrywanie schematów).
Bramki jakości (wymuszane CI przy każdym PR)
- pytest: 160 testów w zestawach bezpieczeństwa, behawioralnych, regresyjnych i kontraktu dostarczania.
- Walidacja wtyczki:
claude plugin validate .plus ręcznie napisane sprawdzenia JSON/regex. - Lintowanie nieaktualnych ścieżek: wyłapuje dryft w odsyłaczach w
references/itemplates/. - Higiena prozy:
scripts/lint_prose.py(świadomy ogrodzeń, świadomy backticków) wymusza regułę CONTRIBUTING.md bez myślników em-dash, bez en-dash, bez--. - Spójność wersji:
tests/test_version_coherence.pypotwierdza, żepyproject.toml,plugin.json,CITATION.cffi frontmatterskills/blog/SKILL.mdsą zgodne. - Spójność poleceń:
tests/test_command_coherence.pypotwierdza, żeskills/blog/SKILL.mdidocs/COMMANDS.mddeklarują ten sam zestaw poleceń.
Uruchom lokalnie przed wypchnięciem:
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
Często Zadawane Pytania
Czym jest claude-blog?
claude-blog to zestaw umiejętności Claude Code do pisania, optymalizacji i audytowania treści blogowych. Uruchamia 30 pod-umiejętności i 5 agentów przez kontrakt dostarczania z 5 bramkami, tak aby każdy artykuł spełniał próg jakości 90/100 zanim do Ciebie dotrze.
Czym claude-blog różni się od bezpośredniego promptowania Claude lub ChatGPT?
Bezpośrednie promptowanie daje jeden szkic z jednego promptu. claude-blog daje ustrukturyzowany potok: badania ze statystykami źródłowymi, zatwierdzenie konspektu, generowanie szkicu, wieloprzebiegową punktację jakości, wykrywanie treści AI, weryfikację faktów, wstrzykiwanie schematu i blokującą recenzję, która iteruje do 3 razy przed dostarczeniem. Umiejętność wymusza to, co starszy redaktor robiłby ręcznie.
Czy potrzebuję członkostwa AI Marketing Hub Pro, aby używać claude-blog?
Nie. Publiczna wersja open-source pod adresem AgriciDaniel/claude-blog jest na licencji MIT i darmowa dla każdego z Claude Code. Prywatne lustro na AI-Marketing-Hub/claude-blog jest dla członków Pro, którzy chcą wczesnego dostępu do funkcji w fazie rozwoju i bezpośredniej współpracy ze społecznością.
Jakie platformy blogowe obsługuje claude-blog?
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby i statyczny HTML. Orkiestrator automatycznie wykrywa platformę na podstawie sygnałów projektu i odpowiednio dostosowuje frontmatter, osadzanie obrazów i wstrzykiwanie schematu.
Czy claude-blog halucynuje statystyki?
Nie. Każda cytowana statystyka przechodzi przez /blog factcheck, która pobiera URL źródłowy i ocenia pewność twierdzenia (dokładne dopasowanie, parafraza, nie znaleziono). Agent blog-reviewer blokuje publikację, jeśli cytowanie nie może zostać zweryfikowane lub jeśli wykrywanie treści AI oznaczy prozę jako wygenerowaną maszynowo.
Czym jest 5-bramkowy Kontrakt Dostarczania Bloga?
Wymuszany kodem potok przed prezentacją, który uruchamia się przy każdym szkicu: Odkrywanie Możliwości, Kompletność Formatu, Weryfikacja Wizualna w 3 szerokościach widoku, Recenzja Treści (BLOKUJĄCA; wynik 90+ i zero P0) oraz Integralność Zasobów i Linków. Orkiestrator iteruje pisarza do 3 razy przy niepowodzeniu którejkolwiek bramki przed eskalacją do Ciebie. Pełna specyfikacja w skills/blog/references/blog-delivery-contract.md.
Czy mogę używać claude-blog w wielu językach?
Tak. /blog multilingual <temat> --languages en,de,fr,es,ja pisze post, tłumaczy go zachowując frontmatter i schemat, przeprowadza głęboką adaptację kulturową dla każdej lokalizacji i emituje tagi hreflang oraz mapę językową gotową dla CMS w jednym poleceniu.
Jak cytować claude-blog w pracy akademickiej?
Zobacz sekcję Jak cytować poniżej lub plik CITATION.cff w katalogu głównym repozytorium. GitHub wyświetla ustrukturyzowany plik cytowania za pomocą przycisku "Cytuj to repozytorium" na stronie publicznego lustra.
Czy claude-blog jest bezpieczny w instalacji?
Instalator dostarcza tylko skrypty Pythona i pliki markdown, nigdy nie wykonuje zdalnego kodu poza tym, co przynosi pip install -r requirements.txt, i jest recenzowany zgodnie z polityką projektu SECURITY.md przy każdej zmianie. Przepływ klonowania, a następnie sprawdzenia tagu pozwala sprawdzić install.sh przed uruchomieniem. Zobacz SECURITY.md dla pełnego modelu zagrożeń.
Mapa Drogowa
<p align="center"> <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/diagrams/05-roadmap-A.svg" alt="mapa drogowa fal claude-blog na horyzontalnej osi czasu: v1.6.0 fundament (Mar 2026), v1.7.0 ramy FLOW (Kwi 2026), v1.8.0 metodologia impeccable (Maj 2026), v1.9.0 kontrakt dostarczania (bieżąca, Maj 2026), v2.0.0 publikowanie multi-CMS (Q3 2026), v3.0.0 blog-jako-kod (Q1 2027)" width="100%"> </p>v1.9.1 (następna)
- Współdzielona funkcja
_count_body_words(html)międzyblog_renderiblog_preflightaby zamknąć pozostałość audytu v1.9.0. - Semantyka kodu wyjścia
generate_hero.py: niezerowy przy braku ścieżki generowania obrazu (obecnie zwraca błąd JSON z wyjściem 0). - Test pokrycia pętli iteracji sprawdzający, czy orkiestrator eskaluje po 3 BLOKADACH recenzenta, a nie 4.
- Przemieść pozostałe dokumenty (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) w poszukiwaniu resztkowego dryftu warstwy v1.x.
v1.10 (wizja)
- Udoskonalanie konspektu na żywo oparte na SERP przez DataForSEO w trakcie pisania.
- Uprząż ewaluacyjna mierząca jakość bloga w różnych konfiguracjach (obecność BRAND.md, wariant persony, tryb wielojęzyczny).
- Wymuszany kodem licznik iteracji (obecnie instrukcja orkiestratora; awansować do poziomu skryptu).
v2.0 (długoterminowe)
- Integracja serwera podglądu bezgłowego: kontrakt 5-bramkowy działa na rzeczywistej domenie podglądu zamiast lokalnego HTML.
- Konektory publikowania CMS na platformę (WordPress, Ghost, Sanity) z idempotentną ponowną publikacją przy przepisywaniu.
- Panel śledzenia cytowań AI w czasie rzeczywistym (które posty są cytowane przez ChatGPT, Perplexity, AI Overviews; mapa cieplna widoczności).
Otwórz zgłoszenie z etykietą roadmap, jeśli chcesz coś zaproponować lub zagłosować.
Odinstalowanie
Unix/macOS:
chmod +x uninstall.sh && ./uninstall.sh
Windows (PowerShell):
.\uninstall.ps1
Integracja
Generowanie wykresów i osadzanie filmów YouTube są wbudowane. Dane Google API wymagają darmowego klucza API (zobacz /blog google setup).
Opcjonalne umiejętności towarzyszące (głębsza analiza opublikowanych stron):
| Umiejętność | Integracja |
|---|---|
/seo | Głęboka analiza SEO opublikowanych stron blogowych |
/seo-schema | Walidacja i generowanie znaczników schematu |
/seo-geo | Audyt optymalizacji cytowań AI |
/seo-google | Dane Google API (współdzielona konfiguracja z blog-google) |
Dokumentacja
Szczegółowa dokumentacja znajduje się w docs/:
- Przewodnik Instalacji: Unix, macOS, Windows, instalacja ręczna.
- Referencja Poleceń: Pełna referencja poleceń z przykładami.
- Architektura: Projekt systemu i przegląd komponentów.
- Przepływ Publikacyjny: Przepływ wydawniczy prywatny-do-publicznego (opiekunowie Pro).
- Szablony: Referencja szablonów i dostosowywanie.
- Rozwiązywanie Problemów: Typowe problemy i poprawki.
- Integracja MCP: Opcjonalna konfiguracja serwera MCP.
Jak cytować
Jeśli używasz claude-blog w badaniach lub produkcji, proszę zacytować projekt:
@software{Agrici_claude_blog_2026,
author = {Agrici, Daniel},
title = {claude-blog: Umiejętność Pisania Bloga AI i Optymalizacji SEO dla Claude Code},
year = {2026},
url = {https://github.com/AgriciDaniel/claude-blog},
version = {1.9.0},
license = {MIT}
}
GitHub wyświetla również ustrukturyzowany plik CITATION.cff za pomocą "Cytuj to repozytorium" na stronie publicznego lustra.
Bezpieczeństwo i Kodeks Postępowania
- Polityka bezpieczeństwa + model zagrożeń:
SECURITY.md. Hartowanie v1.8.x zamknęło wszystkie znane znaleziska; v1.9.0 dodaje bezpieczny przed XSS JSON-LD, odmowę dowiązań symbolicznych O_NOFOLLOW i walidację frontmatter, wszystko zweryfikowane testami mutacyjnymi. Aby zgłosić podatność prywatnie, postępuj zgodnie z procedurą ujawniania wSECURITY.md. - Kodeks Postępowania:
CODE_OF_CONDUCT.md. Konwent Współtwórców. Bądźcie dla siebie wspaniali.
Współtworzenie
Zapraszamy do współtworzenia. Zobacz CONTRIBUTING.md po wytyczne. Przed otwarciem PR:
- Uruchom
python -m pytest tests/(wszystkie 160 muszą przejść). - Uruchom
python3 scripts/lint_prose.py --root .(zero naruszeń). - Uruchom
claude plugin validate .(musi przejść). - Zwiększaj wersje spójnie, jeśli dotykasz liczb lub zachowań widocznych dla użytkownika (zobacz
docs/PUBLISHING.md).
Licencja
Licencja MIT. Zobacz LICENSE po szczegóły.
Powiązane Projekty
- Rankenstein: Przepływ pracy publikowania treści oparty na GUI; od badań do publikacji na jednej platformie.
- Ramy FLOW: Oparte na dowodach prompty Find, Optimize, Win (CC BY 4.0). Zintegrowane jako pod-umiejętność przez
/blog flow. - Claude Ads i Claude SEO: siostrzane umiejętności dzielące ten sam zestaw marki (baner + diagramy generowane z paletą pomarańczową marki).
- AI Marketing Hub: Darmowa społeczność, 2,800+ członków. Poziom Pro na
ai-marketing-hub-prohostuje prywatne lustro tej umiejętności.
Historia gwiazdek
<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="Historia gwiazdek AgriciDaniel/claude-blog na GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> </picture> </a>Jeśli claude-blog oszczędza Ci czas, gwiazdka na publicznym repozytorium to najprostszy sposób, by podziękować (i pomaga innym twórcom treści je znaleźć).
Autor
Zbudowane przez Daniela Agrici, Architekta Przepływów Pracy AI, z Claude Code.
- Blog: Głębokie zanurzenia w automatyzacji marketingu AI.
- YouTube: Samouczki i dema.
- Wszystkie narzędzia open-source: Inne umiejętności Claude Code.
- AI Marketing Hub: Darmowa społeczność marketingu napędzanego AI.


