Repository navigation
Description
Research brief
Gap. Agents cannot turn Stripe payouts into bookkeeping drafts in Numina. Devantler Tech now keeps its books in Numina (devantler-tech/monorepo#4994), and #697 bundles Numina's MCP server beside the existing Stripe server.
Evidence. The maintainer asked for this skill on 2026-11-13, in the session that chose Numina (devantler-tech/monorepo#4802). Stripe already sits in the platform homepage's Finance group, and business-site#21 plans Stripe payments. Payouts are not live yet, so there are no failed cases to cite.
Where it shows up. Bookkeeping in Numina for any business paid through Stripe.
Acceptance scenarios.
- Should load: "Book last month's Stripe payouts in Numina" -> one draft per payout on the bank line it landed on, split into sales per VAT group, refunds and fees, summing to zero.
- Should load: "Reconcile yesterday's Stripe payout" -> one draft for that bank line, or "not arrived yet" when there is none.
- Near miss: "Refund this Stripe charge" -> not this skill; that is a Stripe write, which needs the user.
- Must not load: "Upgrade our Stripe API version" ->
upgrade-stripe.
Already covered by. stripe-best-practices and stripe-docs cover building with Stripe, not booking its payouts. No bundled skill covers bookkeeping.
Would something else fix it better? Numina's own AI drafts bank lines, but it does not split a payout into the charges, refunds and fees behind it, because that needs Stripe's balance transactions. A skill that uses both servers is the right tool.
Out of scope. Numina's other skills: Gmail receipts (the business mail is not Gmail), Pleo (not used), Google Sheets, and the migration skills (the books start fresh in Numina).
Decision record: adopt numina-stripe
Candidates.
| Candidate | Owner and licence | Reviewed at | Gates | Scores | Verdict |
|---|---|---|---|---|---|
numina-stripe |
Numina Technologies ApS, MIT | commit ddf430b70a05cc93771974569fffae86f7a02a09, tree 9aac97fef5c13d43f1c92b2b76f7182f8d75b48f |
Licence pass (root LICENSE, MIT). Provenance pass (vendor's own public repository, not archived). Supply chain pass (no scripts, downloads or credentials; uses only the Stripe and Numina MCP servers). Correctness: pass with one unverified item, below |
F 2, M 1, C 2, T 1, U 2 | Adopt |
Scores: Maintenance is 1 because the repository is a month old with four commits, so its defect handling is not yet observable. Test quality is 1: examples only, no evaluation cases upstream.
What was read. The whole SKILL.md (one file, 2,538 bytes). Tool names and the reasoning field were checked against Numina's MCP reference: get_company_info, list_accounts, list_vat_codes, search_bank_transactions, create_draft. The search parameters match the REST API's bank-transaction filters. The sign convention (bank line positive, sales negative and gross with a VAT code, refunds and fees positive) matches Numina's accounting model. The VAT grouping matches Danish rules: domestic sales with Danish VAT, EU business sales without Danish VAT, EU consumers through OSS or Danish VAT with the user asked, and no VAT outside the EU. It never books, never moves money, and tells the agent never to plug a difference.
Known defects. None confirmed. Two items are unverified until a live connection:
- Step 1 checks for the
write:draftscope, a name Numina's REST API lists as legacy. If an OAuth connection reportsjournal:writeinstead, the skill stops and asks the user to reconnect. That is a loud failure, never a silent one. create_draft'sbank_transaction_idandcurrencyarguments are not in the public tool table. The README says drafts can be "for a bank line", and a wrong argument fails with an error.
Both get checked on first live use (devantler-tech/monorepo#4995).
Description cost. 168 characters.
Acceptance scenarios. Not tried live yet: the books have no Stripe payouts. To be run on the first payout.
What would change this decision. A wrong VAT treatment or a silent imbalance found on first use.
🤖 Generated with Claude Code
Metadata
Metadata
Assignees
Labels
Type
Fields
Priority
Start date
Target date
Effort
Projects
- StatusShow more project fields✅ Done
Activity
feat(agentic-engineering): adopt Numina's numina-stripe skill
devantler commentedon Nov 12, 2026
Installed in #697 at tree
9aac97fef5c13d43f1c92b2b76f7182f8d75b48f. Try-as-a-user check: installing the skill from the PR head (ef97288) and from upstream (ddf430b) into empty directories gives identical content apart from the provenance metadata. The acceptance scenarios wait for the first live Stripe payout.🤖 Generated with Claude Code
docs(agentic-engineering): record numina-stripe's known defects and f…
devantler commentedon Nov 13, 2026
Decision updated: adopt with known defects
numina-stripe(maintainer, 2026-11-13)CodeRabbit's review of #697 found four defects in the skill and one packaging issue. All were checked against Numina's MCP reference and Stripe's API docs, and all are valid:
write:draftscope check;Two of them can produce a plausible wrong draft, which would normally fail the correctness gate. The maintainer chose to keep the skill with the defects documented, because every result is a draft a person books.
🤖 Generated with Claude Code
docs(agentic-engineering): state numina-stripe's double-booking defec…
feat(agentic-engineering): bundle Numina's MCP server and Stripe skill (