Module 3: Subfolder-architectuur & Skills

Gamification Reward

Rond deze module af om Enterprise Architect Badge te ontgrendelen.

🎯 Wat je hieruit gaat halen

Je agents kunnen communiceren en externe tools aanspreken. Nu bouwen we de kennisbank die ze slim maakt. Via een geavanceerde subfolder-architectuur en herbruikbare Skills geef je elke agent diepgaande expertise — zonder dat je die kennis steeds opnieuw hoeft in te voeren.

Het verschil tussen een goede AI-setup en een enterprise-grade systeem? De kwaliteit van de structuur achter de schermen.

🗂️ De Enterprise Subfolder Architectuur

Naarmate je systeem groeit, wordt je hoofd-CLAUDE.md te groot. De oplossing: een gelaagde structuur waarbij elk niveau zijn eigen context beheert.

# Enterprise Mappenstructuur

Mijn_AI_Kantoor/

├── CLAUDE.md ← Alleen: navigatie & globale regels

├── .claude/

│ ├── skills/ ← Herbruikbare expertise-modules

│ └── settings.json ← MCP-server configuratie

├── AGENTS/

│ ├── research/

│ │ ├── CLAUDE.md ← Agent-specifieke regels

│ │ └── knowledge/ ← Agent-specifieke kennis

│ └── writer/

│ ├── CLAUDE.md

│ └── templates/ ← Content templates

├── SHARED/

│ ├── brand-guidelines.md ← Gedeelde kennis

│ └── naming-conventions.md

└── PROJECTS/

└── [projectnaam]/ ← Per project geïsoleerde context

⚡ Het Skills Systeem

Een Skill is een herbruikbare expertise-module: een SKILL.md bestand dat jouw AI in één klap transformeert in een specialist voor een specifieke taak. Denk aan het installeren van een app op je telefoon — maar dan voor je AI.

Hoe een Skill werkt

Je plaatst een SKILL.md bestand in .claude/skills/[naam]/. De AI laadt de skill automatisch wanneer die taak relevant is.

Skills combineren

Meerdere skills kunnen tegelijk actief zijn. Een copywriting skill + brand-voice skill = altijd on-brand content.

Skills hergebruiken

Exporteer je beste skills als .skill packages en deel ze met collega's of importeer ze in nieuwe projecten.

Skills vs CLAUDE.md

CLAUDE.md bevat globale regels. Skills bevatten diepgaande expertise voor specifieke taken. Gebruik beide samen.

📝 Anatomie van een Goede Skill

Een effectieve SKILL.md heeft vier secties:

# SKILL.md — SEO Copywriting Expert

## Beschrijving

Ik ben een SEO-specialist die content schrijft die rankt én converteert.

## Wanneer te activeren

Gebruik mij bij: blogposts, landingspagina's, meta-descriptions, headers.

## Mijn Aanpak

1. Analyseer zoekintentie van het target keyword

2. Schrijf H1 die zowel SEO als lezer aanspreekt

3. Verwerk LSI-keywords natuurlijk in de tekst

## Kwaliteitsnormen

- Maximaal 150 tekens voor meta-descriptions

- Keyword density: 1-2% (nooit meer)

- Altijd een FAQ-sectie toevoegen voor featured snippets

🎯 De 5 Meest Waardevolle Skill-Types

Brand Voice Skill

Zorgt dat al je content altijd dezelfde toon, stijl en persoonlijkheid heeft — ongeacht welke agent schrijft.

Code Review Skill

Definieert jouw coding standards, naming conventions en review-criteria. Elke code review wordt consistent.

Data Analyse Skill

Instructies voor hoe je AI data interpreteert, visualiseert en rapporteert — altijd in jouw gewenste format.

Client Communication Skill

Schrijft e-mails en rapporten in de toon die past bij jouw klantrelaties. Professioneel en altijd on-brand.

Document Creation Skill

Standaardiseert hoe documenten worden opgebouwd: structuur, formatting, headers en conclusies.

🚀 De Actie-Stap: Bouw Je Eerste Skill

Maak de map .claude/skills/mijn-brand-voice/ aan in je AI-kantoor.
Maak daarin een SKILL.md aan met jouw merkpersoonlijkheid.
Beschrijf: wie schrijft de AI als (formeel/informeel), welke woorden vermijdt de AI, wat is de kernboodschap?
Test de skill: schrijf een stuk content zonder skill, dan met skill. Vergelijk het verschil.
Verfijn de skill op basis van wat je merkt. Een goede skill schrijf je in 3 iteraties.

Voltooien

Klaar voor de finale module?

Volgende Module

Bekijk de tutorial (Binnenkort Beschikbaar)