Skill: ivangdavila/expenses (version 1.0.0)

--- name: Expenses description: Build a personal expense tracking system for daily spending, shared costs, business expenses, and project budgets. metadata: {"clawdbot":{"emoji":"💸","os":["linux","darwin","win32"]}} --- ## 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)