usage — Claude Code skill: finance questions and setup
usage is a Claude Code skill that answers questions about spending, budgets, bills, debt, and investments. It uses Hermes Finance tools to retrieve the figures.
AGPL-3.0 ★ 98 updated 2026-11-15
npx skills add apelabs-dev/hermes-finance --skill usage -a claude-codeWhat usage does
usage handles personal finance questions through finance_* tools. It can retrieve spending by period, budget status, transactions, upcoming bills, loans, net worth, and cash flow from the local Hermes Finance database.
Read tools leave records unchanged. Actions such as changing a transaction category or setting a budget cap require user approval before a write tool runs. The figures reflect the latest bank sync; finance_status reports sync times and connection errors.
Hermes Finance can use bank data through Plaid and accounts entered by hand. If Plaid has not been configured, set PLAID_CLIENT_ID and PLAID_SECRET in Hermes configuration or the Hermes Desktop plugin settings; keys should not be pasted into chat.
What it helps with
- check monthly spending by category or merchant
- compare spending with the previous period
- see remaining budget and upcoming bills
- review loans, investments, and net worth
Example prompts for the agent
- How much did I spend on restaurants last month?
- Which bills are due soon?
- Show the remaining shopping budget.
How to install usage
1Skills CLI (Vercel)
npx skills add apelabs-dev/hermes-finance --skill usage -a claude-code2Manually: put the files in place
~/.claude/skills/usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/usage/
1Skills CLI (Vercel)
npx skills add apelabs-dev/hermes-finance --skill usage -a codex2Manually: put the files in place
.agents/skills/usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add apelabs-dev/hermes-finance --skill usage -a cursor2Manually: put the files in place
.cursor/skills/usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install apelabs-dev/hermes-finance hermes_plugin/skills/usage2Manually: put the files in place
.github/skills/usage/SKILL.md1Skills CLI (Vercel)
npx skills add apelabs-dev/hermes-finance --skill usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/apelabs-dev/hermes-finance --path hermes_plugin/skills/usageManually: put the files in place
.devin/skills/usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about usage
How do I install usage in Claude Code?
Run npx skills add apelabs-dev/hermes-finance --skill usage -a claude-code. The skill file is placed at ~/.claude/skills/usage/SKILL.md.
What does usage do?
It answers personal finance questions with Hermes Finance tools, including queries about spending, budgets, bills, and loans. Changes to records require user approval.
What does usage need to work?
It needs access to the finance_* tools and the Hermes Finance database. Bank data uses Plaid; if Plaid is not configured, set PLAID_CLIENT_ID and PLAID_SECRET.