fdic-skill-builder

FDIC Skill Builder

Skill Type: RIGID

Follow every phase in order. Do not skip phases. Do not write skill content before completing Phase 1.

---

Phase 1: Contract Verification

Before writing a single line of skill content, verify every tool the skill will call.

1a — Live tool probe

Call each tool in the planned chain with a known-good institution (e.g., CERT 57 — JPMorgan Chase Bank). Record the full response. Save it for the reference file (Phase 3c).

Server fix required gate (hard dependencies): If any hard-dependency tool returns a field validation error or an unexpected error response, stop. Fix the server bug before proceeding. Skill content written against a broken hard dependency is useless.

Rule: A skill cannot describe a hard-dependency tool that the server cannot execute. Fix the server first, write the skill second.

For soft and context tools that are broken: you may continue drafting the skill, but all structuredContent paths for that tool must be marked [source-derived] in the reference file until a live response confirms them. Note the broken tool explicitly in the skill's dependency table and add a TODO to re-verify.

Field validation errors follow this pattern: "Invalid field 'FIELDNAME' for endpoint ENDPOINT". When you see one:

1. Open src/fdicEndpointMetadata.ts and search for the endpoint section.
2. Verify the exact field name in the catalog. Names are case-sensitive.
3. Fix the field in the source file (src/tools/shared/*.ts or the tool file directly).
4. Run npm run typecheck && npm test to confirm no regressions.
5. Only then return to skill development.

1b — Field catalog cross-check

For every FDIC field string referenced in tool source files (CERT,NAME,ASSET,...), grep the catalog and confirm each field exists for its endpoint:

src/fdicEndpointMetadata.ts   — authoritative catalog
src/fdicSchema.ts             — validation layer (uses the catalog)

Common typo classes found in this codebase:

• NAMHCR → NAMEHCR (institutions endpoint, holding company name)
• LNOTH → not valid for the financials endpoint (was in CREDIT_FIELDS and UBPR_FIELDS)