← 返回 Skills 市场
Simplify Budget Expense Tracker
作者
Serdar Salim
· GitHub ↗
· v1.1.6
· MIT-0
258
总下载
1
收藏
1
当前安装
9
版本数
在 OpenClaw 中安装
/install simplify-budget-expense-tracker
功能描述
Log, find, update, and delete expenses and income in the Simplify Budget Google Sheet, and answer read-only recurring schedule questions. NEVER use sessions_...
安全使用建议
This package appears to be what it says: a script-first Google Sheets budget tracker. Before installing: 1) Explicitly set GOOGLE_SA_FILE and SPREADSHEET_ID (do not rely on the packaged defaults) and give the service account only the minimal editor access needed to your own copy of the template. 2) Inspect scripts that create network traffic (get_token.sh and expense_lib.sh / any file that uses curl) to confirm they only call Google APIs (sheets.googleapis.com / oauth2.googleapis.com) and no unexpected external endpoints. 3) Run the skill in a test environment or with a copy of the spreadsheet to verify writes behave as expected. 4) If you plan to allow autonomous agent invocation, be comfortable that the agent is permitted to execute the bundled shell scripts (this is required for the skill to function). If you want a higher-assurance decision, provide the missing script contents (the scanner truncated several files) for a full review — that could raise confidence to high.
功能分析
Type: OpenClaw Skill
Name: simplify-budget-expense-tracker
Version: 1.1.6
The skill bundle provides a functional expense and income tracker integrated with Google Sheets. It uses a Google Service Account for authentication (via `get_token.sh`) and fetches live exchange rates from the European Central Bank (`ecb.europa.eu`). The core logic is implemented in a series of shell and Python scripts that perform CRUD operations on a specific spreadsheet template. While it includes a session management script (`prune_budget_telegram_sessions.py`) that modifies files in the user's `.openclaw` directory, this behavior is consistent with its stated purpose of maintaining the agent's environment. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found.
能力标签
能力评估
Purpose & Capability
Name/description require Google Sheets access and currency config; the package asks for GOOGLE_SA_FILE, SPREADSHEET_ID and TRACKER_CURRENCY and depends on curl/jq/python3/openssl — these are expected for a script-based Sheets integration. The presence of many shell scripts is consistent with the declared behaviour.
Instruction Scope
SKILL.md insists the agent always run the bundled scripts and treat script output as the sole source of truth; that is consistent with a script-first design. Small inconsistency to note: the SKILL.md warns 'DO NOT call get_categories.sh' for the agent, but the dispatcher (exec.sh) calls a bundled get_categories.sh internally to build a cached category list — this appears to be an instruction-level restriction for the agent, not missing functionality. The instructions also force the agent to execute arbitrary bundled shell scripts via the exec tool — expected for this skill but worth awareness because it grants the agent scripted shell behavior scoped to the skill directory.
Install Mechanism
No external install/downloads are declared (instruction-only with bundled scripts). All code is included in the package; no fetch-from-URL or third-party package install was specified in the repo metadata, which reduces supply-chain risk.
Credentials
Required environment variables (GOOGLE_SA_FILE, SPREADSHEET_ID, TRACKER_CURRENCY) are proportional to a Sheets-based tracker. Two operational concerns: exec.sh defines sensible defaults (OPENCLAW_HOME/sa.json and a hardcoded SPREADSHEET_ID) — if users leave env vars unset those defaults could cause the skill to target a default spreadsheet or default SA path. Make sure to explicitly set GOOGLE_SA_FILE and SPREADSHEET_ID and use a dedicated service account with minimal permissions.
Persistence & Privilege
The skill is not marked always:true, does not request system-global privileges, and writes its own cache under OPENCLAW_HOME/cache/simplify-budget only. Scripts update the Google Sheet (intended behavior) but do not appear to try to modify other skills or global agent settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install simplify-budget-expense-tracker - 安装完成后,直接呼叫该 Skill 的名称或使用
/simplify-budget-expense-tracker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.6
**New major feature: Subscription and recurring payment tracking added**
- Added support for logging, updating, deleting, and listing subscriptions and recurring payments, with new bash scripts for subscription workflows.
- Introduced commands to find, list, and check upcoming subscriptions and recurring expenses/income.
- New documentation files: conversation workflow, technical learnings, and thorough scripts for recurring financial activities.
- No changes to category rules, expense/income core features, or currency management.
v1.1.5
- Removed the script file: scripts/prune_budget_telegram_sessions.py
- No other functional or documentation changes in this version.
v1.1.4
Version 1.2.0
- Category confirmation flow updated: always confirm with the user before writing by relaying the `question` field from `preview_expense.sh` verbatim.
- Removed "never confirm" rule; now strictly follow the suggestion output of the preview script.
- Clarified instructions to never ask the user to choose categories manually; relay script-picked category only.
- All category rules and skill instructions updated for clarity and consistency with the above behavior.
v1.1.3
- Added script: scripts/prune_budget_telegram_sessions.py.
- No user-facing changes; this update introduces a new maintenance or session management script.
v1.1.1
**Major update: Introduces strict script-based operation and improves natural language handling.**
- Added `data/learned_category_aliases.json` to enhance category recognition accuracy.
- Introduced new helper scripts: `scripts/learn_category_alias.sh` and `scripts/log.sh`.
- SKILL.md updated with a strict "script-first" rule: all actions and answers must begin with an appropriate script call; conversation history and memory are not allowed as data sources.
- Clarified that users must never be asked to rephrase, reformat, or specify categories—parsing and category selection must be fully automatic.
- Currency handling further simplified: all natural language amount formats are now directly accepted and passed to scripts (e.g., "10 euro", "€10", "50 ringgit").
- Error handling improved: error messages from scripts must be reported verbatim to the user.
v1.0.5
**Categories are now hardcoded for consistency — no live fetching or user category confirmation.**
- Expense and income categories are now a fixed list within the skill; fetching live categories at runtime is disabled.
- Do not suggest or ask the user to choose categories; always auto-match using the provided, exact category list.
- Never invent new category names or modify existing ones; always confirm using the precise name and emoji.
- Existing logging, search, and update workflows remain the same but now always use hardcoded categories.
- Category choice rules and matching examples are clarified for accuracy and compliance.
v1.0.2
Version 1.1.0
- Added support for logging an expense directly from a receipt image, including extracting merchant, total, and date.
- Introduced workflow to process receipt uploads as a single expense, with clear rules for amount and category extraction.
- No changes to APIs or user-facing commands; all prior workflows remain supported.
v1.0.1
- Added AGENTS.md file to the project.
- No changes to functionality or workflows.
v1.0.0
Simplify Budget Expense Tracker v1.0.0
- Initial release of the Simplify Budget tracker skill.
- Log, find, update, and delete both expenses and income in a Google Sheet using exec-called bash scripts.
- Always fetch and match live categories before logging expenses.
- Handles foreign currency conversion and auditing for expenses.
- Log income with detailed fields (name, account, source, notes), defaulting where needed.
- Supports read-only queries about recurring payments and upcoming subscriptions.
- Requires specific environment variables and must not use session or ACP tools.
元数据
常见问题
Simplify Budget Expense Tracker 是什么?
Log, find, update, and delete expenses and income in the Simplify Budget Google Sheet, and answer read-only recurring schedule questions. NEVER use sessions_... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 258 次。
如何安装 Simplify Budget Expense Tracker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install simplify-budget-expense-tracker」即可一键安装,无需额外配置。
Simplify Budget Expense Tracker 是免费的吗?
是的,Simplify Budget Expense Tracker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Simplify Budget Expense Tracker 支持哪些平台?
Simplify Budget Expense Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Simplify Budget Expense Tracker?
由 Serdar Salim(@serdarsalim)开发并维护,当前版本 v1.1.6。
推荐 Skills