Audit or categorize a small business's bank / QuickBooks transactions in seconds with TypeSafe's Jev model, then work the low-confidence pile and hand the owner a fix list. Use when the user says "audit my books", "check my bookkeeper", "categorize my transactions", "clean up my QuickBooks", "is my bookkeeping right", or gives you a bank / QuickBooks CSV export.
Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Jev Bookkeeper?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/kjagsadvisors-jev-bookkeeper)
---
name: jev-bookkeeper
description: Audit or categorize a small business's bank / QuickBooks transactions in seconds with TypeSafe's Jev model, then work the low-confidence pile and hand the owner a fix list. Use when the user says "audit my books", "check my bookkeeper", "categorize my transactions", "clean up my QuickBooks", "is my bookkeeping right", or gives you a bank / QuickBooks CSV export.
---
# jev-bookkeeper
Division of labor. Keep it this way:
- **Jev** (via the `jev-books` CLI) makes the bulk decisions: every transaction gets a category plus a confidence score, thousands of rows in seconds for fractions of a cent.
- **You (Claude)** only work the rows Jev flagged as uncertain, or where it disagrees with the bookkeeper. Reason about those, group them, and write the fix list.
- **The owner** decides. You never edit QuickBooks or the bank data. You produce a list they act on.
Don't categorize the whole file yourself. That throws away the speed and cost that make this worth running.
## 1. Get the file
Ask for the export if they haven't given one. Tell them exactly where it is:
- **QuickBooks Online:** Reports → *Transaction Detail by Account* → date range → Export → **CSV**. This has the bookkeeper's categories, so use audit mode.
- **Bank:** online banking → download transactions as CSV. There are no existing categories, so use categorize mode.
If they say it's in Downloads, look there (`ls -t ~/Downloads/*.csv | head`) and confirm which file before running.
## 2. Run the tool
Use `jev-books` if it's on PATH. Otherwise run it without installing:
```bash
uvx --from git+https://github.com/kjagsadvisors/jev-bookkeeper jev-books <file.csv> [--audit]
```
- The file has a Split / Category / Account column: `--audit`. The output adds `disagrees_with_bookkeeper`.
- Plain bank export: no flag. Pass `--chart <file>` if they have their own chart of accounts.
- Big file or first run: add `--limit 50` first, show them the result, then run the whole thing.
- Output goes to `<file>.jev.csv` (or `-o path`). The terminal summary has row count, seconds, cost and review counts. Quote those numbers exactly; don't round them into something they aren't.
**API key.** The tool needs `TYPESAFE_API_KEY`, set in the environment or in a `.env` file in the working directory. If it's missing, **don't ask the user to paste the key into chat.** Tell them to run `jev-books <file.csv>` once in their own terminal. It asks for the key with hidden input and saves it to `.env`. Keys come from https://console.typesafe.ai/keys.
**Privacy.** Before the first run on real books, say in one line that transaction payee, memo and amount are sent to TypeSafe's API, and get a yes.
## 3. Work the pile
Load the output CSV with a short Python script. Do all counting and dollar sums in code, never in your head. Pull out:
1. `disagrees_with_bookkeeper == yes` and `needs_review` empty. Jev is confident the bookkeeper is wrong. **Start here.**
2. `needs_review == yes`. Jev isn't sure.
Group by payee, since the same vendor usually repeats. For each group, decide:
- **Fix:** it's clearly miscategorized. Give the right category and a one-line reason ("Chipotle is a restaurant, not fuel").
- **Fine as is:** the bookkeeper's choice is defensible and Jev was being literal. Say why.
- **Ask the owner:** it could be personal, or you can't tell (Venmo, Zelle, Amazon, streaming services, cash). Write the question you'd ask.
`(none of these fit)` in audit mode means the right category doesn't exist in their books yet. Suggest the account they'd need to add.
## 4. Hand back
Write `fix-list.csv` next to the input with the columns `payee, rows, total, bookkeeper_category, suggested_category, action (fix / fine / ask), reason`. Then give a short summary:
- The run line: "N transactions in X s for $Y. Z flagged, W disagreements."
- The top fixes by dollar amount.
- The questions for the owner, as a numbered list they can answer in one message.
## Honest limits (say these when relevant, don't bury them)
- There's no published bookkeeping accuracy benchmark for Jev. Confidence shows where it's unsure, but confident answers can still be wrong. In testing it filed Netflix under Software at 0.93.
- "Can't hallucinate" only means the answer is always one of the listed categories.
- QuickBooks bank rules already handle easy repeat vendors for free. This earns its keep on backlogs, cleanups and second opinions.
- This is a review aid, not tax or accounting advice. Anything that changes a filed return goes to their CPA.