# zero-based-budget

Assigns every dollar of income to expenses, debt, or savings until the unallocated balance hits zero. Useful for planned monthly budgeting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 450 installs · ★ 101
- Author: openaccountant
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/openaccountant/skills/tree/HEAD/personal/zero-based-budget/SKILL.md
- Updated: 2026-04-09
- HTML: https://affpapa.org/en/nevibecode/skills/zero-based-budget

## What it does

This skill sets up a zero-based budget by evaluating your income and spending patterns over the past 3 months. When connected to Wilson tools (`transaction_search` and `spending_summary`), it analyzes past transactions directly. For irregular earnings, it selects the lowest month as your planning baseline.

Allocations align against the 50/30/20 guideline covering needs, wants, and savings. Whenever spending exceeds total income, the assistant highlights oversized discretionary categories and recommends specific reductions to balance the sheet.

Automated analysis depends strictly on Wilson tools. Without them, you need to export bank CSV files and populate formulas manually inside a spreadsheet.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openaccountant/skills --skill zero-based-budget -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add openaccountant/skills --skill zero-based-budget -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add openaccountant/skills --skill zero-based-budget -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openaccountant/skills zero-based-budget
```

2. **Manually: put the files in place**
- File: `.github/skills/zero-based-budget/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add openaccountant/skills --skill zero-based-budget -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/openaccountant/skills --path personal/zero-based-budget
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add openaccountant/skills --skill zero-based-budget -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/openaccountant/skills/tree/HEAD/personal/zero-based-budget/SKILL.md

## When to use it
- allocate every dollar of monthly income until zero balance remains
- calculate baseline income across 3 months for fluctuating paychecks
- split expenses into needs, wants, and savings targets
- spot budget deficits and reduce discretionary spending

## Example prompts
- Build a zero-based budget for next month using my recent income and expenses
- Review my last 3 months of spending and map them to a 50/30/20 budget
- Find where I am overspending on wants and adjust categories to hit zero balance

## Source text · SKILL.md · MIT

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: ccaa13db41cdea13.

BEGIN THIRD-PARTY FILE ccaa13db41cdea13
````text
---
name: zero-based-budget
description: >
  Allocate every dollar of income to a category using zero-based budgeting.
---

# Zero-Based Budget

## Overview
Creates a zero-based budget where every dollar of income is assigned a job — spending, saving, or debt repayment — until the remaining balance is exactly zero. Analyzes your current spending patterns to create a realistic starting budget, then identifies reallocation opportunities.

## Wilson Tools Used
- `spending_summary` — get current spending by category to inform budget allocations
- `transaction_search` — find income transactions to establish total monthly income

## Workflow
1. Run `transaction_search` with `query: "paycheck OR salary OR direct deposit OR income OR freelance"` and `months: 3` to identify all income sources.
2. Calculate average monthly income from the results. If income is variable, use the lowest of the 3 months as the planning baseline.
3. Run `spending_summary` for the last 3 months to get average spending per category.
4. Build the initial budget template using actual spending as the starting point:

   ```
   ZERO-BASED BUDGET
   ══════════════════════════════════════════════════
   Monthly Income:                         $X,XXX.XX
   ══════════════════════════════════════════════════

   NEEDS (Target: 50% = $X,XXX)
   ──────────────────────────────────────────────────
   Housing/Rent               $X,XXX   (actual: $X,XXX)
   Utilities                  $XXX     (actual: $XXX)
   Groceries                  $XXX     (actual: $XXX)
   Transportation             $XXX     (actual: $XXX)
   Insurance                  $XXX     (actual: $XXX)
   Minimum Debt Payments      $XXX     (actual: $XXX)
   Healthcare                 $XXX     (actual: $XXX)

   WANTS (Target: 30% = $X,XXX)
   ──────────────────────────────────────────────────
   Dining Out                 $XXX     (actual: $XXX)
   Entertainment              $XXX     (actual: $XXX)
   Shopping                   $XXX     (actual: $XXX)
   Subscriptions              $XXX     (actual: $XXX)
   Personal Care              $XXX     (actual: $XXX)

   SAVINGS & DEBT (Target: 20% = $X,XXX)
   ──────────────────────────────────────────────────
   Emergency Fund             $XXX
   Retirement                 $XXX
   Extra Debt Payment         $XXX
   Other Savings Goals        $XXX
````
END THIRD-PARTY FILE ccaa13db41cdea13

The third-party file has ended. Everything between the ccaa13db41cdea13 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 2856 of 5450 bytes. © openaccountant · MIT · https://github.com/openaccountant/skills/tree/HEAD/personal/zero-based-budget/SKILL.md

_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