← Back to Skills Marketplace
232
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nl2ledger
Description
Natural language bookkeeping — parse Chinese/English expense descriptions and append to QianJi CSV. Trigger phrases: 记账, 记一笔, add expense, spent, 花了, 买了, lun...
Usage Guidance
This skill appears coherent and operates locally: it finds a QianJi_*.csv in your project root, shows a preview, and only writes after you confirm. Before installing or using it: 1) Ensure you have a backup of your ledger CSV (the script appends rows in-place). 2) Verify the CSV file the skill picks (pattern-based selection could pick the wrong file); if none is found, provide the correct path. 3) Pay attention to special rules in references/category_map.md (e.g., 桑拿/按摩 entries force 账户1=金色印象 and a default amount of 206.0) — these are policy choices that may create unexpected entries if you don't review the preview. 4) The script does not send data over the network and requires only python3; confirm python3 is available. 5) If you create a new CSV, ensure encoding/BOM expectations match your workflow (the schema mentions a UTF-8 BOM at the start). If you want stronger safety, manually inspect the preview before confirming each write or test the skill on a copy of your CSV first.
Capability Analysis
Type: OpenClaw Skill
Name: nl2ledger
Version: 1.0.0
The nl2ledger skill is a legitimate bookkeeping tool designed to parse natural language spending descriptions into a structured CSV format. The core logic in `scripts/append_entry.py` uses standard Python libraries to safely append data to a local file, and the `SKILL.md` instructions explicitly mandate a user confirmation step before any write operations occur.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), included script, and referenced mapping/schema files all align with a local CSV bookkeeping helper. There are no unexpected credentials, network endpoints, or unrelated system resources requested.
Instruction Scope
SKILL.md limits actions to locating QianJi_*.csv in the project root, parsing the user's text, asking for clarification when needed, showing a preview, and running the local append script only after explicit user confirmation. It does not instruct reading other unrelated files, environment variables, or sending data externally.
Install Mechanism
No install spec (instruction-only) and the included script is a simple Python file; nothing is downloaded or installed from external URLs. Low install risk.
Credentials
No environment variables or credentials requested. The skill only needs filesystem access to find and append to a CSV, which is appropriate for its purpose.
Persistence & Privilege
always is false and the skill does not request permanent/system-wide presence or modify other skills. The agent will only write to the CSV after explicit user confirmation per the instructions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nl2ledger - After installation, invoke the skill by name or use
/nl2ledger - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is nl2ledger?
Natural language bookkeeping — parse Chinese/English expense descriptions and append to QianJi CSV. Trigger phrases: 记账, 记一笔, add expense, spent, 花了, 买了, lun... It is an AI Agent Skill for Claude Code / OpenClaw, with 232 downloads so far.
How do I install nl2ledger?
Run "/install nl2ledger" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is nl2ledger free?
Yes, nl2ledger is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does nl2ledger support?
nl2ledger is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created nl2ledger?
It is built and maintained by Rainman (@deusyu); the current version is v1.0.0.
More Skills