# usage

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 98 repo stars
- Author: apelabs-dev
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/apelabs-dev/hermes-finance/tree/HEAD/hermes_plugin/skills/usage/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/usage

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add apelabs-dev/hermes-finance --skill usage -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/usage/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/usage/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add apelabs-dev/hermes-finance --skill usage -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/usage/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add apelabs-dev/hermes-finance --skill usage -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/usage/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install apelabs-dev/hermes-finance hermes_plugin/skills/usage
```

2. **Manually: put the files in place**
- File: `.github/skills/usage/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add apelabs-dev/hermes-finance --skill usage -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/apelabs-dev/hermes-finance --path hermes_plugin/skills/usage
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/usage/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/apelabs-dev/hermes-finance/tree/HEAD/hermes_plugin/skills/usage/SKILL.md

## When to use it
- 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
- How much did I spend on restaurants last month?
- Which bills are due soon?
- Show the remaining shopping budget.

## Similar
- [qianwen-usage](https://affpapa.org/en/nevibecode/skills/qianwen-usage.md) — skill · 6100 installs
- [usage-based-billing](https://affpapa.org/en/nevibecode/skills/usage-based-billing.md) — skill · 803 installs
- [understanding-billing-usage](https://affpapa.org/en/nevibecode/skills/understanding-billing-usage.md) — skill · 150 installs
- [signals-scout-customer-analytics-billing-and-usage](https://affpapa.org/en/nevibecode/skills/signals-scout-customer-analytics-billing-and-usage.md) — skill · 149 installs
- [klingai-usage-analytics](https://affpapa.org/en/nevibecode/skills/klingai-usage-analytics.md) — skill · 1 install
- [cursor-usage-analytics](https://affpapa.org/en/nevibecode/skills/cursor-usage-analytics.md) — skill · 1 install

From the same set: [apelabs-dev/hermes-finance](https://affpapa.org/en/nevibecode/by/apelabs-dev/hermes-finance.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
