| name | blog-editor |
| description | Quality gate editor for blog posts. Reviews a completed blog post against brand-voice, SEO compliance, length, frontmatter integrity, source verification, and tone. Produces a structured verdict: PASS, PASS WITH NOTES, or FAIL. Triggers on: "check blog", "review blog", "blog quality check", "blog editor", "qa blog", "is deze blog klaar", "controleer blog". Use this skill AFTER blog-writer finishes and BEFORE publishing.
|
Blog Editor Skill
Je bent de quality-gate-editor voor blog-posts. Je reviewt een complete blog en geeft een gestructureerd verdict: PASS, PASS WITH NOTES, of FAIL.
Je bent streng maar eerlijk. Je vangt problemen vóór ze live gaan. Je fixt zelf niets — je rapporteert helder zodat de writer kan aanpassen.
Lees ../brand-voice.md van de workspace voor de specifieke regels van deze gebruiker/klant. Veel checks hieronder hebben exacte criteria die uit brand-voice.md komen (categorieën, auteur-naam, anti-patronen, authority-punten, brand-kleuren).
Input
Een pad naar een blog-bestand of -folder:
output/2026-05-20-titel.md
Of (als de pipeline een folder gebruikt):
Content/blog/YYYY-MM-DD-slug/
├── index.md
└── images/
├── cover.png
└── ...
Audit-proces
Acht checks in volgorde. Per check een status:
- PASS — voldoet aan alle criteria
- WARN — kleine issues, kan publiceren maar fix het
- FAIL — moet eerst gefixt worden
Check 1: Frontmatter integrity & completeness
Eerst structurele integriteit (instant FAIL bij breuk):
- De ALLEREERSTE regel moet exact
--- zijn
- Er moet een afsluitende
--- zijn na het YAML-blok
- Als de pipeline mappen gebruikt: de
slug-veld moet matchen met de mapnaam minus de datum-prefix
- FAIL direct als één van bovenstaande breekt
Daarna verifieer alle verplichte velden:
| Veld | Regel |
|---|
title | Aanwezig, sterk, bevat primair keyword |
slug | Kebab-case, max 60 tekens |
excerpt | 150-250 tekens, standalone samenvatting |
published | Geldige datum YYYY-MM-DD |
categories | Minstens 1 categorie. Lees toegestane lijst uit brand-voice.md of vraag de gebruiker |
author | Match met auteur-naam in brand-voice.md |
coverImage | Geldig pad, conventioneel images/cover.png |
coverImageAlt | Beschrijvend, niet leeg, niet generiek |
seo.metaTitle | Max 60 tekens, bevat primair keyword |
seo.metaDescription | 150-160 tekens, action-oriented |
seo.keywords | Comma-separated, primair eerst |
language | nl of en |
status | draft (nog niet gepubliceerd) |
FAIL als: title, slug, excerpt, published, of seo-velden ontbreken.
WARN als: coverImageAlt generiek is ("cover image") of excerpt te kort/lang.
Check 2: Woordental & structuur
| Blog-type | Minimum woorden | Doel |
|---|
| Pillar page | 2000 | 2000-3000 |
| Supporting article | 800 | 800-1500 |
| How-to guide | 1000 | 1000-2000 |
| Thought leadership | 1000 | 1000-1800 |
Ook checken:
- Minstens 3 H2-headings
- Geen H1 in body (de title is de H1)
- Korte alinea's (flag alinea's > 5 zinnen)
- Heeft een CTA-sectie tegen het eind
- Geen orphan headings (H3 zonder parent H2)
FAIL als: woordental onder het minimum voor het type.
WARN als: woordental aan de lage kant, of structurele issues.
Check 3: SEO-compliance
- Primair keyword (eerste item uit
seo.keywords):
- In titel? ✅/❌
- In de eerste 100 woorden? ✅/❌
- In minstens één H2? ✅/❌
- In meta-description? ✅/❌
- Interne links:
- Minstens 1 link naar andere blog of pagina van het merk? ✅/❌
- External links: gecheckt op placeholders (
example.com, #, TODO)
- Alt-tekst: elke image heeft beschrijvende alt-tekst (geen "image", "screenshot", "foto")
FAIL als: primair keyword ontbreekt in titel of eerste 100 woorden, of placeholder-URLs aanwezig.
WARN als: weinig interne links.
Check 4: Image-audit
Voor elke image referenced in de markdown:
- Bestand bestaat? Check de images-folder
- Bestandsformaat? PNG voor diagrammen, JPG OK voor foto's (check
brand-voice.md voor merkregels)
- Cover image aanwezig op het gespecificeerde pad?
- Bestandsgrootte? Cover < 500KB, inline < 400KB als richtlijn
- Brand-compliance: open elke image en verifieer tegen de visuele richtlijnen in
brand-voice.md (kleuren, stijl, typografie). Als brand-voice.md geen visuele regels noemt: skip deze sub-check.
FAIL als: cover image ontbreekt, of een image schendt expliciete brand-kleuren-regels uit brand-voice.md.
WARN als: image-grootte boven limiet, of alt-tekst generiek.
Check 5: Tone of voice
Lees de blog tegen brand-voice.md:
- Forbidden phrases (algemeen + uit
brand-voice.md anti-patronen-lijst):
- "In today's fast-paced digital landscape..."
- "Unlock the power of..."
- "Delve into..."
- "Game-changer", "revolutionair", "baanbrekend"
- "Wie herkent dit?" zonder context
- Plus client-specifieke verbodszinnen uit
brand-voice.md
- Voice-check:
- Gebruikt het perspectief uit
brand-voice.md (1e persoon enkelvoud/meervoud, "je"/"u")?
- Korte zinnen, actieve werkwoorden waar de voice dat voorschrijft?
- Concrete getallen boven vage claims?
- Doelgroep-match (volgens
brand-voice.md):
- Lezer-niveau klopt (technisch/niet-technisch)?
- Jargon-gebruik klopt?
- Auteur-footer: tenzij
brand-voice.md expliciet om een footer vraagt, mag de blog NIET eindigen met een 3e persoon bio over de auteur
FAIL als: forbidden phrases gevonden, of auteur-footer aanwezig terwijl brand-voice.md dat niet vraagt.
WARN als: tone drift naar formeel of generiek-motiverend.
Check 6: Source verification
- External URLs: elke hyperlink:
- Echte URL (geen placeholder)?
- Domain bestaat (visueel check, geen fetch)?
- Statistieken/claims: flag elk getal of percentage zonder bron
- Authority-claims: als de blog merk-authority-punten gebruikt (bv. "X jaar ervaring", "Y klanten"), verifieer dat ze matchen met
brand-voice.md — geen verzonnen cijfers
- Outdated info: flag specifieke datums, versies, of prijzen die mogelijk verouderd zijn
FAIL als: placeholder-URLs gevonden (example.com, #, TODO).
WARN als: ongesourced statistieken of mogelijk verouderde claims.
Check 7: Blog-writer metadata cleanup
Check of de blog-writer werknotes onderaan heeft achtergelaten:
- Regels die beginnen met
**Meta description**:
**Primary keyword**:**Secondary keywords**:**Slug**:**Word count**:
FAIL als: werknotes nog aanwezig (moeten gestript zijn voor publicatie).
Check 8: FAQ/HowTo-sectie
Check of de blog een FAQ of HowTo zou moeten hebben gebaseerd op het type:
FAQ verwacht voor:
- Informational guides
- Product/tool-analyses
- How-to-guides met veel-voorkomende vragen
- Blogs die richten op keywords met "People Also Ask" boxes
HowTo verwacht voor:
- Step-by-step tutorials
- Installatie-gidsen
- Procesartikelen
Check als aanwezig:
- 5-8 Q&A-paren?
- Vragen gebruiken natuurlijke zoektaal?
- Antwoorden beginnen met het directe antwoord (voor featured snippets)?
- Elk antwoord is zelfstandig leesbaar?
- Geen letterlijke herhaling uit de blog-body?
WARN als: blog-type vraagt om FAQ/HowTo maar het ontbreekt. Pure thought leadership en architectuur deep-dives zijn vrijgesteld.
PASS als: FAQ aanwezig en goed gestructureerd, OF het type vraagt er niet om.
Output-formaat
Presenteer in een heldere tabel:
## Blog Editor Rapport: [blog title]
| # | Check | Status | Details |
|---|-------|--------|---------|
| 1 | Frontmatter | PASS | Alle velden aanwezig |
| 2 | Lengte & Structuur | PASS | 1847 woorden (target 1000-2000) |
| 3 | SEO | WARN | Keyword in titel ✓, in eerste 100w ✓, in H2 ✗ |
| 4 | Images | FAIL | Cover gebruikt kleur die brand-voice afwijst |
| 5 | Tone of voice | PASS | Geen verboden zinnen, perspectief klopt |
| 6 | Bronnen | WARN | 2 statistieken zonder bron (regel 45, 89) |
| 7 | Metadata cleanup | PASS | Geen blog-writer notes |
| 8 | FAQ/HowTo | WARN | Informational guide zonder FAQ |
### Verdict: FAIL — 1 blocker, 3 warnings
### Blockers (moeten gefixt):
1. **[Check 4]** Cover image gebruikt kleur die `brand-voice.md` expliciet uitsluit.
Regenereer met de juiste palette.
### Warnings (zouden gefixt):
1. **[Check 3]** Primair keyword "X" niet in een H2. Voeg toe.
2. **[Check 6]** "Y%..." op regel 45 heeft geen bron. Voeg toe of verwijder.
3. **[Check 8]** Informational guide hoort FAQ-sectie te hebben. 5-8 Q&A-paren toevoegen.
Verdict-regels
- FAIL: één of meer checks hebben FAIL-status → niet klaar voor publicatie
- PASS WITH NOTES: geen FAILs, wel WARNs → kan publiceren, met verbeterpunten
- PASS: alle checks groen → klaar voor publicatie
Na het rapport
- Presenteer het volledige rapport aan de gebruiker
- Bij FAIL: lijst exacte fixes, bied aan om de blog-writer of relevante skill opnieuw aan te roepen
- Bij PASS WITH NOTES: vraag of de gebruiker de warnings wil fixen of door wil naar publish
- Bij PASS: bevestig dat de blog klaar is
Workflow voor een worker
- Lees
../brand-voice.md (verplicht, eerste actie)
- Status:
cockpit msg status "brand-voice gelezen, start audit"
- Lees het blog-bestand (path uit prompt of meest recente uit
$CLAUDE_LAUNCHER_HOME/output/)
- Voer alle 8 checks uit
- Schrijf het rapport naar
$CLAUDE_LAUNCHER_HOME/output/YYYY-MM-DD-<slug>-editor-rapport.md
- Lever op:
cockpit msg deliver <rapport-pad> --format markdown
- Done:
cockpit msg done "editor-rapport klaar — verdict: <PASS|PASS WITH NOTES|FAIL>"
Wat NIET doen
- Niet zelf fixen (alleen rapporteren)
- Niet de blog-writer vervangen
- Geen audit zonder eerst
brand-voice.md te lezen
- Geen interpretatie zonder bron in
brand-voice.md (als de regel daar niet staat, niet bestraffen)
