hledger

Manage and validate double-entry plain-text accounting from journal files and CSV imports.

1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/tho/skills --skill hledger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hledger
Source: https://github.com/tho/skills/tree/main/skills/hledger
Command: npx skills add https://github.com/tho/skills --skill hledger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

hledger helps you organize and validate plain-text double-entry accounting data, then turn it into trustworthy financial statements and CSV-ready imports.

Core Features & Use Cases

  • Journal correctness and validation: ensures postings balance, accounts/commodities are declared (strict mode), and date/order assumptions hold.
  • CSV import with rule-based categorization: maps CSV columns into journal postings, with conditional rules for payees and descriptions.
  • Reporting and analysis: produces balance sheets, income statements, cashflow, registers, and multi-period summaries for reconciliation and decision-making.

Quick Start

Use the hledger skill to import bank.csv with custom CSV rules and generate a balanced, categorised journal preview before committing it.

Frequently Asked Questions about hledger

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

FAQPage Schema
Can I use hledger for account reconciliation and balance reporting?

Yes, hledger supports reconciliation and balance reporting through registers, balance sheets, and multi-period summaries. These reports help verify account balances and reconcile transactions against external records from your journal data.

What is double-entry bookkeeping validation for plain-text journal files?

Double-entry bookkeeping validation checks that postings balance, accounts and commodities are explicitly declared in strict mode, and date and order assumptions hold. Validation commands ensure transaction integrity and consistent account declarations across journal files.

How do I generate financial statements like balance sheets and income statements from journal data?

You can generate balance sheets, income statements, cashflow reports, registers, and multi-period summaries from validated journal data. These financial statements support reconciliation queries and decision-making analysis directly from plain-text accounting files.

How do I set up CSV import rules for conditional payee matching?

CSV import rules use .csv.rules syntax with conditional matchers to map CSV columns to journal postings based on payee and description patterns. This enables automatic categorization of imported transactions into appropriate accounts.

Why does my hledger journal fail validation on unbalanced transactions?

Journal validation fails when postings do not balance, accounts or commodities are not declared in strict mode, or date and order assumptions are violated. Validation commands detect these integrity issues so you can correct transaction entries before reporting.

Can I use hledger for account reconciliation and balance reporting?

Yes, hledger supports reconciliation and balance reporting through registers, balance sheets, and multi-period summaries. These reports help verify account balances and reconcile transactions against external records from your journal data.