drafting-invoices
Skill0 starsChanged 9 days agoMITView on GitHub
Drafts a SuperBooks invoice for a customer, optionally from tracked time, creates the customer if needed, and sends it only after an explicit confirmation naming the invoice and recipient. Use when the user asks to 'invoice Cedar Valley Books for 6 hours of design at $125', 'bill my September hours on Harbor & Pine', 'create an invoice', 'turn my tracked time into an invoice', 'add a new customer', or 'send this invoice'.
In this repository66 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- adding-uptime-monitorsSkill
- analyzing-page-performanceSkill
- booking-meetingsSkill
- building-onboarding-workflowsSkill
- building-study-guidesSkill
- capturing-tasksSkill
- capturing-web-pagesSkill
- chasing-unpaid-invoicesSkill
- checking-domain-connectionsSkill
- checking-email-deliverabilitySkill
- checking-notification-deliverySkill
- checking-uptime-statusSkill
- cleaning-up-bookkeepingSkill
- connecting-customer-domainsSkill
- discussing-buildsSkill
- drafting-social-postsSkill
- editing-demosSkill
- editing-page-draftsSkill
- extracting-document-textSkill
- finding-meeting-timesSkill
- handling-flaky-changesSkill
- investigating-tasksSkill
- making-demo-videosSkill
- managing-bookingsSkill
- managing-content-calendarSkill
- managing-demosSkill
- managing-voice-librarySkill
- planning-revisionSkill
- preflighting-domainsSkill
- publishing-pagesSkill
- reading-financial-reportsSkill
- reading-text-aloudSkill
- reading-web-pagesSkill
- reporting-snapvisor-usageSkill
- researching-course-materialSkill
- researching-summary-librarySkill
- responding-to-incidentsSkill
- reviewing-email-performanceSkill
- reviewing-notification-workflowsSkill
- reviewing-social-performanceSkill
- reviewing-visual-buildsSkill
- reviewing-workloadSkill
- searching-getitdone-api-docsSkill
- sending-email-campaignsSkill
- sending-notificationsSkill
- setup-bioflowSkill
- setup-calySkill
- setup-demofySkill
- setup-dodomainSkill
- setup-getitdoneSkill
- setup-notiflySkill
- setup-postifySkill
- setup-sendlySkill
- setup-shortySkill
- setup-snapvisorSkill
- setup-superbooksSkill
- setup-unotesSkill
- setup-upapiSkill
- setup-uptimelySkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 2 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 16
Operations listed by name: call them directly, for example superbooks:invoices_list.
- Very specific: line 27
If the connection lists the operations by name instead (the per-tool surface), call them directly without the external_ prefix.
- Very specific: line 47
Only if the user asks to send it: restate "Send INV-0007 for $750.00 to billing@cedarvalley.example?" and wait for a yes.
- Very specific: line 63
Never call external_invoices_send without an explicit confirmation naming the invoice and the recipient in this conversation.
- Distinctive: line 64
Do not invent rates, hours, or tax.
- Distinctive: line 65
No operation moves money; there is no payment tool.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- Generated from plugins/superbooks/skills/drafting-invoices/SKILL.md by scripts/sync-skills.mjs. Edit the plugin copy, then run the script. -->Draft an invoice in SuperBooks
Build a correct draft invoice from what the user says or from their tracked time. The draft stays in SuperBooks until the user explicitly asks to send it; sending e-mails the customer.
Connecting and calling the tools
Every operation in this skill comes from the superbooks MCP server, the SuperBooks connector. The server defaults to Code Mode, so the operations below are written as the external_* functions you call inside superbooks:execute_typescript. On a server set to the per-tool surface, the same operation is listed as superbooks:<name> without the external_ prefix, for example superbooks:invoices_list.
- Only
superbooks:search_toolsandsuperbooks:execute_typescriptlisted (Code Mode, the default): callsuperbooks:search_toolsfirst, then call each tool insidesuperbooks:execute_typescriptasexternal_<tool>(for exampleexternal_invoices_list); the program mustreturnits result. Scopes, confirmations and gates are identical on both surfaces. - Operations listed by name: call them directly, for example
superbooks:invoices_list. - "Tool not found": switch to the Code Mode route instead of retrying the direct call. If
superbooks:search_toolsdoes not return the tool either, its OAuth scope was not granted; the user reconnects SuperBooks and approves that scope. - No
superbookstools at all: SuperBooks is not connected yet. Follow thesetup-superbooksskill.
Tools you will use
The superbooks MCP server has two tools. Everything below goes through them.
superbooks:search_tools: lists the operations this connection can reach asdeclare function external_<name>(...)signatures. Call it first, for example with the queriesinvoice,customer,tracker, to get the exact input shapes.superbooks:execute_typescript: runs a short program calling thoseexternal_*functions, which are already in scope; never import or redeclare them. The program mustreturnits result.
If the connection lists the operations by name instead (the per-tool surface), call them directly without the external_ prefix.
Operations this skill uses:
external_customers_listandexternal_customers_get: find the customer and their billing details.external_customers_create: add a customer that does not exist yet.external_tracker_list_projectsandexternal_tracker_list_entries: tracked projects and their time entries (start, stop, description).external_team_get: the team profile, including its currency.external_invoices_create_draft: save an invoice with line items and a due date as a draft. Returns the invoice number.external_invoices_get: read the draft back to confirm totals.external_invoices_send: e-mail the invoice to the customer and mark it unpaid. Confirm first, every time.
Workflow
- In one program, fetch
external_customers_listandexternal_team_getwithawait Promise.all. If the customer is missing, offer to create one; ask for the name and billing e-mail, then callexternal_customers_create. - Build the line items:
- From the user's words: description, quantity, unit price.
- From tracked time: find the project with
external_tracker_list_projects, fetchexternal_tracker_list_entriesfor the period, total the hours, and show the entries you are billing.
- Show the draft: customer, line items, subtotal in the team currency, due date (default 30 days unless the user says otherwise).
- On approval, call
external_invoices_create_draft. Report the invoice number and that it is a draft the customer has not received. - Only if the user asks to send it: restate "Send INV-0007 for $750.00 to billing@cedarvalley.example?" and wait for a yes. Then run
external_invoices_sendon its own, and confirm withexternal_invoices_getthat it is unpaid with asent_attime.
Code Mode pattern
const [customers, team] = await Promise.all([
external_customers_list({}),
external_team_get({}),
]);
return { customers, currency: team.currency };A call that is out of scope or fails throws an Error whose message says what went wrong. Wrap it in try { ... } catch (e) { return String(e) } and relay the message.
Rules
- Never call
external_invoices_sendwithout an explicit confirmation naming the invoice and the recipient in this conversation. Drafting never implies sending, and a send never runs in the same program as other writes. - Do not invent rates, hours, or tax. Ask when a price or quantity is missing.
- No operation moves money; there is no payment tool.
- Deleting or voiding invoices is not offered here. If the user asks, point them to the SuperBooks app.
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.

