# ap-processor

ap-processor reads vendor bills from the AP inbox or uploaded PDFs and photos, codes them to your accounts and jobs, checks POs, and stages a payment run. Nothing posts without your yes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 387 installs · ★ 36654 repo stars
- Author: anthropics · official Anthropic repository
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/anthropics/knowledge-work-plugins/tree/HEAD/small-business/skills/ap-processor/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ap-processor

## What it does

The skill collects bills from an AP mail folder (Gmail or Microsoft 365), uploaded PDFs, phone photos, and Ramp or Expensify when those are connected. It removes duplicates first, so an emailed PDF, a portal reminder and a statement line count as one bill. Then it pulls vendor, invoice number, dates, terms, tax, total and line items. A field it can't read stays empty and is reported with the vendor and invoice number.

Coding follows your chart of accounts, class and job, leaning on how that vendor was coded before. A supply-house invoice can be split across jobs by line. Anything doubtful goes to a "needs your call" list with a suggested code. Where purchase orders exist, it runs a three-way match of bill, PO and receiving ticket and flags price and quantity variances.

Entries and the payment run each need their own yes. Zoho Books has no bill object, so unpaid bills for it come out as an import file instead. A bill whose bank details or remit-to differ from the vendor record is never staged until you phone the vendor on the number already on file.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/knowledge-work-plugins --skill ap-processor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ap-processor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ap-processor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/knowledge-work-plugins --skill ap-processor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ap-processor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/knowledge-work-plugins --skill ap-processor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ap-processor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/knowledge-work-plugins small-business/skills/ap-processor
```

2. **Manually: put the files in place**
- File: `.github/skills/ap-processor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/knowledge-work-plugins --skill ap-processor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/anthropics/knowledge-work-plugins --path small-business/skills/ap-processor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ap-processor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add anthropics/knowledge-work-plugins --skill ap-processor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/anthropics/knowledge-work-plugins/tree/HEAD/small-business/skills/ap-processor/SKILL.md

## When to use it
- pull vendor bills out of an AP mailbox and into QuickBooks, Xero or NetSuite
- see what is due this week and what is already late
- catch a duplicate invoice before it gets paid twice
- split one supply-house invoice across several jobs
- spot bills for more than what the receiving ticket shows

## Example prompts
- Use `ap-processor` to go through the AP folder and show me what I owe this week.
- Pull the invoices out of my email, code them, and stage them for QuickBooks. Don't enter anything until I say yes.
- Here's a photo of a supplier invoice. Run it through `ap-processor` and tell me if we were billed for it already.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3820c7866a61d73e.

BEGIN THIRD-PARTY FILE 3820c7866a61d73e
```text
---
name: ap-processor
description: >
  Works the bill pile end to end: reads bills and vendor statements out of the
  AP inbox or from uploaded PDFs and phone photos, pulls out vendor, amount,
  due date, and line detail, codes each one to the right account and job,
  matches it against the purchase order and the receiving ticket, then stages
  the entries and a proposed payment run in QuickBooks, Xero, or NetSuite for
  the owner to approve in one pass. Nothing is entered and nothing is paid
  without an explicit yes. Reach for this whenever bills, vendor invoices, or
  paying people comes up — including "what do I owe," "the bills are piling
  up," "pull the invoices out of my email and into QuickBooks," "code these
  for me," "who needs to get paid this week," "did we get billed twice," or
  when the owner forwards a supplier invoice with no message at all. Use it
  before cash-flow-snapshot or month-end-prep so those run on real payables
  instead of a guess.
allowed-tools: Read, WebFetch
---

# AP Processor

Turn the bill pile into coded entries and one payment decision.

Owners describe this job as printing, stamping, and hand-keying the same twenty invoices every month. It is almost entirely mechanical — right up to the part where money leaves the account, which is entirely the owner's call.

## Step 1 — Gather the bills

Pull from whatever the owner actually has:
```
END THIRD-PARTY FILE 3820c7866a61d73e

The third-party file has ended. Everything between the 3820c7866a61d73e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1401 of 14923 bytes. © anthropics · Apache-2.0 · https://github.com/anthropics/knowledge-work-plugins/tree/HEAD/small-business/skills/ap-processor/SKILL.md

## Similar
- [Receiptor MCP](https://affpapa.org/en/nevibecode/mcp/receiptor-mcp.md) — MCP server · 2260 installs
- [HelloBooksAIAgents](https://affpapa.org/en/nevibecode/mcp/hellobooksaiagents.md) — MCP server · 513 installs
- [tres-invoice-bill-matching](https://affpapa.org/en/nevibecode/skills/tres-invoice-bill-matching.md) — skill · ★ 4931 repo stars
- [xero](https://affpapa.org/en/nevibecode/skills/xero.md) — skill · 346 installs
- [QuickBooks Automation](https://affpapa.org/en/nevibecode/skills/quickbooks-automation.md) — skill · 4900 installs
- [DeepLedger QuickBooks MCP Server for ChatGPT, Claude & AI](https://affpapa.org/en/nevibecode/mcp/deepledger-quickbooks-mcp-server-for-chatgpt-claude-ai.md) — MCP server · ★ 1 repo stars

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
