← Back to Skills Marketplace
423
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install budget-pro
Description
Personal budget management with privacy-first local storage. Use when user mentions setting a budget, tracking spending, logging expenses, checking budget st...
README (SKILL.md)
Budget
Personal budgeting system with proactive tracking. Private. Simple. Effective.
Critical Privacy & Safety
Data Storage (CRITICAL)
- All budget data stored locally only:
memory/budget/ - No external APIs for financial data
- No bank account connections - manual entry only
- No data transmission to financial apps or services
- User controls all data retention and deletion
Safety Boundaries (NON-NEGOTIABLE)
- ✅ Track expenses by category with manual entry
- ✅ Alert on budget thresholds (70%, 90%, 100%)
- ✅ Generate reports and spending insights
- ✅ Suggest reallocation between categories
- ❌ NEVER connect to bank accounts or credit cards
- ❌ NEVER access external financial services
- ❌ NEVER make financial recommendations beyond budget reallocation
- ❌ NEVER store sensitive financial credentials
Quick Start
Data Storage Setup
Budget data stored in your local workspace:
memory/budget/budget.json- Monthly budget limits by categorymemory/budget/expenses.json- All logged expensesmemory/budget/income.json- Income sourcesmemory/budget/reports/- Generated reports and digests
Use provided scripts in scripts/ for all data operations.
Core Workflows
Set Budget
User: "My food budget is $500 per month"
→ Use scripts/set_budget.py --category food --limit 500 --period monthly
→ Store budget limit
Log Expense
User: "I spent $45 on groceries"
→ Use scripts/log_expense.py --amount 45 --category food --description "groceries"
→ Check against budget, alert if thresholds crossed
Check Budget Status
User: "How is my budget this month?"
→ Use scripts/budget_status.py --period month
→ Show all categories with spent/remaining/status
Category Query
User: "What can I still spend on dining?"
→ Use scripts/category_status.py --category dining
→ Show remaining budget for specific category
Handle Overage
User: "I went over on entertainment"
→ Use scripts/overage_analysis.py --category entertainment
→ Show overage amount and suggest recovery options
Generate Report
User: "Show me my spending report"
→ Use scripts/generate_report.py --type weekly
→ Generate detailed spending analysis
Module Reference
For detailed implementation of each module:
- Budget Setup: See references/budget-setup.md
- Expense Tracking: See references/expense-tracking.md
- Alerts & Thresholds: See references/alerts.md
- Reports & Analysis: See references/reports.md
- Overage Recovery: See references/overage-recovery.md
Scripts Reference
All data operations use scripts in scripts/:
| Script | Purpose |
|---|---|
set_budget.py |
Set or update budget for category |
log_expense.py |
Log an expense |
delete_expense.py |
Remove/correct an expense |
budget_status.py |
Show overall budget health |
category_status.py |
Show specific category status |
list_expenses.py |
View expense history |
overage_analysis.py |
Analyze and suggest recovery for overages |
reallocate_budget.py |
Move budget between categories |
generate_report.py |
Generate spending reports |
export_data.py |
Export budget data (CSV/JSON) |
Default Categories
| Category | Typical Budget | Common Expenses |
|---|---|---|
| Housing | 25-35% income | Rent, mortgage, insurance |
| Food | 10-15% income | Groceries, dining out |
| Transport | 10-15% income | Gas, transit, maintenance |
| Utilities | 5-10% income | Electric, gas, internet, phone |
| Entertainment | 5-10% income | Movies, hobbies, subscriptions |
| Health | 5-10% income | Insurance, medical, gym |
| Shopping | 5-10% income | Clothing, household items |
| Savings | 10-20% income | Emergency fund, investments |
Custom categories can be added as needed.
Disclaimer
This skill provides budget tracking and organization only. It does not provide financial advice, investment recommendations, or tax guidance. For financial planning, consult a qualified financial advisor.
Usage Guidance
This skill mostly looks like a local, privacy-first budgeting tool: scripts read and write JSON files under ~/.openclaw/workspace/memory/budget and there are no network calls or credential requests. However, the SKILL.md repeatedly references many scripts and features that are not included in the package (reports, exports, alert scripts, category_status/overage_analysis/generate_report/export_data, etc.). Before installing or using it: 1) ask the publisher why those referenced scripts are missing or request a complete release; 2) inspect any additional scripts before running them; 3) be aware the provided scripts write to ~/.openclaw/workspace/memory/budget — back up any existing data there and confirm you are comfortable with that path; 4) run the code in an isolated environment (or sandbox) if you want to test; and 5) if you need the missing features, require the author to supply them or update the documentation. The mismatch between documentation and included code is the main reason this is flagged as suspicious rather than benign.
Capability Analysis
Type: OpenClaw Skill
Name: budget-pro
Version: 2.1.0
The budget-pro skill is a local financial tracking tool that manages expenses and budgets using JSON files stored in the user's workspace. Analysis of the Python scripts (such as log_expense.py and set_budget.py) shows they only use standard libraries for file I/O and lack any network capabilities or access to sensitive system credentials. The SKILL.md instructions include explicit safety boundaries that reinforce local-only storage and prohibit external financial connections, aligning perfectly with the stated purpose.
Capability Assessment
Purpose & Capability
The stated purpose (local, privacy-first budget management) aligns with the files provided: the scripts read/write JSON under a local workspace path and include budget/expense operations. However, the SKILL.md advertises many additional scripts and features (category_status.py, overage_analysis.py, generate_report.py, export_data.py, alert management scripts, etc.) that are referenced in documentation but are not present in the file manifest. This is an inconsistency between claimed capabilities and included code.
Instruction Scope
SKILL.md directs the agent to run many scripts and shows workflows that rely on scripts that don't exist in the package. The instructions otherwise confine operations to local storage and do not instruct any network or credential access; the included scripts operate only on local JSON files under ~/.openclaw/workspace/memory/budget. Missing script references give the agent broad but unfulfilled expectations and could lead to runtime errors or unintended fallbacks.
Install Mechanism
There is no install spec (instruction-only), which minimizes risk because nothing is downloaded or installed automatically. All code present is plain Python scripts that would be executed locally if invoked.
Credentials
The skill requests no environment variables, no credentials, and the scripts do not access external config or secret stores. They create/read/write files under a user-scoped path (~/.openclaw/workspace/memory/budget), which is proportional for a local budgeting tool.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. Its persistence is limited to storing JSON under the user's workspace directory; this is expected for a local data-focused tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install budget-pro - After installation, invoke the skill by name or use
/budget-pro - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
- Skill renamed from "budget" to "budget-pro" for clarity and distinction.
- No changes to features, privacy model, or workflows.
- All documentation, script usage, and data structure remain the same.
- Existing users do not need to change how they use the skill.
v2.0.0
Major update: Restructured with progressive disclosure, added executable scripts, explicit privacy boundaries, comprehensive budget management workflows
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Budget?
Personal budget management with privacy-first local storage. Use when user mentions setting a budget, tracking spending, logging expenses, checking budget st... It is an AI Agent Skill for Claude Code / OpenClaw, with 423 downloads so far.
How do I install Budget?
Run "/install budget-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Budget free?
Yes, Budget is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Budget support?
Budget is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Budget?
It is built and maintained by AGIstack (@agistack); the current version is v2.1.0.
More Skills