Database Schema Explainer Skill

De database schema explainer skill is een gratis Claude-skill die een kaal databaseschema omzet in een begrijpelijk datawoordenboek. Hij legt uit waar elke tabel vermoedelijk voor dient, hoe tabellen met elkaar samenhangen en welke kolommen persoonsgegevens lijken te bevatten. Hij leest alleen de structuur. Geen enkele rij.

Wat doet de database schema explainer skill?

Hij geeft Claude een vaste werkwijze om een database te documenteren. Claude somt de tabellen op, beschrijft ze een voor een, leidt het doel af en schrijft het resultaat weg als één markdown-document. Handig als er een nieuwe developer begint, als je een database erft die niemand heeft gedocumenteerd, of voordat je een tabel exporteert en wilt weten welke persoonsgegevens erin staan.

Elk afgeleid doel wordt als afleiding gemarkeerd, bijvoorbeeld “lijkt verzendadressen van klanten op te slaan, op basis van de kolommen”. Is het doel van een tabel niet duidelijk uit de structuur, dan zegt de skill dat, in plaats van stellig te gokken.

Wat levert de database schema explainer skill op?

Eén markdown-document in drie delen:

• “Hoe het samenhangt” bovenaan: een korte kaart van hoe de belangrijkste tabellen met elkaar verbonden zijn.
• Eén sectie per tabel, of bij een groot schema per cluster van tabellen (commerce, auth, content).
• “Kolommen om te controleren” aan het eind: de kolommen die op persoonsgegevens lijken.

De controle op mogelijke persoonsgegevens kijkt naar kolomnamen en -typen: namen, e-mailadressen, telefoonnummers, adressen, betaaltokens of laatste vier cijfers, geboortedata en velden voor identiteitsnummers. Het is een heuristische eerste selectie voor een menselijke controle, geen compliance-audit, en dat staat ook in de output. Je bewaart het document zelf, bijvoorbeeld als schema-dictionary.md in je repository, en genereert het opnieuw als het schema verandert.

Welke tools gebruikt de database schema explainer skill?

Twee leestools uit de Database-add-on van MCP Self-hosted:

• database_list_tables toont de basistabellen die zichtbaar zijn voor de ingestelde databasegebruiker.
• database_describe_table geeft per kolom de naam, het datatype, of de kolom leeg mag zijn en de standaardwaarde.

De describe-tool geeft geen primary of foreign keys terug. Relaties in het woordenboek worden daarom afgeleid uit kolomnamen zoals customer_id en als afleiding gemarkeerd. De skill draagt Claude op dit niet te omzeilen door information_schema via de query-tool te lezen, zodat de eigen read-only-beveiliging van de add-on de baas blijft.

Wat heb je nodig om de database schema explainer skill te gebruiken?

Je hebt MCP Self-hosted en de Database MCP-add-on nodig. De skill is gratis te downloaden en vraagt geen licentie; de add-on verbindt Claude met je database. MCP Self-hosted kost € 217,80 excl. btw: € 180,00/jr met 3 seats, de Database-add-on kost € 108,90 excl. btw: € 90,00 per jaar.

De add-on werkt met MySQL- en MariaDB-compatibele databases (DB_TYPE=mysql) en PostgreSQL (DB_TYPE=postgres). Read-only is genoeg, en dat is ook de standaard. Wil je het echt afdwingen, geef de add-on dan een databasegebruiker met alleen SELECT-rechten. Het woordenboek beslaat precies de tabellen die die gebruiker kan zien. De installatiehandleiding voor Database MCP noemt de verbindingsvariabelen.

DB_TYPE=postgres
DB_HOST=db.internal
DB_NAME=shop
DB_USER=claude_readonly
DB_PASSWORD=...

Hoe installeer je de database schema explainer skill?

1. Download hem via deze pagina. Afrekenen is gratis en het bestand staat daarna onder Skills in Mijn account.
2. Pak de map uit. Daarin zitten SKILL.md en README.md, geen scripts.
3. In Claude Code kopieer je de map naar ~/.claude/skills/, of naar .claude/skills/ in de repository waar de database bij hoort.
4. In Claude Desktop voeg je hem toe via de skills-instellingen van Claude zelf.

Vraag daarna bijvoorbeeld: “Leg dit databaseschema uit voor een nieuwe developer”, “Documenteer onze databasestructuur” of “Welke tabellen en kolommen bevatten persoonsgegevens?”

Wat doet de database schema explainer skill niet?

Hij leest of toont nooit rijdata; elke aanroep gaat over definities van tabellen en kolommen. Heeft je vraag toegang tot rijen nodig, dan valt die buiten de database schema explainer skill. Afgeleide doelen en relaties worden als afleiding getoond, zodat niemand een gok aanziet voor gecontroleerde documentatie. De lijst met persoonsgegevens is een startpunt voor een controle, geen oordeel: reken op af en toe een vals positief of een gemiste kolom.

Bij een groot schema kost het beschrijven van elke tabel één aanroep per tabel. Noem een deel van de tabellen als je maar een stuk van de database gedocumenteerd wilt hebben.

De database schema explainer skill is gratis te downloaden. Haal hem via deze pagina, bekijk alle skills in de catalogus met Claude-skills, of lees op de pagina gratis Claude-skills hoe skills en add-ons samenwerken.