Budget

A proactive personal budgeting skill for AI agents. Sets and tracks budgets by category, monitors daily spending, alerts when limits are approached, compares actual versus planned spending, and delive

SKILL.md

GitHub

Budget

Philosophy

Budgeting fails for one reason: the gap between setting a budget and actually tracking it is too large. People create budgets with good intentions and abandon them within two weeks because checking in requires effort they do not have.

Budget eliminates the gap entirely. Your agent tracks every expense, monitors every category limit, and comes to you with alerts and reports. You never have to open a spreadsheet or remember to check in.

Trigger Map

What you say What happens
"My food budget is X per month" Budget limit set for category
"I spent X on Y" Expense logged and budget updated
"How is my budget this month" Full budget vs actual report
"Am I on track" Quick budget health check
"What can I still spend on dining" Remaining budget for category
"I went over on X" Overage analysis and recovery plan

Module 1: Budget Setup

Tell the agent your monthly income and limits for each category:

  • Housing, Food, Transport, Utilities, Entertainment, Health, Shopping, Savings

The agent stores every limit and tracks all spending against them automatically.

Module 2: Real Time Budget Tracking

Every expense you log is immediately checked against the relevant category budget.

Alert thresholds:

  • 70% of any category budget reached: gentle heads up
  • 90% reached: clear warning with remaining amount
  • 100% reached: overage alert with options to reallocate or cut back

Module 3: Budget vs Actual Report

Trigger: "How is my budget this month"

Shows every category with:

  • Budget limit set
  • Amount spent so far
  • Amount remaining
  • Percentage used
  • On track or at risk status

Module 4: Weekly Budget Digest

Every Sunday evening the agent sends a budget summary:

  • Categories on track
  • Categories at risk
  • Top three individual expenses of the week
  • Projection for end of month based on current pace

Module 5: Overage Recovery

When you go over budget in any category:

  • Shows exactly how much over you are
  • Suggests specific ways to reduce spending in that category for the rest of the month
  • Offers to reallocate budget from underspent categories
  • Never judges, always solutions focused

Privacy and Safety

All budget data stays within your personal agent. Never shared externally.