Prompttemplate: Gen AI-vriendelijk schrijven

Dit artikel biedt een gebruiksklaar prompttemplate voor het opstellen of herzien van documentatie met behulp van een AI-schrijftool. De prompt is ontworpen om content te produceren die geoptimaliseerd is voor zowel menselijke lezers als AI-opzoeksystemen zoals Eddy AI.

Voor de volledige onderbouwing achter elke regel in deze prompt, zie Gen AI-vriendelijke content. Om je output te verifiëren voordat je publiceert, gebruik je de Gen AI-vriendelijke contentchecklist.

Wanneer deze prompt te gebruiken

Gebruik deze prompt wanneer je wilt:

• Stel een nieuw artikel op over een onderwerp of overzicht met behulp van een AI-schrijver.
• Herzie een bestaand artikel om het GenAI-vriendelijk te maken.
• Maak een eerste versie voordat je je eigen bewerkingen en beoordelingen aanbrengt.

Master Prompt voor AI-agent

You are a technical documentation writer tasked with creating GenAI-friendly content that works effectively for both human readers and AI-powered assistants.
Follow these rules when drafting the article:

Follow These
Use clear, hierarchical headings (H1, H2, H3) with descriptive, keyword-rich titles.
Write short, focused sentences (<20 words) and one idea per paragraph.
Use bullet points for grouped info and numbered lists for steps (3–7 items max).
Present structured data in tables with clear labels (no merged cells, no empty placeholders).
Format code snippets cleanly, with syntax highlighting, consistent indentation, and meaningful comments.
Provide descriptive alt text for images and clear anchor text for links.
Write in a conversational, user-first tone, using plain language and "you" when guiding.
Apply SEO practices: natural keyword use, meta descriptions, glossary-approved terms.
Include a FAQ section (5–10 self-contained Q&A).
Make content modular and reusable so AI can extract, summarize, and repurpose easily.

Avoid These
Don't use generic headings like "Overview" or repeat the same heading multiple times.
Don't write long, complex sentences or dense paragraphs.
Don't include filler, background fluff, or unnecessary context inside instructional steps (link to supporting content instead).
Don't use vague anchor text like "here" or "this article."
Don't add placeholders in tables (like "Y/N," "—", emojis, or icons).
Don't format code blocks with line numbers or styling that prevents copy-paste.
Don't switch between synonyms or variations of glossary terms inconsistently.
Don't overuse jargon, acronyms, or unexplained abbreviations.
Don't stuff keywords unnaturally or repeat them excessively.

Taakinstructie voor de AI

Generate a [type of article: how-to guide, feature explanation, or FAQ] for [topic/product/feature].
Ensure the output is clear, modular, and optimized for both human readers and AI systems. Include:

Headings/subheadings
Short paragraphs
Bullet/numbered lists where needed
Tables for structured data
At least 5 FAQs with clear answers
Proper SEO keywords (without stuffing)
Consistent glossary

Hoe de prompt aan te passen

Pas het TAAK-gedeelte onderaan aan voor elk artikel dat je opstelt:

Je kunt ook extra instructies toevoegen aan het TAAK-gedeelte, bijvoorbeeld:

• "De doelgroep zijn nieuwe Document360-gebruikers zonder voorkennis van het platform."
• "Verwijs naar de volgende productvoorwaarden: [lijsttermen]."
• "Het artikel zou onder de 600 woorden moeten zijn."

Verpak je prompt als een Vaardigheid

De hoofdprompt hierboven werkt voor eenmalige concepten. Voor herhaalde workflows zoals het documenteren van functies uit PRD's, specificaties of ruwe notities, verpak het als een SKILL.md bestand zodat AI-agenten zoals Claude elke keer hetzelfde proces volgen zonder de prompt opnieuw te plakken.

Een SKILL.md is een gestructureerd Markdown-bestand met twee delen: een frontmatterblok (naam, beschrijving, triggerzinnen) en een body (stappen, schrijfregels, uitvoerformaat). Installeer het één keer; Hergebruik het in je hele team.

Voorbeeld: Tech Writer - vaardigheid voor feature-artikel

Deze vaardigheid helpt Claude om volledige, publicatieklare documentatieartikelen te schrijven voor elke softwarefunctie — volgens de MSTP-conventies (Microsoft Manual of Style for Technical Publications).
Installeer het wanneer je een functie vanaf nul moet documenteren of structuur wilt toevoegen aan ruwe notities. Zodra je actief bent, beschrijf je je functie (of plak een PRD, spec of screenshot) en Claude maakt een volledig artikel dat elk onderdeel behandelt waarop lezers vertrouwen: een scherpe introductie, vereisten, wanneer je de functie moet gebruiken, stapsgewijze instructies, beperkingen, best practices, probleemoplossing en veelgestelde vragen.

Om het te installeren:

1. Download het .skill bestand.

tech-schrijver-feature-artikel.vaardigheid
2. Ga in Claude naar Instellingen -> Connectors -> Aanpassen -> Vaardigheden -> Vaardigheid toevoegen -> Selecteer Vaardigheid aanmaken -> Upload een vaardigheid.
Je kunt nu slepen en neerzetten of klikken om het geïnstalleerde vaardigheidsbestand te uploaden.
3. Zodra de vaardigheid is toegevoegd, deel je simpelweg je functienaam, PRD of notities — Claude regelt de rest.
Werkt het beste als je Claude een productvereistendocument of featurebeschrijving geeft. Hoe meer context je deelt, hoe minder Claude hoeft te vragen.

Na het gebruik van de prompt

AI-output is een eerste versie, altijd beoordelen voordat je publiceert. Controleer op:

• Onvolledige gedachten of ontbrekende stappen.
• Hallucinatiefeiten of onjuiste productdetails.
• Toon of formulering die niet overeenkomt met je documentatiestijl.
• Verklarende woordenlijst die ontbreekt of inconsistent wordt gebruikt.