De Laposta-skill installeren voor je AI-assistent
Een skill is een map met instructies voor je AI-assistent. De Laposta-skill bevat de volledige API: alle endpoints, verplichte velden, foutcodes en veelgemaakte fouten. Je hoeft dus niets uit te leggen voordat je iets vraagt.
De skill is gratis, open source en staat op github.com/laposta/laposta-skill. De endpoint-referentie in de skill wordt gegenereerd uit dezelfde bron als deze documentatie. Verandert de API, dan draait er één script en klopt de skill weer.
Voorbeelden van opdrachten
Je kunt alles doen wat de API kan, in gewone taal. Een paar voorbeelden van opdrachten die je direct kunt gebruiken:
- “Hoeveel actieve relaties staan er in elk van mijn lijsten?”
- “Zet deze twaalf adressen in de nieuwsbrieflijst, met de voornaam in het juiste veld.”
- “Wie heeft zich vorige maand afgemeld?”
- “Maak een campagne van dit html-bestand en stuur mij een testmail.”
- “Vergelijk de open- en klikratio van mijn laatste vijf campagnes.”
Vraag je naar een endpoint, dan zoekt de skill het antwoord op in zijn eigen referentie in plaats van het uit zijn geheugen te halen.
Installeren in Claude Code
De repository is ook een plugin-catalogus. Voer deze twee regels uit:
Kies daarna waar de skill komt te staan: voor jezelf, voor één project of alleen lokaal. Updates kun je later binnenhalen met /plugin marketplace update laposta-skill.
Krijg je de melding dat /plugin niet beschikbaar is, dan ligt dat niet aan de skill. Die schuine-streep-commando’s werken alleen in Claude Code in de terminal, niet in de desktop-app of de browser. Gebruik daar deze gewone commando’s:
Zet je de bestanden liever zelf neer, kopieer dan de map laposta naar je persoonlijke skills-map. Claude Code herkent de map direct, zonder dat je het programma hoeft te herstarten.
Installeren op claude.ai
Op claude.ai is er geen catalogus, dus daar kun je een zipbestand uploaden. Zorg dat de map laposta de bovenste laag in het zipbestand is, anders wordt hij niet herkend.
Upload dit bestand in je instellingen bij ‘Skills’.
Op claude.ai moet netwerktoegang aanstaan, anders kan de assistent api.laposta.nl niet bereiken. Of je die zelf kunt aanzetten, hangt af van je eigen instellingen en van wat een beheerder toestaat. Via de API van Claude werkt de skill op zich wel, maar komt hij niet bij api.laposta.nl omdat die omgeving geen internetverbinding heeft.
Installeren in andere assistenten
De skill gebruikt alleen de velden uit de Agent Skills-standaard. Dezelfde map werkt dus in elk programma dat die standaard volgt, zoals Gemini CLI, GitHub Copilot, Codex en Cursor. Waar de skills-map staat, verschilt per programma. Dit kun je terugvinden in de documentatie van het programma zelf.
Je API-sleutel meegeven
De skill vraagt in het gesprek niet om je sleutel, maar leest die uit de omgevingsvariabele LAPOSTA_API_KEY. Stel die zo in:
Hoe je aan een sleutel komt, lees je in API-sleutel aanmaken. Maak hiervoor een aparte sleutel aan. Waarom dat belangrijk is, staat bij AI-assistent koppelen.
Veilig werken met de skill
De veiligheidsregels zitten in de skill zelf, dus daar hoef je niet aan te denken.