personal-finance-beancount

Analyze Beancount ledger files to calculate net worth and spending patterns.

30|6|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/zph/beancount-skill --skill personal-finance-beancount-zph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-finance-beancount
Source: https://github.com/zph/beancount-skill/tree/main
Command: npx skills add https://github.com/zph/beancount-skill --skill personal-finance-beancount-zph

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beancount, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Managing personal finances and plain-text accounting is complex and error-prone without specialized tools. This skill transforms Beancount data into actionable financial insights, eliminating the steep learning curve for users who want to understand their spending, track net worth, and optimize their financial health.

Core Features & Use Cases

  • Financial Analysis: Calculate net worth, savings rate, expense ratios, and identify spending patterns from Beancount files.
  • Beancount & Fava Expertise: Generate correct transaction syntax, create BQL queries, and master Fava's reporting and dashboard features.
  • Investment & Budget Guidance: Provide educational recommendations on asset allocation, risk assessment, and goal-based budgeting while maintaining professional boundaries.

Quick Start

Use the personal-finance-beancount skill to analyze your uploaded Beancount file and receive a comprehensive financial overview with personalized recommendations.

Frequently Asked Questions about personal-finance-beancount

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate net worth and savings rate from Beancount files?

To calculate net worth and savings rate from Beancount files, use automated financial analysis scripts like analyze_beancount.py. This process generates comprehensive metrics and identifies spending patterns from your ledger data.

How do I generate Fava reports and BQL queries for personal finance analysis?

Generating Fava reports and BQL queries for personal finance analysis requires correct Beancount transaction syntax. You can create BQL queries to extract specific financial data and visualize it using Fava's built-in dashboard features.

What is plain-text accounting and how does Beancount track spending patterns?

Plain-text accounting is a method of tracking spending patterns using ledger files, and Beancount implements this by parsing structured transaction entries. This approach eliminates errors and provides precise financial insights from your data.

Do I need Beancount installed to analyze my personal finance data?

Yes, you need Beancount installed as a dependency to analyze your personal finance data. The skill requires Beancount ledger files to function and optionally uses the analyze_beancount.py script for automated metric calculation.

Can I get investment allocation and budgeting guidance from Beancount data?

Yes, you can get investment allocation and budgeting guidance from Beancount data. The skill provides educational recommendations on asset allocation, risk assessment, and goal-based budgeting while maintaining professional financial boundaries.