SKILL.md
Firm Config
This skill exposes firm-specific configuration. The other skills in this bundle (bank-rec, flux-analysis, prepaid-schedule, pbc-package, je-review) consume it. You will customize this skill per firm. The files in references/ ship as templates with realistic placeholder data clearly marked TEMPLATE — REPLACE.
When to load
At the start of any workflow that needs:
- Account validation (is this account in our chart?)
- Materiality threshold application (does this variance exceed our threshold?)
- Period/calendar awareness (is the date in an open close window?)
- Approval routing (who signs off at this amount?)
A workflow skill loads firm-config before applying any threshold or validation. If a workflow runs without firm-config available, it must say so explicitly in Review_Notes and use the defaults stated in each reference file.
What's in references/
| File | Purpose | Consumed by |
|---|---|---|
chart-of-accounts.csv |
All valid GL accounts with descriptions and natural balance | je-review, flux-analysis, bank-rec |
materiality.md |
Per-workflow thresholds | flux-analysis, je-review, prepaid-schedule |
close-calendar.md |
WD1–WD10 task schedule and open/closed periods | je-review, all (period awareness) |
approval-matrix.md |
Approval routing by dollar threshold | je-review (escalation), bank-rec (over-threshold reconciling items) |
Customizing for your firm
Replace each file in references/:
- Chart of accounts — export from your GL. The CSV must keep the same column headers (
accountnumber,accountname,accounttype,naturalbalance,is_active). Account numbers as strings to preserve leading zeros. - Materiality — replace the thresholds in
materiality.md. The threshold names are referenced by other skills, so keep the names; change the numbers. - Close calendar — update WD1–WD10 task lists, posting cutoffs, and the list of currently open periods.
- Approval matrix — update name placeholders and dollar thresholds.
The template values are reasonable defaults for a mid-market services company at ~$50M revenue. They are not your firm's values.
Reading config in practice
Other skills reference config values by name, not by hardcoded number. Example from flux-analysis:
Apply
materiality.fluxthresholdpctandmateriality.fluxthresholddollarfromfirm-config/references/materiality.md. An account triggers commentary if it exceeds either the dollar threshold OR the percent threshold.
If you change a threshold in materiality.md, the change takes effect on the next workflow run. No skill code needs updating.
What this skill is not
This is not a config-loading library. The files in references/ are read directly by the workflow skills as part of their context. There is no Python module to import — just markdown and CSV that the skills inspect.