Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

monthly-migration

Estrellas1

Forks0

Actualizado19 de abril de 2026 a las 11:40

Perform monthly journal migration using hledger close --migrate to close the previous month and open the new month with proper balance assertions and account initialization.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Ejecutar en Manus

Fuente

polyipseity

polyipseity/ledger

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ejecutar en Manus

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

Explorador de archivos

3 archivos

SKILL.md

readonly

name	monthly-migration
description	Perform monthly journal migration using hledger close --migrate to close the previous month and open the new month with proper balance assertions and account initialization.

Monthly Migration Skill

Note: Use full path ledger/[year]/[year]-[month]/[name].journal (e.g., ledger/2024/2024-01/self.journal).

Guide for migrating journals at the start of each month.

When to Use

Start of each month (typically 1st-3rd) before adding new transactions
Previous month is complete and validated
Setting up opening/closing balances

Examples: See ./examples.md for canonical migration commands and verification steps.

Quick reference: See .agents/instructions/agent-glossary.instructions.md for short definitions.

Prerequisites

All transactions for previous month finalized
Both self.journal and self.alternatives.journal need migration
Ran python -m check successfully

Process (condensed)

Run hledger close --migrate -f ledger/YYYY/YYYY-MM/self.journal for each journal to generate closing/opening transactions.
Copy the generated closing balances into the previous-month journal and the opening balances into the new month (after the prelude include).
If a previous month's closing balances are corrected after the next month has already been created, update the next month’s opening balances to match the corrected closing balances.
Ensure the new month directory and self.journal exist and include the correct prelude (include ../../../preludes/self.journal).
Verify closing timestamps and opening timestamps are correct (closing at 23:59:59, opening at 00:00:00).
Validate and format (prefer bun run format and bun run check).
Commit using a suitable chore(migration): header and include migration context in the commit message.

For detailed examples and edge cases, see .agents/instructions/developer-workflows.instructions.md and ./examples.md. (Examples and a short checklist are in examples.md.)

Do's and Don'ts

Do:

Run for both self.journal and self.alternatives.journal
Create new directory/file if needed
Include prelude in new journal
Verify closing balances show = 0.00 CURRENCY
Run check and format after

Don't:

Edit hledger close output extensively
Forget prelude include
Skip validation before commit
Perform migration multiple times for same month

Reference Recent Examples

cat ledger/2025/2025-12/self.journal | tail -50  # View closing
cat ledger/2026/2026-01/self.journal | head -50  # View opening

Más de este repositorio

mismo repositorio

edit-journals

polyipseity/ledger

Edit hledger journal files following best practices and conventions. Includes prelude includes, balance assertions, tagging, formatting, and validation procedures with anti-patterns to avoid.

2026-05-271

add-transactions

polyipseity/ledger

Transcribe transactions from source documents into the hledger ledger. Handles raw data (receipts, invoices, bank statements, OCR text) with proper status markers, tagging, and account registration. For multiple entries, uses a separate subagent for each transaction to enable parallelization and focused scope.

2026-05-061

upsert-octopus-transactions

polyipseity/ledger

Strict, step-by-step workflow for upserting Octopus card transactions to the ledger. Requires explicit user clarification for any ambiguity. Enforces contextual matching, mapping, and privacy rules. No guessing or inference allowed.

2026-05-051

add-payee

polyipseity/ledger

Add a new payee (merchant, person, organization, or UUID) to the correct preludes journal file, maintaining strict lexicographical order.

2026-04-191

match-octopus-statement-transactions

polyipseity/ledger

Match Octopus Wallet statement rows to journal transactions and update transaction datetimes. Runs only when explicitly requested.

2026-04-191

validate-journals

polyipseity/ledger

Validate hledger journal files using check/format scripts. Includes validation procedures and local hook (Husky + lint-staged) verification.

2026-04-191

Monthly Migration Skill

Note: Use full path ledger/[year]/[year]-[month]/[name].journal (e.g., ledger/2024/2024-01/self.journal).

Guide for migrating journals at the start of each month.

When to Use

Start of each month (typically 1st-3rd) before adding new transactions

Previous month is complete and validated

Setting up opening/closing balances

Examples: See ./examples.md for canonical migration commands and verification steps.

Quick reference: See .agents/instructions/agent-glossary.instructions.md for short definitions.

Prerequisites

All transactions for previous month finalized

Both self.journal and self.alternatives.journal need migration

Ran python -m check successfully

Process (condensed)

Run hledger close --migrate -f ledger/YYYY/YYYY-MM/self.journal for each journal to generate closing/opening transactions.

Copy the generated closing balances into the previous-month journal and the opening balances into the new month (after the prelude include).

If a previous month's closing balances are corrected after the next month has already been created, update the next month’s opening balances to match the corrected closing balances.

Ensure the new month directory and self.journal exist and include the correct prelude (include ../../../preludes/self.journal).

Verify closing timestamps and opening timestamps are correct (closing at 23:59:59, opening at 00:00:00).

Validate and format (prefer bun run format and bun run check).

Commit using a suitable chore(migration): header and include migration context in the commit message.

For detailed examples and edge cases, see .agents/instructions/developer-workflows.instructions.md and ./examples.md. (Examples and a short checklist are in examples.md.)

Do's and Don'ts

Do:

Run for both self.journal and self.alternatives.journal

Create new directory/file if needed

Include prelude in new journal

Verify closing balances show = 0.00 CURRENCY

Run check and format after

Don't:

Edit hledger close output extensively

Forget prelude include

Skip validation before commit

Perform migration multiple times for same month

Reference Recent Examples

cat ledger/2025/2025-12/self.journal | tail -50 # View closing cat ledger/2026/2026-01/self.journal | head -50 # View opening