SKILL.md
TypeScript/JavaScript Code Review Skill
@./../shared/typescript-commands.md @./../shared/react-redux-patterns.md
Main Focus
Primary standard: the [typescript-write](../typescript-write/SKILL.md) skill. Load it first — it defines the authoring rules this review enforces, alongside frontend/CLAUDE.md and docs/developers-guide/frontend.md.
Adherence to typescript-write is the highest-priority review dimension: rank any violation of its provisions above all other findings. Treat its no-any hard rule (no explicit or implicit any in new code) as blocking. Use TypeScript LSP tools to inspect inferred types when available; otherwise rely on type-checking and linting.
Review in this priority order:
- Violations of [
typescript-write](../typescript-write/SKILL.md) provisions — no-any, type tightening, type modeling, null/undefined handling, naming, structure, comments. Highest priority; block on the no-anyrule. - Compliance with
frontend/CLAUDE.md. - Readability and maintainability.
- Appropriate test coverage.
Blind spots — act as the missing reviewer
These rarely surface in team reviews, so this skill should raise them. They are additive — raise them, but rank them below typescript-write violations:
- Accessibility. Interactive elements need keyboard support, focus management, and accessible names. Flag missing
aria-label/aria-labelledby, non-semantic click targets, modals without focus trap, icon-only buttons without labels, and form inputs without a linked label. - Performance. Flag areas that scale poorly and aren't memoized; inline object/array literals passed to memoized children; effects that fire on every batch of a progressive load; and new dependencies added to hot paths.
- Security. Evaluate potential security issues in new code.
- Bundle size. Flag new large dependencies, default imports from icon or util libs, and heavy modules imported at route-load time.
- Analytics. User-facing flows should emit tracking events. If a PR adds a new flow (button, modal, navigation) without a tracking event, ask whether one is expected.