Skip to content

skills: add accounts-receivable-advanced stub (02-org-100-to-1k)#5

Merged
t4sh merged 1 commit into
mainfrom
skills/accounts-receivable-advanced-stub
May 2, 2026
Merged

skills: add accounts-receivable-advanced stub (02-org-100-to-1k)#5
t4sh merged 1 commit into
mainfrom
skills/accounts-receivable-advanced-stub

Conversation

@t4sh
Copy link
Copy Markdown
Contributor

@t4sh t4sh commented May 2, 2026

Closes #4

Resolves the only orphan `composes:` reference across the entire erphq/appskills catalog. `apps/020-02-fin-invoicing-ar.md` composes `finance-accounting/accounts-receivable-advanced` but no SKILL.md existed for it at any size tier.

What ships

A stub SKILL.md at the canonical path:

```
departments/finance-accounting/02-org-100-to-1k/accounts-receivable-advanced/SKILL.md
```

(02-org-100-to-1k tier per the app's own `size_tier` frontmatter.)

The stub:

  1. Has correct frontmatter — matches the neighboring `accounts-receivable` SKILL.md at this tier in shape; `name: accounts-receivable-advanced`, differentiated `description`.
  2. Captures the differentiator — what makes "advanced" distinct from the basic AR skill (standalone invoicing-app form vs. AR-as-sub-module form).
  3. Lists the 19-table inventory — sourced from the app spec's `## Composed Skills` bullet, table-by-table.
  4. Explicit "stub" marker at the top of the body — readers see immediately this is unfinished content.
  5. TODO checklist for the standard SKILL.md sections that need domain-expert authorship (Build / Maintain / Scale / By Industry / ERP•AI & Proto / Related).

Why a stub vs. a full write-up

Writing the full Build/Maintain/Scale content for an advanced AR engine requires domain expertise I don't have. The minimum viable change is:

  • Make the canonical path resolve (so downstream build tools stop hitting 404)
  • Capture the differentiator and table inventory (so the maintainer has a structured starting point)
  • Mark TODOs explicitly (so the unfinished nature is visible, not hidden)

When the deeper content lands, this stub gets replaced — version field bumped from `0.1.0` to `1.0.0`.

Verification

  • `gh api repos/erphq/skills/contents/departments/finance-accounting/02-org-100-to-1k/accounts-receivable-advanced/SKILL.md` returns 200 (no longer 404).
  • Downstream consumer (lab-sites) running `composes:` resolution against the appskills catalog finds 0 orphan references after this lands.
  • Markdown renders cleanly (table, internal links, code blocks).

Spec aware

Surfaced during work on erphq/lab-sites#118, which built the appskills+skills→lab-sites pipeline and ran a full `composes:` resolution audit across all 71 apps and 62 unique skill references.

Resolves the only orphan composes: reference across the entire
appskills catalog. erphq/appskills/apps/020-02-fin-invoicing-ar.md
references finance-accounting/accounts-receivable-advanced but
no SKILL.md existed at any size tier.

This commit ships a stub at the canonical path
(02-org-100-to-1k tier per the app's own size_tier frontmatter)
that captures:

- Correct frontmatter (matches the sibling accounts-receivable
  skill at this tier in shape; differentiated description)
- The 19-table inventory sourced from the app spec's
  ## Composed Skills bullet, with column-level details deferred
  to the app spec
- Explicit "stub" marker at the top of the body
- TODO checklist for the standard SKILL.md sections (Build /
  Maintain / Scale / By Industry / ERP•AI & Proto / Related)
  that need domain-expert authorship

Goal: unblock build-time composes: expansion in downstream tools
(lab-sites was hitting this when running its skills-drift
checker), and give the maintainer a structured starting point
to flesh out the deeper content.

Differentiator vs. the existing accounts-receivable skill at the
same tier: this is the standalone-invoicing-app form (branded
templates, recurring billing, formal dunning, dispute mgmt,
collections cases, write-offs, late fees, credit holds) — not
the AR-as-sub-module-within-books form. Per the app spec,
typical fit is a US mid-market company that has outgrown
sub-module AR.

Closes #4
@t4sh t4sh merged commit 8dc6577 into main May 2, 2026
3 checks passed
@t4sh t4sh deleted the skills/accounts-receivable-advanced-stub branch May 2, 2026 05:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing skill leaf: finance-accounting/02-org-100-to-1k/accounts-receivable-advanced

1 participant