| name | expense-categorization |
| title | Expense categorization |
| description | Assign transactions to tax-aligned expense categories using vendor name, line items, and amount patterns. Handles ambiguous vendors like Amazon by inspecting line-item detail from the receipt source. Supports split categorization and learns from user corrections. Trigger on "categorize expenses", "sort transactions", "assign expense categories", "what category is this". |
| license | MIT |
| compatibility | Designed for skills-compatible agents with network access and access to receipt data, spreadsheets, or accounting exports. |
| metadata | {"version":"3.0","execution-mode":"semi-automated"} |
| allowed-tools | Read Write Edit WebFetch |
| publishDate | "2026-03-24T00:00:00.000Z" |
| updatedDate | "2026-03-24T00:00:00.000Z" |
| tags | ["expenses","categories","skill","tax"] |
| featured | false |
Expense Categorization
Assign every transaction to the correct expense category so it flows to the right line on a tax return, produces accurate financial statements, and survives an audit.
Read these when needed
- Read references/DECISION-RULES.md when deciding whether a category is safe to auto-assign or should go to review.
- Run
scripts/category_review_summary.py when you already have categorized records and need a deterministic summary by confidence, category, and review status.
Why categorization matters
The IRS doesn't audit "total expenses." It audits individual line items on Schedule C (or the equivalent form for your entity type). A business that lumps everything into "Other Expenses" invites scrutiny. Proper categorization also reveals spending patterns — you can't cut costs you can't see.
For the full Schedule C line-by-line reference (Lines 8–27a with what belongs and what doesn't), see the schedule-c-categories skill.
Categorization logic
Primary signal: vendor name
Most categorization comes from the vendor name alone. Use the mapping table below to auto-categorize high-confidence vendors.
Secondary signal: line items
When the vendor is ambiguous (Amazon, Walmart, Costco), look at line items from the receipt. This is where high-quality extraction is especially useful — line items matter more than totals. Amazon with "USB-C Hub, Monitor Stand" → Equipment. Amazon with "Paper Towels, Hand Soap" → Office Supplies. Mixed orders should be split across categories.
Tertiary signal: amount patterns
Recurring monthly charges at the same amount → likely Software & Subscriptions (Line 27a). Round-number transfers to individuals → likely Contractors (Line 11). Small charges at restaurants → Meals (Line 24b).
Learning from corrections
When the user corrects a categorization, store that mapping. User-confirmed mappings should override default logic going forward.
High-confidence vendor mapping (auto-categorize)
| Vendor pattern | Category | Schedule C Line |
|---|
| Google Ads, Meta Ads, LinkedIn Ads, Twitter/X Ads | Advertising | 8 |
| Shell, Chevron, BP, ExxonMobil | Car and truck | 9 |
| Uber, Lyft (ride) | Travel | 24a |
| Uber Eats, DoorDash, Grubhub | Meals | 24b |
| Upwork, Fiverr, Toptal | Contract labor | 11 |
| LegalZoom, lawyer names | Legal/professional | 17 |
| Staples, Office Depot | Office expense | 18 |
| WeWork, Regus, Industrious | Rent — business property | 20b |
| United, Delta, American, Southwest, JetBlue | Travel | 24a |
| Marriott, Hilton, Hyatt, Airbnb | Travel | 24a |
| AT&T, Verizon, T-Mobile, Comcast, Spectrum | Utilities | 25 |
| AWS, Google Cloud, Azure, DigitalOcean | Other (cloud hosting) | 27a |
| Slack, Notion, Figma, Adobe, Zoom, GitHub | Other (software) | 27a |
| Stripe, Square, PayPal (fees) | Other (processing) | 27a |
| QuickBooks, Xero, FreshBooks | Legal/professional | 17 |
Ambiguous vendors (require line-item inspection)
Amazon — Could be office supplies, equipment, software, books, inventory, personal items. If line items were extracted, categorize each item separately. "USB-C Hub" → Equipment. "Printer Paper" → Office. "Python Crash Course" → Education. Without line items, flag for user review.
Walmart / Target / Costco — Same problem. Could be office supplies, breakroom supplies, or personal. Always ask.
Apple — Could be equipment (MacBook, iPad), software (App Store), or subscription (iCloud, Apple One). Amount helps: $999+ is likely hardware → Depreciation (Line 13). $0.99–$14.99 is likely apps/subscriptions → Other (Line 27a).
PayPal / Stripe / Square — The charge description is often the underlying vendor. "PayPal *ACME CORP" → look up ACME CORP. If only "PayPal" appears, flag for review. Processing fees are separate from the underlying purchases.
Split categorization
A single receipt can span multiple categories. This is common and correct:
Example: Amazon order for $347.82 containing: monitor stand ($89.99) → Equipment/Depreciation, printer paper 5-ream ($42.99) → Office, Python textbook ($54.95) → Education/Other, HDMI cables 3-pack ($19.89) → Equipment, break room coffee ($34.00) → Supplies, personal items ($106.00) → NOT DEDUCTIBLE.
Each line item gets its own category. The total must equal the sum of categorized amounts. Personal items must be excluded entirely.
Confidence scoring
Assign a confidence level to every categorization:
High — Unambiguous vendor (Google Ads → Advertising), or user has previously confirmed this mapping. Auto-categorize without review.
Medium — Reasonable inference from vendor + amount pattern, but could be wrong. Include in batch review.
Low — Ambiguous vendor, no line items, unusual amount. Must be reviewed.
User-confirmed — User explicitly approved or corrected this. Highest confidence. Store for future use.
Common categorization mistakes
Software in Office Expense. Office (Line 18) is for physical supplies. Software subscriptions go in Other (Line 27a). The IRS has benchmarks — $50K in "Office Supplies" looks abnormal.
Mixing travel and meals. Hotel is Travel (24a). Dinner during the trip is Meals (24b) at 50%. Different lines, different deductibility.
Owner health insurance on Schedule C. Goes on Form 1040 Line 17, not Schedule C. Putting it on Schedule C incorrectly reduces self-employment tax.
Expensing equipment over $2,500. Must be depreciated or Section 179'd (Line 13). See the depreciation-assets skill.
Deducting fines and penalties. Government fines are never deductible. Not even during business activity.
Treating reimbursed expenses as deductions. Client reimbursements are income; the expense is a deduction. They net out — don't deduct without recording the reimbursement.
Non-US jurisdictions
The Schedule C mapping is US-specific. Other frameworks:
UK (Self Assessment): Similar categories, different terminology. VAT-registered businesses track VAT rate (20%, 5%, zero, exempt) per transaction.
Canada (T2125): Similar to Schedule C. GST/HST input tax credits require tracking tax paid on purchases.
EU (VAT): Input VAT offsets Output VAT. Entertainment is typically non-deductible for VAT in many EU countries.
Australia (BAS): 10% GST on most business purchases is claimable as an input tax credit.
Ask the user for their jurisdiction before applying categories.
Output
Return categorized transactions with: date, vendor, description, amount, currency, category, Schedule C line (or equivalent), confidence level, and notes. Group by category. Flag Low-confidence items at top.
Include a summary:
Transactions categorized: 156
High confidence: 112 (72%)
Medium confidence: 28 (18%)
Low confidence: 9 (6%)
User-confirmed: 7 (4%)
Split transactions: 4
Uncategorized / needs review: 9
Top category by spend: Software & Subscriptions — $4,230.00
Potential personal expenses flagged: 3
Related skills
- schedule-c-categories — Full line-by-line reference for every Schedule C category
- meals-deduction — Detailed rules for meal deductibility and required documentation
- depreciation-assets — When to expense vs. capitalize, Section 179, bonus depreciation
- home-office — Simplified and actual methods for the home office deduction
- contractor-1099 — Tracking contractor payments and 1099 filing requirements
Agent metadata
skill: expense-categorization
version: 3.0
input: transaction list (from receipt-processing or bank statement)
output: categorized transaction table with Schedule C line mapping
dependencies:
- receipt-processing (recommended for line-item data)
next_steps:
- bank-reconciliation
- tax-prep
