Skip to content
Back to skills

Jev Bookkeeper

ASecurity

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.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added October 15, 2026
ai-agentspythongobashtestinggitapi

Works with

  • terminal
  • cli
  • api

Security analysis

A100/100

Scanned October 15, 2026

npx -y skills add kjagsadvisors/jev-bookkeeper --skill jev-bookkeeper --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Jev Bookkeeper?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Jev Bookkeeper
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/kjagsadvisors-jev-bookkeeper/badge)](https://www.skillsdirectory.com/skills/kjagsadvisors-jev-bookkeeper)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
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.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.