← Back to Skills Marketplace
146
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pocket-book
Description
Record, query, complete, correct, and undo personal bookkeeping entries through short natural-language conversation, with local JSONL and Markdown persistenc...
Usage Guidance
This skill appears to be a straightforward local personal-ledger tool implemented in Python. Before installing, note: (1) ledger data is stored on disk (default: ~/.openclaw/pocketbook/default) — treat it as sensitive personal data and back it up or encrypt it if needed; (2) you can override storage via --data-dir or the POCKETBOOK_DATA_DIR env var (the env var is supported by the code but not documented in metadata); (3) the skill requires a Python runtime but does not contact external servers or request credentials; (4) review profile.json and ledger.jsonl if you want to inspect or migrate data. If you are comfortable with local file storage of personal finance items and have Python available, the skill is coherent and proportional to its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: pocket-book
Version: 1.0.0
The pocket-book skill bundle is a well-structured personal finance tool designed for local ledger management. It uses an append-only event-stream model (ledger.jsonl) and provides scripts for recording, querying, and rendering financial data into Markdown. The code follows security best practices for local storage, including atomic file writes and locking mechanisms (ledger_common.py), and lacks any indicators of malicious intent such as network exfiltration, shell execution, or unauthorized file access beyond its designated data directory (~/.openclaw/pocketbook/).
Capability Assessment
Purpose & Capability
Name/description match the code and instructions. The scripts implement append/query/update/revert, profile management, and Markdown rendering for a local ledger. Required binary (python/python3) is appropriate and proportional.
Instruction Scope
SKILL.md confines behavior to personal-ledger operations, describes triggers, and instructs use of provided scripts. The instructions reference only the included scripts, local data files, and the provided reference docs; they do not ask the agent to read unrelated system files or exfiltrate data.
Install Mechanism
No install spec; this is instruction/code-only with scripts bundled. Nothing is downloaded at install time and no external package install occurs.
Credentials
No required credentials or config paths. The code honors a POCKETBOOK_DATA_DIR environment variable as an alternate data root (used by ensure_data_dir) but that env var is not listed in registry metadata or SKILL.md — it is optional and not a secret. This is a minor documentation mismatch rather than a functional risk.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges or modify other skills. It only writes/reads files within its data root (default ~/.openclaw/pocketbook/default) and manages its own profile and ledger files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pocket-book - After installation, invoke the skill by name or use
/pocket-book - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Pocketbook 1.0.0
- Initial release for personal bookkeeping via natural language conversation.
- Supports adding, querying, completing, correcting, and undoing entries with local JSONL and Markdown persistence.
- Handles incomplete entries and allows safe review and correction.
- Includes focused trigger criteria to ensure activation only for explicit ledger actions.
- Supplies a set of command-line scripts for all ledger operations, with clear payload guidelines.
- Replies are concise, focused on ledger feedback, and include duplicate or ambiguity warnings when needed.
Metadata
Frequently Asked Questions
What is pocketbook?
Record, query, complete, correct, and undo personal bookkeeping entries through short natural-language conversation, with local JSONL and Markdown persistenc... It is an AI Agent Skill for Claude Code / OpenClaw, with 146 downloads so far.
How do I install pocketbook?
Run "/install pocket-book" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pocketbook free?
Yes, pocketbook is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does pocketbook support?
pocketbook is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created pocketbook?
It is built and maintained by SuRu711 (@suru711); the current version is v1.0.0.
More Skills