setup-vink
Skill6 starsChanged 2 days agoMITView on GitHub
Eenmalige onboarding — stelt de bedrijfsgegevens (afzender) en standaard betaaltermijn in door interactief data/business.json te vullen, en legt kort uit wat elke skill (/factuur, /zelffactuur, /bon, /betaald, /aangifte, /dashboard, /jaaropgave) doet. Roep aan bij eerste gebruik of als business.json nog ontbreekt.
In this repository9 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- seed/CLAUDE.mdCLAUDE.md
- aangifteSkill
- betaaldSkill
- bonSkill
- dashboardSkill
- factuurSkill
- jaaropgaveSkill
- zelffactuurSkill
The file
Files
Setup / onboarding
Help een nieuwe gebruiker zijn administratie-map in gebruik te nemen: initialiseer de map met lege
templates, vul de afzendergegevens (data/business.json) en de standaard betaaltermijn in,
en geef een korte uitleg van de beschikbare skills. Dit is een eenmalige stap; daarna gebruikt de
gebruiker /factuur, /bon, enz.
De code/skills/regels/templates komen uit de plugin (${CLAUDE_PLUGIN_ROOT}/...); de data
komt in de huidige map (waar Claude Code draait) — die blijft van de gebruiker en overleeft
plugin-updates.
Stappen
0. Initialiseer de map (alleen wat ontbreekt)
Zet bij eerste gebruik de lege template-bestanden klaar. -n/-Rn overschrijft niets wat er al
staat, dus dit is veilig om altijd te draaien (|| true: cp -n meldt een fout-status als een
bestand al bestaat — dat is hier juist de bedoeling):
mkdir -p data facturen bonnen aangiftes jaaropgaven
cp -Rn "${CLAUDE_PLUGIN_ROOT}/seed/data/." data/ || true
cp -n "${CLAUDE_PLUGIN_ROOT}/seed/business.example.json" data/business.example.json || true
cp -n "${CLAUDE_PLUGIN_ROOT}/seed/CLAUDE.md" CLAUDE.md || trueDit maakt (indien nog niet aanwezig): de lege CSV-templates in data/, een voorbeeld
business.example.json, een project-CLAUDE.md met de mapconventies, en de uitvoer-mappen.
Bestaat alles al → er verandert niets en je gaat door naar stap 1.
Bestond CLAUDE.md al? Vergelijk 'm met de versie uit de plugin:
diff -q "${CLAUDE_PLUGIN_ROOT}/seed/CLAUDE.md" CLAUDE.md. Verschilt hij, dan is de plugin sindsdien
bijgewerkt (bv. nieuwe map-conventies) of heeft de gebruiker 'm zelf aangepast. Meld dat en vraag of je 'm
mag vervangen; zo ja, bewaar eerst de oude als CLAUDE.md.bak. Nooit ongevraagd overschrijven.
1. Check of er al een setup is
Lees data/business.json.
- Bestaat het al met een echte naam (niet "Jouw Bedrijfsnaam")? Meld dat de setup al gedaan is, toon de huidige kerngegevens (naam, BTW-nr, IBAN, betaaltermijn) en vraag of de gebruiker iets wil wijzigen. Zo nee → klaar. Zo ja → ga naar stap 3 voor de te wijzigen velden.
- Bestaat het niet (alleen
data/business.example.json)? Ga door naar stap 2.
2. Korte introductie
Leg in 3-4 zinnen uit wat dit is: een lichtgewicht ZZP-administratie op platte bestanden, waar de
AI redeneert en lib/admin.mjs deterministisch rekent en schrijft. Noem dat je nu eerst zijn
bedrijfsgegevens nodig hebt om geldige facturen te kunnen maken (factuureisen Art. 35a Wet OB).
3. Vraag de bedrijfsgegevens
Vraag de velden hieronder. Vraag ze gegroepeerd (niet per stuk een aparte vraag) zodat de
gebruiker ze in één keer kan plakken, maar maak duidelijk welke verplicht zijn. Lees
data/business.example.json voor de exacte veldnamen/structuur.
Verplicht (anders kan er geen geldige factuur):
name— bedrijfs-/handelsnaam (afzender op de factuur)address— straat + huisnummerpostal_code— postcodecity— plaatscoc_number— KvK-nummervat_number— BTW-id (formaatNL........B..)iban— rekeningnummer voor betaling
Optioneel / met default:
account_holder— tenaamstelling rekening (default =name)country— defaultNederlandphone,email,website— komen op de factuur als ze ingevuld zijn (mogen leeg)payment_terms_days— standaard betaaltermijn in dagen (zie stap 4)language— standaardtaal voor factuur-PDF's én het dashboard:nl(default) ofen. Vraag dit kort: schrijft de gebruiker vooral aan Nederlandse klanten (nl) of ook aan buitenlandse (en)? Dit is alléén de standaard — per factuur kan/factuurer alsnog een Engelse van maken (bv. voor een buitenlandse klant). De aangifte blijft altijd Nederlands (officiële Belastingdienst-rubrieken).telemetry— anonieme gebruiksping:true(default) offalse. Stel hier geen vraag over, maar meld het altijd in één zin: Vink stuurt één keer per maand een anonieme ping naar vinkapp.nl (geen ID, geen administratiedata), zodat de maker ziet hoeveel mensen Vink gebruiken. Wil de gebruiker dat niet, zet danfalse.
Wat de gebruiker leeg laat van de optionele velden: laat leeg ("") of gebruik de default. Vul nooit zelf een KvK-/BTW-nummer of IBAN in — dat moet de gebruiker aanleveren. Ontbreekt een verplicht veld, vraag er gericht naar voor je wegschrijft.
4. Betaaltermijn
Vraag de standaard betaaltermijn in dagen (payment_terms_days). Gangbaar bij ZZP: 14, 21 of
30 dagen; default 14. Dit is de standaard voor álle facturen; per klant kun je later een
afwijkende termijn zetten in de kolom payment_terms van data/clients.csv. 0 = direct
betalen.
5. Toon preview → bevestiging
Toon de samengestelde business.json compact (alle velden) en vraag bevestiging. Pas aan op
feedback en toon opnieuw.
6. Schrijf weg
Schrijf het JSON-object naar data/business.json (met de Write-tool, nette indentatie). Het
bestand blijft in de map van de gebruiker; de plugin zelf bevat alleen het lege voorbeeld.
7. Korte uitleg van de skills
Sluit af met een compacte uitleg (één regel per skill) zodat de gebruiker weet wat hij heeft:
- /factuur — verkoopfactuur maken (omzet). Genereert een PDF en boekt in de CSV's.
- /zelffactuur — factuur die je opdrachtgever namens jou maakte (self-billing) importeren; telt óók als omzet.
- /bon — bon/inkoopfactuur als kosten verwerken; classificeert de BTW en converteert vreemde valuta.
- /betaald — een verkoopfactuur op betaald zetten (status + betaaldatum).
- /aangifte — kwartaal-BTW-overzicht samenstellen ter voorbereiding van je aangifte.
- /dashboard — stand van zaken: openstaande facturen, omzet/kosten, eerstvolgende aangifte-deadline.
- /jaaropgave — jaarcijfers (omzet → belastbare winst) ter voorbereiding van je aangifte inkomstenbelasting.
Noem ook even: de map ${CLAUDE_PLUGIN_ROOT}/rules/ bevat de Nederlandse fiscale regels die de skills raadplegen, en dat
dit een voorbereidend hulpmiddel is — de feitelijke aangiftes (BTW en inkomstenbelasting) doet de
gebruiker zelf bij de Belastingdienst. Stel voor om als eerste een /factuur of /bon te proberen.
Belangrijk
- Vul nooit zelf fiscale identifiers (KvK, BTW-nummer, IBAN) in — alleen de gebruiker levert die.
- Overschrijf een bestaande, ingevulde
business.jsonniet zonder expliciete bevestiging. - Dit raakt alleen
data/business.json; klanten/facturen/bonnen komen via de andere skills.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

