| name | build-resolver |
| description | Minimal-diff build error fixer — gets builds green with the smallest possible changes |
| layer | utility |
| category | quality |
| triggers | ["build error","build failed","tsc error","type error","build fix","compilation error","build broken"] |
| inputs | [{"errors":"Build output or error messages"},{"scope":"Files to fix (default: all erroring files)"}] |
| outputs | [{"fixes":"Minimal edits that resolve all build errors"},{"verification":"Clean build confirmation"}] |
| linksTo | ["fix","typescript-frontend","quality-gate"] |
| linkedFrom | ["debug","cook","ship"] |
| preferredNextSkills | ["quality-gate","test"] |
| fallbackSkills | ["fix","debug"] |
| riskLevel | low |
| memoryReadPolicy | selective |
| memoryWritePolicy | selective |
| sideEffects | ["Modifies source files with minimal type/import fixes"] |
| agentConfig | {"tools":["Read","Edit","Bash","Grep","Glob"],"model":"sonnet","isolation":true} |
Build Resolver
Purpose
Get a broken build passing with the absolute minimum changes. No refactoring,
no architecture changes, no improvements — just fix what's broken and verify.
This skill is designed to run as an isolated agent with its own context window,
so it can focus entirely on build errors without polluting the main conversation.
Use this when:
tsc --noEmit reports errors after edits
npm run build / next build fails
- CI pipeline breaks on type errors
- You need a quick fix without understanding the full context
Key Concepts
Minimal-Diff Philosophy
The build-resolver follows one rule: smallest possible change that makes the build green.
| DO | DON'T |
|---|
| Add type annotations | Refactor code structure |
Add null checks (?., ??) | Rename variables |
| Fix import paths | Add new features |
| Add missing interface fields | Change business logic |
| Cast types when safe | "Improve" existing code |
Add @ts-expect-error as last resort | Add comments or docs |
Common Error → Fix Map
| Error Pattern | Fix |
|---|
implicitly has type 'any' | Add explicit type annotation |
possibly 'undefined' | Add optional chaining ?. or nullish coalescing ?? |
Property 'X' does not exist on type 'Y' | Add to interface or use type assertion |
Cannot find module 'X' | Fix import path or install package |
Type 'X' is not assignable to type 'Y' | Narrow type or add assertion |
Argument of type 'X' is not assignable | Convert type at call site |
|