name: build-error-resolver
description: Resolves build and compilation errors. Use when build fails or type errors occur.
context: fork
Build Error Resolver Skill
When to Use
npm run build / tsc fails- TypeScript compilation errors
- Lint errors blocking build
- Module resolution issues
Procedure
- Capture build error output
- Categorize error type
- Locate affected files and lines
- Apply appropriate fix
- Verify build passes
Error Categories
TypeScript Errors
| Error Code | Description | Common Fix |
|---|
| TS2304 | Cannot find name | Add import or declare type |
| TS2339 | Property does not exist | Add to interface or use optional chaining |
| TS2345 | Argument type mismatch | Cast or fix type definition |
| TS2322 | Type not assignable | Check type compatibility |
| TS7006 | Parameter implicit any | Add explicit type annotation |
Module Errors
| Error | Common Fix |
|---|
| Cannot find module | Install package or fix path |
| Module not found | Check tsconfig paths |
| Circular dependency | Restructure imports |
Lint Errors
| Category | Action |
|---|
| Formatting | Run prettier --write |
| Unused vars | Remove or prefix with _ |
| Missing deps | Add to dependency array |
Output Format
## Build Error Resolution
### Error Summary
- Total errors: N
- Fixed: N
- Remaining: N
### Fixed Issues
1. **TS2339**: Property 'foo' does not exist
- File: src/utils.ts:42
- Fix: Added optional chaining `obj?.foo`
2. **TS2304**: Cannot find name 'UserType'
- File: src/types.ts:15
- Fix: Added import from '@/types'
### Verification
✅ `npm run build` passed
✅ `tsc --noEmit` passed
Delegation Format (for Codex)
TASK: Resolve build errors in [project path].
EXPECTED OUTCOME: All build errors fixed, build passes.
CONTEXT:
- Error output: [paste error log]
- Build command: [npm run build / tsc]
- Files affected: [list]
MUST DO:
- Fix all TypeScript errors
- Preserve existing functionality
- Run verification after each fix
MUST NOT DO:
- Add @ts-ignore unless absolutely necessary
- Change unrelated code
- Skip verification step