SkillHub

expenses

v1.0.0

Build a personal expense tracking system for daily spending, shared costs, business expenses, and project budgets.

Sourced from ClawHub, Authored by Iván

Installation

Please help me install the skill `expenses` from SkillHub official store. npx skills add ivangdavila/expenses

Core Behavior

  • User mentions spending money → offer to log expense
  • Different contexts need different tracking → adapt to their use case
  • Surface patterns when asked → where is money going?
  • Create ~/expenses/ as workspace

Use Case Discovery

Ask how they'll use expense tracking: - Personal spending: "where does my money go?" - Shared costs: roommates, couples, group trips - Business/freelance: billable expenses, tax deductions - Work reimbursement: expenses to claim from employer - Project budget: renovation, wedding, specific goal - Travel: trip-specific spending

Expense Entry Basics

  • Amount and currency
  • Date
  • What: brief description
  • Category: food, transport, entertainment, etc.
  • Payment method: cash, card, account (optional)
  • Receipt photo if needed

Personal Spending

Track to understand patterns: - Categories that matter to you - Weekly/monthly totals by category - Trends over time: spending more on dining out? - No judgment — awareness is the goal

Shared Expenses

Track who paid, who owes: - Expense + who paid + split between whom - Running balance: who owes whom how much - Settle up periodically: "I owe you €45" - Handle unequal splits: 60/40, by item

Business Expenses

Track for billing or taxes: - Client/project attribution - Billable vs non-billable - Receipt storage critical — link or embed - Category for tax deduction type - Mileage if applicable

Work Reimbursement

Track what employer owes you: - Status: pending, submitted, reimbursed - Submission date - Receipt attached - Reimbursement received date - Monthly report generation

Project Budget

Track spending against a budget: - Project: kitchen renovation, wedding, vacation - Budget amount set upfront - Running total vs budget: "€3,400 of €10,000 spent" - Category breakdown within project - Flag when approaching limit

Travel Expenses

Trip-specific tracking: - All expenses tagged to trip - Daily spending if relevant - By category: lodging, food, activities, transport - Currency conversion if international - Per-person if group travel - Post-trip summary

File Structure

~/expenses/
├── daily/
│   └── 2024-03.md
├── shared/
│   └── roommates.md
├── business/
│   └── 2024-q1.md
├── trips/
│   └── japan-2024.md
├── projects/
│   └── kitchen-reno.md
└── categories.md

Category System

  • Keep categories broad: 10-15 max
  • Common: food, transport, housing, utilities, entertainment, health, shopping
  • Customize to what matters: "coffee" separate if tracking that
  • Consistent naming — "restaurants" not sometimes "dining"

Entry Formats

Quick daily: "€45 groceries" Detailed: amount, date, category, description, receipt Shared: amount, paid by, split between, category Business: amount, client, category, receipt, billable

What To Surface

  • "You've spent €X this month on dining"
  • "Coffee spending up 40% vs last month"
  • "John owes you €89 from shared expenses"
  • "Kitchen project: €2,100 remaining in budget"
  • "€450 in unreimbursed work expenses"

Progressive Enhancement

  • Week 1: log expenses as they happen
  • Week 2: add categories, see patterns
  • Month 2: compare months, spot trends
  • Ongoing: adjust categories to what's useful

Receipt Management

  • Photo immediately — paper receipts fade
  • Link to expense entry
  • Store in expense folder or dedicated receipts folder
  • Filename: date-vendor-amount.jpg
  • Business expenses: retention period awareness

Reporting

  • Monthly summary by category
  • Trend comparison: this month vs last
  • Shared: balance summary, settlement suggestion
  • Business: quarterly for taxes
  • Project: spend vs budget status

What NOT To Suggest

  • Complex budgeting before spending is tracked
  • Linking bank accounts — manual has value
  • Obsessive categorization — broad categories work
  • Guilt about spending — data, not judgment

Multi-Currency

  • Log in currency spent
  • Note exchange rate if tracking
  • Convert for totals if needed
  • Travel especially: mixed currencies normal

Integration Points

  • Budget: expenses feed into budget tracking
  • Invoices: billable expenses to clients
  • Taxes: business expense categories
  • Trips: travel-specific tracking