auto-bean-import

Orchestrate end-to-end Beancount statement imports for a Git-backed ledger workspace.

1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/SamArgt/auto-bean --skill auto-bean-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-bean-import
Source: https://github.com/SamArgt/auto-bean/tree/main/skill_sources/auto-bean-import
Command: npx skills add https://github.com/SamArgt/auto-bean --skill auto-bean-import

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Orchestrate the end-to-end Beancount statement import workflow for a local, Git-backed ledger workspace, coordinating raw statement discovery, processing, categorization, writing, and memory handoff while maintaining one per-raw-statement import artifact.

Core Features & Use Cases

  • Orchestrates discovery, parsing, categorization, cross-statement review, and final write for imported statements
  • Maintains one import-owned artifact per raw statement under .auto-bean/artifacts/import/
  • Delegates processing steps to specialized skills ($auto-bean-process, $auto-bean-categorize, $auto-bean-write, $auto-bean-memory) with governed memory handoff

Quick Start

Run auto-bean-import to inspect raw statements, statuses, and matching memory, generating per-raw-statement import artifacts and progressing the full import workflow.

Frequently Asked Questions about auto-bean-import

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

FAQPage Schema
How do I automate end-to-end Beancount statement imports?

It coordinates the full Beancount import workflow by processing raw statements, generating per-statement Markdown artifacts, and delegating categorization and writing steps to specialized sub-skills.

What is the artifact contract for Beancount import workflows?

The import artifact contract maintains one Markdown decision artifact per raw statement under .auto-bean/artifacts/import/, holding stable references to process, categorize, and write artifacts for traceability.

Can I use this for a local Git-backed Beancount ledger workspace?

Yes, this Skill is specifically designed to orchestrate imports for a local, Git-backed ledger workspace, managing memory handoff and maintaining artifact references for each raw statement.

How does cross-statement review work during Beancount imports?

Cross-statement review is an orchestrated step within the import workflow that validates processed transactions across multiple statements before final writing and memory handoff to the ledger.

What are the limitations of automating Beancount imports with this approach?

This Skill enforces a strict one-artifact-per-raw-statement contract and relies on local Git-backed workspaces, meaning it requires specific sub-skills for processing and categorizing rather than functioning as a standalone parser.