← Back to Skills Marketplace
mehulupase01

Expense Snap

by Mehul Bhojraj Upase · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
136
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install expense-snap
Description
Capture receipt details, categorize spending, and generate monthly reports from a local SQLite ledger.
README (SKILL.md)

Expense Snap

Use this skill when the user wants to turn a receipt or spending note into structured expense data, review spending by month, or export records to CSV.

When to Use

  • Logging a new receipt from text or an image transcription.
  • Categorizing spending into consistent buckets.
  • Producing monthly summaries with budget comparisons.
  • Exporting receipts for spreadsheets or reimbursement.

Commands

The helper script stores state in {baseDir}/.runtime/expense-snap.db.

Record a receipt

python {baseDir}/scripts/expense_snap.py record --merchant "Cafe Luna" --date 2026-03-22 --total 18.40 --currency EUR --category meals --line-item "Latte|4.50|1|beverages" --line-item "Sandwich|13.90|1|meals"

List receipts

python {baseDir}/scripts/expense_snap.py list --month 2026-03 --category meals

Monthly report

python {baseDir}/scripts/expense_snap.py monthly-report --month 2026-03

Export to CSV

python {baseDir}/scripts/expense_snap.py export-csv --month 2026-03 --output {baseDir}/.runtime/march-expenses.csv

Safety Boundaries

  • Never claim receipt OCR is perfect. Mark ambiguous fields as inferred.
  • Do not fabricate line items that are not visible or provided.
  • Keep currency and totals consistent with the source receipt.
  • If an image is unreadable, explain the uncertainty instead of inventing data.
Usage Guidance
This skill appears to do what it says: run the included Python script to store receipts in a local SQLite DB at {baseDir}/.runtime/expense-snap.db and export CSVs. It does not request credentials or perform network access. Before installing, consider: run it in a safe/isolated base_dir if you have sensitive receipts (it will write files there), review the small Python source yourself if you want assurance, and ensure your agent substitutes {baseDir} to a directory you control. Note: SKILL.md mentions images/OCR, but the script only stores an image_path string and does not perform OCR or read image files. If you need encryption/backups or stricter access controls for financial data, add those protections outside this skill.
Capability Analysis
Type: OpenClaw Skill Name: expense-snap Version: 0.1.0 The expense-snap skill is a legitimate tool for managing personal finances using a local SQLite database. The Python script (scripts/expense_snap.py) uses parameterized SQL queries to prevent injection and restricts file operations to a local runtime directory and user-defined export paths. No network activity, data exfiltration, or malicious instructions were found in the code or documentation.
Capability Assessment
Purpose & Capability
Name/description match the included Python script and CLI: recording receipts, categorizing, monthly reports, and CSV export. Required binary is only python and no unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md instructs running the included Python CLI against {baseDir}; the CLI only reads/writes a local SQLite DB under {baseDir}/.runtime and CSV export files. There are no instructions to read unrelated system files, access environment secrets, or transmit data externally.
Install Mechanism
There is no install spec or remote download; the skill ships code files and expects a local python to run them. No external packages or network retrievals are performed at install time.
Credentials
The skill declares no required environment variables or credentials. The code does not access environment secrets or external auth tokens.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. It creates and updates files only within the provided base_dir (.runtime DB and any explicit export paths), which is appropriate for its purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install expense-snap
  3. After installation, invoke the skill by name or use /expense-snap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release
Metadata
Slug expense-snap
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Expense Snap?

Capture receipt details, categorize spending, and generate monthly reports from a local SQLite ledger. It is an AI Agent Skill for Claude Code / OpenClaw, with 136 downloads so far.

How do I install Expense Snap?

Run "/install expense-snap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Expense Snap free?

Yes, Expense Snap is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Expense Snap support?

Expense Snap is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Expense Snap?

It is built and maintained by Mehul Bhojraj Upase (@mehulupase01); the current version is v0.1.0.

💬 Comments