# Send Expense Tracker to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aholake-expense-tracker",
    "name": "Expense Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/aholake/aholake-expense-tracker",
    "canonicalUrl": "https://clawhub.ai/aholake/aholake-expense-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/aholake-expense-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aholake-expense-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/categories.md",
      "scripts/log_expense.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/aholake-expense-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aholake-expense-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/aholake-expense-tracker",
    "agentUrl": "https://openagent3.xyz/skills/aholake-expense-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aholake-expense-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aholake-expense-tracker/agent.md"
  }
}
```
## Documentation

### Expense Tracker

Log and track daily expenses in markdown files organized by month.

### Log an expense

python3 scripts/log_expense.py log <amount> <category> [--description "text"] [--tags "tag1,tag2"] [--date YYYY-MM-DD]

Examples:

# Simple expense
python3 scripts/log_expense.py log 45000 Coffee

# With description
python3 scripts/log_expense.py log 250000 Dining --description "Lunch with team"

# With tags
python3 scripts/log_expense.py log 500000 Shopping --tags "clothes,sale" --description "New shirt"

# Specify date (for backdating)
python3 scripts/log_expense.py log 1200000 Vehicle --description "Gas" --date 2026-02-15

### View monthly summary

# Current month
python3 scripts/log_expense.py summary

# Specific month
python3 scripts/log_expense.py summary 2026-02

# JSON output (for parsing)
python3 scripts/log_expense.py summary 2026-02 --json

### File Organization

Expenses are stored in expenses/ directory at workspace root:

expenses/
├── 2026-01.md
├── 2026-02.md
└── 2026-03.md

Each file contains a markdown table:

# Expenses - 2026-02

| Date | Category | Amount (VND) | Description | Tags |
|------|----------|-------------|-------------|------|
| 2026-02-17 | Coffee | 45,000 | | |
| 2026-02-17 | Dining | 250,000 | Lunch with team | |
| 2026-02-17 | Shopping | 500,000 | New shirt | clothes,sale |

### Categories

See references/categories.md for common expense categories. Use existing categories or create custom ones as needed.

Common categories:

Housing - Rent, utilities, home expenses
Vehicle - Gas, maintenance, parking
Dining - Restaurants, food delivery
Coffee - Cafes, coffee shops
Shopping - Clothes, electronics, general purchases
Entertainment - Movies, games, hobbies
Healthcare - Medicine, doctor visits
Subscriptions - Netflix, Spotify, gym, apps
Savings - Investments, emergency fund
Debt Payment - Loans, credit cards
Miscellaneous - Other expenses

### Log daily expenses from conversation

When the user mentions spending money:

# User: "Just paid 35k for coffee"
python3 scripts/log_expense.py log 35000 Coffee

# User: "Grabbed lunch for 120k at Phở 24"
python3 scripts/log_expense.py log 120000 Dining --description "Phở 24"

# User: "Filled up gas, 400k"
python3 scripts/log_expense.py log 400000 Vehicle --description "Gas"

### Monthly review

# Get summary
python3 scripts/log_expense.py summary 2026-02

# Read the expense file to see details
cat expenses/2026-02.md

### Analyze spending patterns

# Get JSON for analysis
python3 scripts/log_expense.py summary 2026-02 --json

# Compare multiple months
python3 scripts/log_expense.py summary 2026-01 --json > jan.json
python3 scripts/log_expense.py summary 2026-02 --json > feb.json

### Tips

Batch logging: User can tell you multiple expenses at once, log them all
Category consistency: Use the same category names to enable accurate summaries
Tags for filtering: Use tags for subcategories (e.g., "work", "weekend", "urgent")
Descriptions: Add context that helps identify the expense later
Regular reviews: Suggest monthly summaries to track spending patterns

### Integration with Financial Goals

When tracking expenses, consider:

Budget tracking: Compare monthly totals to target budget
Spending patterns: Identify high-spend categories
Emergency fund: Track savings progress
Debt reduction: Monitor debt payment progress
Financial ratios: Calculate expenses as % of income

### log_expense.py

Commands:

log - Add an expense entry
summary - View monthly summary

Arguments (log):

amount - Amount in VND (required)
category - Category name (required)
--description/-d - Optional description
--tags/-t - Optional comma-separated tags
--date - Optional date (YYYY-MM-DD, defaults to today)
--workspace - Optional workspace path (defaults to ~/.openclaw/workspace)

Arguments (summary):

year_month - Optional YYYY-MM (defaults to current month)
--json - Output as JSON
--workspace - Optional workspace path

Output:

Creates/updates markdown files in expenses/ directory
Prints confirmation with file location
Summary shows total, count, and breakdown by category
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: aholake
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/aholake-expense-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/aholake-expense-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/aholake-expense-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/aholake-expense-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/aholake-expense-tracker)