Standaarden - Claude Code Plugin
Claude Code plugin voor Nederlandse overheidsstandaarden. Bevat skills voor 77 van de 88 GitHub repositories van Logius standaarden voor interoperabiliteit: API Design Rules, Digikoppeling, OAuth NL, FSC, CloudEvents, BOMOS en meer.
CONCEPT — Deze plugin is in ontwikkeling en is geen officieel product van Logius. De officiële standaarden zijn altijd leidend. Zie de verantwoording en disclaimer voor meer informatie.
Installatie
Globaal installeren (aanbevolen)
Voeg de overheid-plugins marketplace toe en installeer de plugin. De skills zijn daarna beschikbaar in elke Claude Code sessie.
claude plugin marketplace add developer-overheid-nl/skills-marketplace
claude plugin install logius-standaarden@overheid-plugins
Per sessie laden
Alternatief: laad de plugin alleen voor de huidige sessie via --plugin-dir:
git clone https://github.com/developer-overheid-nl/skills-standaarden.git
claude --plugin-dir ./skills-standaarden
Wat doet deze plugin?
De plugin biedt 10 skills die een AI-agent helpen bij:
- Implementeren van standaard-conforme code (OAuth, Digikoppeling, CloudEvents, etc.)
- Navigeren door 77 repositories, gegroepeerd in 9 domeinen
- Ophalen van actuele content via
gh api en WebFetch
- Valideren met Spectral linter, WCAG checks, markdown linting (via
/ls-pub)
- Kiezen van het juiste profiel of protocol via beslisbomen en keuzematrices
Instructie-gedreven aanpak
Skills zijn geschreven als agent-instructies, niet als encyclopedie. Elke SKILL.md bevat:
- Wanneer de skill gebruikt moet worden
- Repository-overzicht
- Beslisbomen en keuzematrices
- Werkende implementatievoorbeelden
- Domein-specifieke foutafhandeling
Achtergrondkennis (architectuur, protocollen, concepten) staat in reference.md bestanden die de agent kan raadplegen wanneer nodig.
Skills
| Skill | Domein | Repos | Beschrijving |
|---|
/ls | Overzicht | - | Meta-skill: routeert naar het juiste domein |
/ls-dk | Digikoppeling | 17 | Beveiligde gegevensuitwisseling (REST, ebMS2, WUS, GB), OIN |
/ls-api | API Design Rules | 9 | NL GOV API-standaard, Spectral linter, referentie-implementaties |
/ls-iam | Identity & Access Management | 8 | OAuth 2.0 NL, OpenID Connect, AuthZEN, SAML |
/ls-fsc | Federated Service Connectivity | 7 | Federatief netwerk: inway/outway, contracten, service directory |
/ls-logboek | Logboek Dataverwerkingen | 8 | AVG-logging, OpenTelemetry, W3C Trace Context |
/ls-notif | CloudEvents & Notificaties | 4 | NL GOV CloudEvents profiel, pub/sub |
/ls-bomos | BOMOS Governance | 10 | Beheer- en Ontwikkelmodel voor Open Standaarden |
/ls-egov | E-Government Services | 6 | Terugmelding, Digimelding, e-procurement |
/ls-pub | Publicatie & Tooling | 9 | ReSpec, GitHub Actions, WCAG checks, markdown lint |
Voorbeeldvragen
Welke Logius standaarden zijn er?
Wat zijn de API Design Rules?
Toon de laatste wijzigingen aan de Digikoppeling architectuur
Run de Spectral linter op mijn OpenAPI spec
Hoe implementeer ik OAuth 2.0 NL profiel?
Wat is het verschil tussen ebMS2 en REST koppelvlak?
Hoe stel ik een BOMOS beheermodel op?
Run een WCAG check op mijn document
Structuur
.claude-plugin/
plugin.json # Plugin manifest
skills/
ls/SKILL.md # Meta/overzicht skill
ls-api/
SKILL.md # Agent-instructies en implementatievoorbeelden
reference.md # Achtergrondkennis en repo-exploratie
conflicts.md # Bronconflicten en gemaakte keuzes
ls-dk/
SKILL.md
reference.md
conflicts.md
... # Idem voor alle 9 domein-skills
Content strategie
Skills bevatten compacte agent-instructies, beslisbomen en implementatievoorbeelden. Encyclopedische achtergrondkennis staat in reference.md. Bronconflicten en bewuste keuzes (bijv. discrepanties tussen GitHub-tags en gepubliceerde versies) zijn gedocumenteerd in conflicts.md. Actuele content wordt on-demand opgehaald via gh api en WebFetch - de GitHub repos zelf zijn de bron van waarheid.
Versioning
De hele plugin wordt als 1 eenheid geversioned (semver):
