← Back to Skills Marketplace
Smart Ledger
by
dyby99-gif
· GitHub ↗
· v1.0.0
299
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install smart-ledger
Description
智能收支追踪器 — 通过自然语言快速记账，自动分类，生成日/周/月报告和趋势分析。 支持中文自然语言输入("今天午饭花了35元")，数据本地JSON存储保护隐私。 适用于个人财务管理、预算追踪和消费分析场景。
Usage Guidance
This package appears to be a local-only expense tracker and is coherent with its description. Before installing or running: 1) Confirm you have Python 3.9+ available (SKILL.md requires it). 2) Review the full scripts (especially the truncated sections provided) yourself to verify there are truly no network calls or unexpected subprocess usage. 3) Back up any existing data in ~/.openclaw/workspace/data/expenses/expenses.json before first run. 4) If you store sensitive financial details, consider encrypting the JSON or keeping backups offline. 5) Run the scripts in an isolated environment (local user account or sandbox) if you are uncertain about the origin of the package.
Capability Analysis
Type: OpenClaw Skill
Name: smart-ledger
Version: 1.0.0
The OpenClaw AgentSkills skill bundle 'smart-ledger' is classified as benign. The code in `scripts/expense-tracker.py` and `scripts/report-generator.py` implements a local expense tracker with natural language parsing and reporting, storing data in `~/.openclaw/workspace/data/expenses/expenses.json`. There is no evidence of malicious intent, such as data exfiltration (no network calls), unauthorized execution, or persistence mechanisms. The `SKILL.md` provides clear usage instructions without any prompt injection attempts against the AI agent. The code also includes good security practices like atomic file writes and attempts to set strict file permissions for user data.
Capability Assessment
Purpose & Capability
Name/description (natural-language expense tracking, local JSON storage, reports) match the provided code and SKILL.md. The code implements parsing, categorization, persistence, and reporting which align with the stated purpose. Minor metadata mismatch: the registry excerpt lists 'Required binaries: none' while SKILL.md declares 'python: >=3.9' — requiring Python is reasonable for this skill, but the registry metadata should reflect that.
Instruction Scope
Runtime instructions and the scripts operate on local files only (the data path is ~/.openclaw/workspace/data/expenses/expenses.json and assets/categories.json). The SKILL.md and code instruct reading/writing that file and editing local config; there are no instructions to read unrelated system files, access credentials, or transmit data externally. (Note: some file contents in the provided package listing were truncated; no evidence of network/endpoints was visible in the parts provided.)
Install Mechanism
No install spec included — instruction-only with bundled Python scripts and a JSON asset. Nothing is downloaded or executed from remote URLs. The scripts use only Python standard library features (json, pathlib, tempfile, etc.), so no external package install is required.
Credentials
The skill requests no environment variables or external credentials and stores data locally. This is proportionate to a personal expense tracker. It attempts to set restrictive file permissions for privacy (chmod), which is appropriate. There are no unrelated credential requests.
Persistence & Privilege
The skill does not set always:true and is user-invocable only. It persists its own data under a dedicated workspace path and does not modify system-level or other-skill configuration. Attempted file-permission tightening is scoped to its data directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smart-ledger - After installation, invoke the skill by name or use
/smart-ledger - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Smart-ledger 1.0.0 – Initial release
- Track expenses and income via natural language input (Chinese/English), e.g. “今天午饭花了35元”.
- Automatic classification of transactions (餐饮, 交通, 购物, etc.).
- Generate daily, weekly, monthly financial reports and trend analysis.
- Local JSON data storage to protect user privacy.
- CLI for adding, listing, summarizing, or deleting records; output supports both human-readable and JSON formats.
- Configurable categories and keyword mapping for custom classification and budget alerts.
Metadata
Frequently Asked Questions
What is Smart Ledger?
智能收支追踪器 — 通过自然语言快速记账，自动分类，生成日/周/月报告和趋势分析。 支持中文自然语言输入("今天午饭花了35元")，数据本地JSON存储保护隐私。 适用于个人财务管理、预算追踪和消费分析场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.
How do I install Smart Ledger?
Run "/install smart-ledger" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Smart Ledger free?
Yes, Smart Ledger is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Smart Ledger support?
Smart Ledger is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Smart Ledger?
It is built and maintained by dyby99-gif (@dyby99-gif); the current version is v1.0.0.
More Skills