break-trace

Trace a break row to its GL entry and subledger transaction, then output a root-cause JSON.

Updated May 9, 2026
One-click install
npx skills add https://github.com/iTzFaisal/financial-services --skill break-trace-itzfaisal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: break-trace
Source: https://github.com/iTzFaisal/financial-services/tree/main/.opencode/skills/break-trace
Command: npx skills add https://github.com/iTzFaisal/financial-services --skill break-trace-itzfaisal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traces a reconciliation break from its break row to the originating GL entry and the matching subledger transaction, then articulates the root-cause in a concise statement.

Core Features & Use Cases

  • Trace the GL side to fetch the journal entry or posting (entry id, posting date, source system, batch id, preparer) and the subledger side (trade id, trade/settle dates, counterparty, source feed, FX rate used).
  • Diff attributes (posting date, FX rate/date, account mapping, quantity sign, amount sign) to identify the differing element that caused the break.
  • Produce a root-cause sentence in the form "⟨side⟩ ⟨did what⟩ because ⟨reason⟩" and compile a recommended remediation action.

Quick Start

Trace a given break row to its source GL and subledger entries and produce a root-cause statement.

Frequently Asked Questions about break-trace

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

FAQPage Schema
How do I trace a GL and subledger reconciliation break to its root cause?

To trace a reconciliation break, you cross-compare the originating GL entry against the matching subledger transaction by diffing posting dates, FX rates, accounts, and sign conventions to identify the mismatch. This isolates the exact differing element that caused the break.

What is the best way to identify the root cause of a GL subledger break?

The best way to identify a GL subledger break is to fetch both the journal entry and the matching subledger transaction, then diff attributes like posting date, FX rate, account mapping, and amount signs. This comparison highlights the specific field discrepancy driving the reconciliation break.

How do I find out why my subledger transaction does not match the general ledger posting?

You find the mismatch by tracing the break row to its source GL entry and subledger transaction, then cross-comparing attributes like posting dates, FX rate dates, and quantity signs. The diff reveals the exact data entry or mapping discrepancy causing the reconciliation break.

Can I get a recommended remediation action after identifying a reconciliation break?

Yes, after identifying a reconciliation break, the process produces a structured JSON output containing a concise root-cause sentence and a compiled recommended remediation action. This provides clear, actionable steps to resolve the specific GL and subledger mismatch.

What specific data attributes do I need to compare when auditing a reconciliation break?

When auditing a reconciliation break, you need to compare posting dates, FX rates and dates, account mappings, and both quantity and amount sign conventions. Differing values in these specific fields between the GL entry and subledger transaction typically reveal the break's origin.