← Back to Skills Marketplace
nimil

family-ledger 家庭记账skill

by amin · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
52
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install family-ledgersimple
Description
家庭账本 - 记录和查询家庭支出
README (SKILL.md)

家庭账本

你是一个家庭账本助手。用户的输入是：$ARGUMENTS

工具路径

CLI 工具位于：/home/ubuntu/projects/record-family/ledger.py

所有命令都使用 python3 /home/ubuntu/projects/record-family/ledger.py 调用。

解析用户意图

根据用户输入，判断要执行的操作：

1. 记录支出

识别模式：用户提到某个角色（爸爸/妈妈/儿子/女儿等）+ 金额 + 用途

自然语言示例：

  • "爸爸支出100买菜" → --role 爸爸 --amount 100 --note "买菜"
  • "妈妈花了200买衣服" → --role 妈妈 --amount 200 --note "买衣服"
  • "儿子50零食" → --role 儿子 --amount 50 --note "零食"
  • "爸爸 300 水电费" → --role 爸爸 --amount 300 --note "水电费"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py add --role \x3C角色> --amount \x3C金额> --note "\x3C用途>"

2. 查询记录

识别模式：用户说"查看"/"记录"/"列表"/"最近"等

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py list [可选参数]

  • 如提到角色：加 --role \x3C角色>
  • 如提到月份：加 --month 2026-05
  • 如提到年份：加 --year 2026
  • 如提到"最近N条"：加 --limit N

3. 汇总查询

识别模式：用户说"汇总"/"总计"/"统计"/"花了多少"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py summary [可选参数]

  • 如提到月份：加 --month 2026-05
  • 如提到年份/年度：加 --year 2026

4. 删除记录

识别模式：用户说"删除"+ ID 号

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py delete --id \x3CID>

5. 查看角色

识别模式：用户说"有哪些角色"/"角色列表"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py roles

输出要求

  1. 直接执行命令并返回结果
  2. 如果用户输入不明确，简短询问
  3. 结果直接展示，不要额外解释
Usage Guidance
Review this before installing if you care about preserving financial history. It appears local and non-exfiltrating, but you should add or require a confirmation step before delete operations, consider backups or soft-delete, and avoid granting the included broad Claude permissions unless you intentionally need them.
Capability Assessment
ℹ Purpose & Capability
The core behavior is coherent with the stated purpose: a Python/SQLite household ledger that can add, list, summarize, delete, and show roles.
⚠ Instruction Scope
The skill instructs the agent to directly execute parsed commands and maps 'delete + ID' straight to a delete command, with only a brief ambiguity check and no preview or explicit confirmation.
ℹ Install Mechanism
The README describes copying the skill files into agent skill directories. The package also includes a Claude settings.local.json with broad Python command allowance and several development-time network/git permissions, which is not clearly part of the documented install path.
ℹ Credentials
Runtime behavior is local and proportionate for a ledger: Python standard library plus a SQLite database in the tool directory, with no API keys or observed exfiltration paths.
⚠ Persistence & Privilege
The skill persists household financial records in ledger.db and supports immediate permanent deletion by ID, without soft-delete, undo, backup, or confirmation controls.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install family-ledgersimple
  3. After installation, invoke the skill by name or use /family-ledgersimple
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the family-ledger skill: - Record, query, summarize, and delete family expense entries via structured CLI commands. - Supports natural language input for household roles, amounts, purposes, and queries. - Includes role management and flexible filtering (by person, date, or count). - Follows concise output and clarification where needed.
Metadata
Slug family-ledgersimple
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is family-ledger 家庭记账skill?

家庭账本 - 记录和查询家庭支出. It is an AI Agent Skill for Claude Code / OpenClaw, with 52 downloads so far.

How do I install family-ledger 家庭记账skill?

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

Is family-ledger 家庭记账skill free?

Yes, family-ledger 家庭记账skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does family-ledger 家庭记账skill support?

family-ledger 家庭记账skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created family-ledger 家庭记账skill?

It is built and maintained by amin (@nimil); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments