Agent skill
frontend-debug-linting-petbrains-mvp-builder
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/frontend-debug-linting-petbrains-mvp-builder
SKILL.md
Debug & Linting
Catch errors before delivery. Lint, type-check, browser verify.
When to Use
- After writing code → run checks
- Before delivery → verify quality
- Debugging → check console/network
Process
LINT → TYPE → BROWSER → DELIVER
- Run lint:
npm run lint - Type check:
npm run typecheck - Browser check: console + screenshot
- Deliver when clean
Quick Commands
bash
npm run lint # ESLint check
npm run lint:fix # Auto-fix
npm run typecheck # TypeScript check
npm run format # Prettier format
npm run check # All checks
Common Fixes
TypeScript
yaml
"Type 'X' not assignable to 'Y'":
→ Fix type mismatch or add assertion
"'X' declared but never used":
→ Remove or prefix with _
"Object possibly 'undefined'":
→ Add null check: obj?.property
→ Add fallback: obj ?? default
React
yaml
"Missing dependencies in useEffect":
→ Add deps or wrap in useCallback
"Each child should have unique key":
→ Add key={item.id} to list items
"img must have alt prop":
→ Add alt text or alt=""
Formatting
yaml
"Prettier errors":
→ Run: npm run format
Browser Verification
yaml
# Check console errors
browser_console_messages: { onlyErrors: true }
→ Must be empty before delivery
# Check network
browser_network_requests
→ No failed (4xx, 5xx) requests
# Debug element styles
browser_evaluate: { function: "() => getComputedStyle(el)" }
Pre-Delivery Checklist
yaml
MUST PASS:
- [ ] npm run lint → 0 errors
- [ ] npm run typecheck → 0 errors
- [ ] browser_console_messages → 0 errors
- [ ] No failed network requests
CAN DELIVER WITH:
- ESLint warnings (with explanation)
- Console warnings (if understood)
Project Setup
bash
# Add to existing Next.js project
npm install -D prettier eslint-config-prettier
# package.json scripts
{
"lint": "eslint . --ext .ts,.tsx",
"lint:fix": "eslint . --ext .ts,.tsx --fix",
"format": "prettier --write .",
"typecheck": "tsc --noEmit",
"check": "npm run typecheck && npm run lint"
}
Debug Checklist
yaml
WHEN SOMETHING BREAKS:
1. browser_console_messages → check errors
2. browser_network_requests → failed requests?
3. npm run typecheck → type errors?
4. Add console.log → trace flow
5. Isolate → comment out sections
6. Fix → run checks → verify
Didn't find tool you were looking for?