finance-cli-skill

A Claude skill that drives finance-cli — a local, offline, single-binary terminal finance tracker.

The skill teaches Claude to:

• Self-discover the command surface via finance schema --json on first run
• Always emit machine-parseable --json output and read the stable envelope
• Use --dry-run before destructive operations (delete, loan pay, …)
• Use --idempotency-key on retry-prone mutations (24h dedupe window)
• Translate intents like "can I afford 5000 by may 31?" or "should I push freelance?" into the right command(s)

Install

1. The CLI itself

This skill drives finance — install the binary first if you don't have it:

curl -fsSL https://raw.githubusercontent.com/kelvin6365/finance-cli/main/install.sh | bash
# or, with Bun:
bun add -g github:kelvin6365/finance-cli

(The skill will guide you through this on first use too — it detects when the binary is missing and walks you through install + finance init.)

2. The skill

Recommended — via skills.sh:

npx skills add kelvin6365/finance-cli-skill

The skills CLI (open source at vercel-labs/skills) auto-detects your agent and drops the skill into the right directory.

Manual install (git): clone into your agent's skills directory.

# Claude Code
git clone https://github.com/kelvin6365/finance-cli-skill ~/.claude/skills/finance-cli

# any other agent — adjust the destination to match where your agent
# loads skills from (see your agent's docs)

Manual install (packaged): download the .skill from the Releases page and drop it in your skills directory.

Agent compatibility

Built on the open SKILL.md format (YAML frontmatter + Markdown body), so this skill works with any AI agent that reads that format.

Auto-install via skills.sh covers 50+ agents, including:

• Claude Code
• OpenCode
• Codex (OpenAI)
• Cursor
• Cline
• Continue
• GitHub Copilot
• Windsurf
• OpenHands
• Goose
• Gemini CLI
• Aider / AiderDesk
• Roo Code
• Kiro CLI
• (and many more — see the full list)

Other agents (manual install): Hermes Agent, OpenClaw, or any custom agent that consumes SKILL.md — clone the repo into the directory your agent reads skills from.

Try it

Open a Claude session and ask in natural language:

• "log $80 lunch"
• "can I afford 5000 by may 31?"
• "should I push freelance this month?"
• "what if I throw $5,000 extra at debt avalanche-style?"
• "what changed since 2026-04-01?"

Layout

finance-cli-skill/
├── SKILL.md                 core skill body (triggers + intent→command map)
└── references/
    ├── envelope.md          JSON envelope shape, error codes, idempotency
    └── recipes.md           multi-step workflow patterns

License

MIT — see LICENSE.