beancount-skills
chialin/beancount-skills
A collection of Claude Code skills for Beancount double-entry bookkeeping.
Instalação
npx convez-ai chialin/beancount-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
beancount-skills
A collection of Claude Code skills for Beancount double-entry bookkeeping.
Each skill is self-contained markdown instructions for Claude Code to follow. Drop a skill folder into your project's .claude/skills/ (or install via npx skills) and trigger it with the slash command.
這是給 Claude Code 用的 Beancount 複式記帳 skill 集合。每個 skill 是一份 markdown 指令,丟進你專案的 .claude/skills/(或用 npx skills 安裝)就能用 slash command 觸發。
中文使用者建議裝 weekly-budget-report-zh-TW 繁中版:
npx skills add chialin/beancount-skills --skill weekly-budget-report-zh-TW
詳細的中文設定說明見 weekly-budget-report-zh-TW/README.md。
Available Skills
| Skill | Language | Trigger | What it does |
|---|---|---|---|
weekly-budget-report | English | /weekly-budget-report | Weekly budget analysis: monthly + yearly tracking, top-5 expenses, next-week allowance, AI suggestions. |
weekly-budget-report-zh-TW | 繁體中文 | /weekly-budget-report | Same skill, output in Traditional Chinese. |
More skills coming. PRs welcome.
Installation
Option A — npx skills CLI (recommended)
npx skills is the Vercel Labs installer for Claude Code skills. It puts the skill files in the right place automatically.
# List available skills in this repo
npx skills add chialin/beancount-skills --list
# Install one skill into the current project's .claude/skills/
npx skills add chialin/beancount-skills --skill weekly-budget-report
# Or install everything
npx skills add chialin/beancount-skills --all
# Install globally (~/.claude/skills/, shared across projects)
npx skills add chialin/beancount-skills --skill weekly-budget-report -g
After install, trigger inside Claude Code with /weekly-budget-report — the setup wizard runs on first invocation.
Option B — Manual clone & copy
git clone https://github.com/chialin/beancount-skills.git /tmp/beancount-skills
mkdir -p .claude/skills/
cp -r /tmp/beancount-skills/weekly-budget-report .claude/skills/
Always: gitignore your personal config
Each skill writes a config.json (output path, budget totals, etc.) on first run. Never commit this file. Add it to your .gitignore:
.claude/skills/<skill-name>/config.json
Each skill folder ships with its own README.md covering prerequisites, configuration, and per-skill details.
Prerequisites
- Claude Code CLI
- Beancount with
bean-query(pip install beanquery) - A beancount project with
main.bean(or any*.bean— first found wins)
Conventions
- Skills assume the beancount project root is your current working directory.
- Skills read
option "operating_currency"from your bean file to determine display currency — no hardcoded TWD/USD/etc. - Skills that need budget categories parse
budgets.beanforcustom "budget"directives. Withoutbudgets.beanthey fall back to listing all top-levelExpenses:*accounts.
See each skill's own README for specifics.
License
MIT — see LICENSE.
Contributing
Bug reports, skill ideas, and PRs welcome. The canonical language is English; translations go into their own <skill>-<lang> folder (e.g. weekly-budget-report-zh-TW).
Paired-language PR policy
PRs that touch one language folder of a skill must also touch the paired variant folder. The i18n Sync Check GitHub Action enforces this on every PR. To bypass for a legitimate single-language change (typo fix in one translation, e.g.), add the label i18n-sync-skip and justify in the PR description.