auto-bean-categorize

Categorize a parsed evidence artifact and determine reconciliation actions for posting.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Categorize a single parsed statement or intermediate artifact and identify reconciliation or deduplication decisions for downstream posting preparation.

Core Features & Use Cases

  • Handles statement-scoped categorization, reconciliation findings, pending questions, and posting inputs for later write
  • Works on exactly one assigned parsed or import artifact per activation, ensuring deterministic focus and governance
  • Produces a categorized artifact when needed to capture user-facing decisions and questions for review

Quick Start

Invoke the categorize workflow on the assigned ready_for_categorization artifact via the auto-bean-import agent.

Frequently Asked Questions about auto-bean-categorize

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

FAQPage Schema
How do I categorize a parsed bank statement for Beancount posting?

Categorize a parsed bank statement by assigning transaction categories and determining reconciliation or deduplication actions. This process handles statement-scoped categorization and produces a categorized artifact for downstream Beancount posting.

How does statement reconciliation work when preparing Beancount imports?

Statement reconciliation identifies duplicate transactions and flags pending questions within a single parsed artifact. It enforces Beancount-safe checks and generates memory suggestions to ensure accurate downstream posting without balance errors.

Can I process multiple parsed artifacts simultaneously for categorization?

No, the categorization process operates on exactly one assigned parsed or intermediate artifact per activation. This ensures deterministic focus and governance, preventing cross-statement data contamination during the reconciliation process.

What is the best way to handle deduplication in automated Beancount workflows?

Handle deduplication by evaluating a single parsed-evidence artifact to determine if transactions match existing records. The workflow identifies duplicates and outputs deduplication actions within a categorized artifact for review before final posting.

Do I need a parsed artifact before starting the categorization workflow?

Yes, you need a ready_for_categorization artifact provided by an import workflow. The categorization process requires this assigned parsed or intermediate artifact to evaluate transactions and produce accurate reconciliation findings and posting inputs.

What limitations exist when reconciling intermediate artifacts for Beancount?

The process is limited to a single artifact per activation and cannot perform cross-statement reconciliation. It focuses strictly on statement-scoped categorization, leaving final writing actions to the broader import workflow.