| name | blog-writer |
| description | Write SEO-optimized blog posts in markdown with frontmatter. Use this skill whenever the user wants to write a blog, create a blog post, draft an article, or mentions "blog", "artikel", "post schrijven", "pillar page", or "supporting article". This skill handles the full blog writing process: research, outline, writing, frontmatter, and image placeholders.
|
Blog Writer Skill
Je schrijft SEO-georiënteerde blogposts in markdown. Stem, doelgroep en authority-punten lees je uit ../brand-voice.md in de workspace-root. Dat is verplicht — lees het bestand altijd vóór je begint.
De output is een .md bestand met YAML-frontmatter, klaar voor pipelines die Hugo, Jekyll, Astro, Strapi of vergelijkbare static-/headless-systemen voeden.
Output-locatie
Schrijf de blog naar $CLAUDE_LAUNCHER_HOME/output/YYYY-MM-DD-<slug>.md waar <slug> een kebab-case beschrijving is van het onderwerp. Roep daarna cockpit msg deliver <pad> --format markdown aan.
Voorbeeld: ~/.claude-launcher/output/2026-05-19-ai-impact-mkb-marketing.md
Frontmatter
Elke blog start met een YAML-blok. De velden hieronder zijn een generieke baseline. Pas aan op de doel-pipeline van de gebruiker (vraag als onduidelijk).
---
title: "Volledige blog titel"
slug: "kebab-case-slug"
excerpt: "1-2 zin samenvatting voor blog-cards en SEO. 150-250 tekens."
published: YYYY-MM-DD
categories:
- category-slug
author: "<auteur-naam>"
coverImage: images/cover.png
coverImageAlt: "Beschrijvende alt-tekst voor de cover"
seo:
metaTitle: "SEO-titel | <merk>"
metaDescription: "Meta description voor zoekresultaten. 150-160 tekens."
keywords: "primair keyword, secundair keyword, tertiair keyword"
openGraphTitle: "Social sharing titel"
openGraphImage: images/cover.png
language: nl
status: draft
---
Frontmatter-regels
- title: helder, met het primaire keyword natuurlijk verwerkt
- slug: kebab-case, max 60 tekens
- excerpt: zelfstandige samenvatting die werkt op een listing-card. 150-250 tekens
- published: geplande publicatiedatum
- categories: vraag de gebruiker welke categorieën zijn pipeline kent als je het niet weet
- author: uit
brand-voice.md
- coverImage: laat
images/cover.png als placeholder staan — een images-skill kan dit later genereren
- seo.metaTitle: max 60 tekens, primair keyword vooraan, eindigend op
| <merk>
- seo.metaDescription: action-oriented, primair keyword erin, 150-160 tekens
- seo.keywords: comma-separated, primair eerst, daarna 2-4 secundair
- language:
nl of en afhankelijk van doelgroep (zie brand-voice)
- status: altijd
draft — de gebruiker reviewt voor publicatie
Blog-structuur
1. Opening hook (geen heading, eerste paragraaf na frontmatter)
Begin met een herkenbare situatie, sterke claim, of feit dat raakt aan de doelgroep. De eerste 2 zinnen verschijnen in Google-snippets en moeten op zichzelf staan.
2. Probleem-erkenning (## heading)
Beschrijf het probleem dat de lezer ervaart. Spreek de lezer direct aan. De lezer moet denken: "ja, dat herken ik."
3. Kern-content (## headings per sectie)
Het vlees van het artikel. Structuur hangt af van het blog-type:
- How-to: genummerde stappen met heldere instructies
- Pillar page: complete gids met meerdere subsecties (2000-3000 woorden)
- Thought leadership: persoonlijke ervaring + frameworks + lessen
- List post: genummerde items met uitleg
4. Praktische takeaway
Concrete actie die de lezer NU kan nemen. Niet vaag.
5. FAQ-sectie (indien van toepassing)
Voeg FAQ toe wanneer:
- Het een informational/guide blog is (richt op "People Also Ask" queries)
- Het een how-to is (veel-gestelde proces-vragen)
- Het een product/tool-analyse is (bezwaren + beslissingsvragen)
## Veelgestelde vragen
### [Vraag zoals mensen 'm zoeken]?
[Concieze antwoord in 2-4 zinnen. Begin met het directe antwoord, voeg context toe.
Verwerk relevante keywords natuurlijk.]
Regels:
- 5-8 FAQ-paren per blog
- Elk antwoord zelfstandig (snapt zonder de blog te lezen)
- Exacte zoekfrasering gebruiken
- Front-load het antwoord, Google extraheert de eerste zin voor featured snippets
- Niet letterlijk herhalen uit de blog-body
Skip FAQ voor pure architectuur-deep-dives of thought leadership-stukken waar het niet past.
6. CTA
Eindig met één duidelijke call-to-action. Type CTA hangt af van de pillar en het doel: lees uit brand-voice.md of vraag expliciet bij de gebruiker.
7. Series-links (indien van toepassing)
Verwijs onderaan naar andere posts in dezelfde reeks.
Image-placeholders
Plaats afbeelding-placeholders waar visuals de content versterken:
Plaats afbeeldingen:
- Na de opening-sectie (cover wordt apart afgehandeld)
- Voor of na sleutel-concepten die baat hebben bij visuele uitleg
- Bij data/statistieken: stel een grafiek voor
- Bij processen: stel een flowchart voor
- Bij vergelijkingen: stel een tabel voor
Schrijf de alt-tekst alsof de afbeelding al bestaat.
Schrijfstijl
Lees ../brand-voice.md voor de exacte voorkeuren van deze gebruiker. Generieke baseline-regels als die ontbreken:
Toon
- 1e persoon ("ik", "mijn ervaring") of "wij", check brand-voice
- Spreek de lezer direct aan met "je" (informeel) of "u" (formeel), check brand-voice
- Conversationeel maar autoritatief
- Korte zinnen, actieve werkwoorden
- Concrete getallen boven vage claims ("47% besparing" niet "aanzienlijke besparing")
Doelgroep-aanpassing
Niet-technische doelgroep (ondernemers, marketeers, kenniswerkers):
- Begin met voordelen en toepassingen, niet met technologie
- Technische begrippen vertalen in één bijzin
- Vergelijk altijd met wat de lezer kent
- Pijnpunten expliciet noemen
- Structuur: voordelen eerst, dan toepassingen, dan uitleg, dan eigen ervaring
- Vermijd jargon, parameters, benchmarknamen zonder context
Technische doelgroep (developers, architecten, technische beslissers):
- Diepgang verwacht: diagrammen, code, benchmarks
- Proof of work via GitHub, concrete metrics, commit history
- Toon: peer-to-peer
- Jargon is prima
SEO best practices
- Primair keyword in de eerste 100 woorden
- Primair keyword in minstens één H2
- Secundair keywords natuurlijk in H2/H3
- Interne links naar andere blog-posts (relatieve paden of volle URLs, check pipeline)
- Korte alinea's (max 3-4 zinnen)
- Bullets en numbered lists voor scanbaarheid
- Meta-description-waardige zin in de opening
Word count targets
- Pillar page: 2000-3000 woorden
- Supporting article: 800-1500 woorden
- How-to guide: 1000-2000 woorden
- Thought leadership: 1000-1800 woorden
Vraag de gebruiker welk type als het niet duidelijk is.
Workflow
- Lees
../brand-voice.md (verplicht, eerste actie)
- Vraag de gebruiker (of de cockpit) het topic, target keyword, type, en eventuele bronnen als die niet in de prompt zaten
- Status:
cockpit msg status "brand-voice gelezen, start onderzoek"
- Onderzoek kort (zoek-tools indien beschikbaar) voor FAQ-vragen, competitor-gaps, ontbrekende datapunten
- Outline de structuur en deel met de gebruiker voor goedkeuring via
cockpit msg question
- Schrijf de volledige post als
.md met complete frontmatter
- Voeg FAQ/HowTo toe waar aanbevolen (5-8 Q&A-paren)
- Sla op in
$CLAUDE_LAUNCHER_HOME/output/YYYY-MM-DD-<slug>.md
- Markeer image-placeholders voor een eventuele images-skill
- Lever op:
cockpit msg deliver <pad> --format markdown
- Done:
cockpit msg done "<woordental> woorden, <type>, klaar voor review"
Wat NIET doen
- Niet publiceren naar live-systemen zonder expliciete bevestiging
- Geen verzonnen statistieken: als je een getal noemt, leg uit waar het vandaan komt
- Geen AI-cliches (zie
brand-voice.md voor de anti-lijst)
- Geen em-dashes
- Geen mock-content met
TODO of [fill in]: werk af of stel een vraag
