Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add apelabs-dev/hermes-finance --skill usage -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/usage/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/usage/

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.

Similar skills

All skills for Finance and business →
qianwen-usage QianWen-AI qianwen-usage — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that handles QianWenAI auth and billing queries. Covers token usage, free-tier quotas, call logs with 4xx/5xx errors, and order history. CX Codex +1 6,100installs usage-based-billing dodopayments usage-based-billing guides coding agents on setting up consumption-based billing with Dodo Payments, from creating meters to ingesting usage events. CX Codex +1 803installs understanding-billing-usage PostHog understanding-billing-usage is a Claude Code skill that investigates PostHog usage and spend through Billing MCP tools. It handles questions about spikes, changes, and the products or projects behind usage. CX Codex +1 150installs signals-scout-customer-analytics-billing-and-usage PostHog signals-scout-customer-analytics-billing-and-usage — a skill for Claude Code that tracks product usage and forecast MRR changes within individual accounts. It spots product-level shifts hidden by a steady account total. CX Codex +1 149installs klingai-usage-analytics Jeremy Longshore klingai-usage-analytics tracks Kling AI video generation runs, errors, and credit spending using JSONL logs. Builds daily summaries and cost projections. CX Codex +1 1installs cursor-usage-analytics Jeremy Longshore cursor-usage-analytics analyzes aggregated Cursor usage across requests, models, spend, and team adoption. Use it to prepare reports and review quota signals. CX Codex +1 1installs

From the same set3

Project sponsors

Companies that keep this analytics open