Frontend Audit and Fix
SkillMediaLets your agent audit and fix a Next.js frontend for API mismatches, type errors, accessibility, and build problems.
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Frontend Audit and Fix skill
About this skill
Audit and repair the ITSM Next.js frontend for real-API usage, camelCase contracts, type safety, Ant Design correctness, user states, accessibility, tests, and production build health. Use for frontend QA, code review, mock-data removal, API/UI mismatch, or build validation.
What this skill tells your AI
The instructions your AI receives, as published by heidsoft/itsm in itsm-frontend/.trae/skills/frontend-audit-fix/SKILL.md and read by ahel’s review.
Audit
- Trace the page → API client → backend DTO/route.
- Search production components for mock/sample/random fallback data.
- Confirm HTTP fields and TypeScript types use
camelCase. - Check loading, empty, error, validation, permission, success, and refresh states.
- Check icon-button names, labels, keyboard access, responsive layout, and body overflow.
- Inspect console/network errors in a real browser.
- Identify whether the browser is serving the checked-out source or an older container image.
Useful searches:
rg -n 'mockData|Math\\.random\\(\\)|模拟数据' src --glob '*.tsx'
rg -n 'snake_case|_[a-z]+:' src/lib/api src/app --glob '*.{ts,tsx}'
rg -n 'valueStyle|bodyStyle|headStyle|Tabs\\.TabPane' src
Verify findings before mechanical replacement; legitimate internal snake_case or fixtures may exist.
Fix rules
- Never add mock data to production paths to hide a missing API.
- Fix backend DTO/mapper and frontend client/types together when the contract is wrong.
- Keep business rules in backend services.
- Use
App.useApp()for contextual Ant Design message/modal APIs. - Preserve useful prior data on refresh failure, but clearly disclose stale state.
- Avoid swallowing errors or converting permission denial into an empty list.
- Keep authentication, CSRF, RBAC, and tenant-denial errors distinct.
- Add a focused regression test for user-facing defects.
Verification
npm run type-check
npm run lint:check
npm run test:ci
npm run build
For page behavior:
PLAYWRIGHT_SKIP_CHANNELS=1 \
npx playwright test tests/e2e/<module>.spec.ts --project=chromium --workers=1
Signals
- GitHub stars
- 77
- Forks
- 18
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
frontend-audit-fix- Source
- github.com/heidsoft/itsm
Related picks
Skill · thedaviddias
The pick for JavaScriptmodern-javascript-patterns
Skill · wshobson
The pick for JavaScriptsetup-ts-deep-modules
Skill · mattpocock
The pick for TypeScripttypescript-pro
Skill · jeffallan
The pick for TypeScriptlogs-nextjs
Skill · posthog
The pick for Next.jsclerk-nextjs-patterns
Skill · clerk
The pick for Next.js