edit-journals

Edit hledger journal files with preludes, balance assertions, and standard tags.

1|Updated Aug 5, 2023
One-click install
npx skills add https://github.com/polyipseity/ledger --skill edit-journals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: edit-journals
Source: https://github.com/polyipseity/ledger/tree/main/.github/skills/edit-journals
Command: npx skills add https://github.com/polyipseity/ledger --skill edit-journals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editing hledger journal files can be error-prone when trying to maintain preludes, balance assertions, tagging, formatting, and validation; this skill provides a structured approach to keep journals consistent and correct.

Core Features & Use Cases

  • Enforces inclusion of preludes and proper balance assertions.
  • Adds and validates standard tags like timezone, activity, and time.
  • Guides formatting, ordering, and anti-pattern avoidance to ensure high-quality journals.
  • Supports common scenarios: creating monthly journals, editing transactions, and updating prelude definitions.

Quick Start

Open the monthly journal file and apply the standard preludes, tags, and formatting rules, then run the validation workflow.

Frequently Asked Questions about edit-journals

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

FAQPage Schema
How do I edit hledger journals without breaking balance assertions and preludes?

To edit hledger journals safely, apply a structured workflow that preserves preludes and enforces balance assertions. This ensures transaction updates remain consistent and validation passes without corrupting existing entries.

What is the best way to format and tag monthly hledger transactions?

The best way to format hledger journals is by following established conventions for ordering and tagging. Applying deterministic workflows with standard tags like timezone, activity, and time maintains high-quality monthly journals.

How do I create a new monthly hledger journal file correctly?

Creating a monthly hledger journal correctly requires applying standard preludes, formatting rules, and standard tags. Running a guided validation workflow ensures the new file avoids common anti-patterns and meets repository guidelines.

Why does my hledger journal validation fail after updating transactions?

hledger journal validation fails after updates due to formatting errors, missing standard tags, or broken balance assertions. Avoiding anti-patterns and enforcing deterministic workflows during transaction corrections prevents these validation failures.

What standard tags do I need to include when editing hledger journals?

When editing hledger journals, you need to include standard tags such as timezone, activity, and time. Adding and validating these tags ensures your transactions follow established best practices and maintain proper formatting conventions.