Frontend quality reviewer
Skill ytvee-dev/webdev-agent-kit/skills/frontend-quality-reviewer
A cross-platform frontend kit for Codex, Claude Code, Cursor, OpenCode, etc. It helps AI coding agents work predictably and safely with existing frontend projects.
npx -y skills add ytvee-dev/webdev-agent-kit --skill frontend-quality-reviewerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Review frontend quality from evidence across code, UI, architecture, TypeScript, security, performance, verification, decomposition, UX, and anti-slop concerns. Returns pass, concerns, or fail without implementing unrequested fixes.
SKILL.md
10.3 KB, as published. Nobody here has run it
Frontend Quality Reviewer
Purpose
Review frontend work for correctness, maintainability, decomposition, security, performance, TypeScript safety, architecture fit, visual quality, UX gates, verification honesty, and independent loop judgment without turning review findings into an unapproved rewrite.
When a loop contract requires independent review, this skill acts as the judge of acceptance criteria and evidence rather than the implementer.
When To Use
Use this skill when:
- the user asks for review, audit, critique, or quality check;
- a significant frontend implementation needs a final quality pass;
- a bugfix or refactor has broad impact and review is appropriate;
- a loop contract requires independent review;
- verification failed and was repaired during a loop;
- claims about security, performance, architecture, decomposition, visual fidelity, UX, or verification need evidence.
When Not To Use
Do not use this skill for direct implementation, bugfixing, refactoring, design spec writing, visual QA only, test creation, package installation, or broad rewrites.
If review finds required fixes, report them first. Do not apply fixes unless the user asked for a combined review-and-fix task or explicitly approves a follow-up fix.
Required Context
- Read
AGENTS.md. - Read
common/review-severity-model.md. - Read
common/independent-review-rules.mdwhen acting as loop judge or independent reviewer. - Read the current Goal Contract, Execution Plan, coverage map, and stable identifiers when the work uses durable planning.
- Read
common/verification-loop-rules.mdwhen loop attempts or verification evidence are in scope. - Read
common/approved-patterns.mdandcommon/anti-patterns.mdwhen reviewing changed components. - Read
common/ui-ux-priority-checklist.mdwhen reviewing rendered UI or user interaction. - Read conditional UX rules only when the changed surface includes them:
common/css-modules-specificity-rules.mdfor CSS Modules changes;common/form-feedback-rules.mdfor forms and feedback states;common/navigation-ux-rules.mdfor navigation and route flows;common/data-visualization-rules.mdfor dashboards, charts, tables, metrics, or reports;common/icon-quality-rules.mdfor icons or visual symbols;common/mobile-responsive-rules.mdfor responsive surfaces.
- Read
common/typescript-discipline.mdfor TypeScript surfaces. - Read
common/security-review-rules.mdwhen auth, secrets, unsafe HTML, redirects, external input, or permissions are in scope. - Read
common/performance-review-rules.mdwhen performance claims are in scope. - Read
common/build-tool-boundary-rules.mdandcommon/lint-verification-rules.mdwhen code changed. - Read affected source files, diffs, project overlays, loop contract, verification output, and rendered evidence needed for the review.
Tool Contract
- May inspect diffs, affected files, project overlays, loop contracts, and verification output.
- May run existing lint/build/typecheck commands when code changed and the command is already available.
- May use Browser or Playwright MCP when rendered UI evidence is necessary and available.
- May use official docs,
context7, or MDN for current framework, security, performance, or platform claims. - Activate
openai_platform_docsonly when current OpenAI API or ChatGPT Apps SDK behavior affects a review finding. - Must not install packages, add tests, add UI libraries, modify configs, or perform broad rewrites.
- Must not implement fixes while acting as independent loop judge unless the user explicitly asks for a combined review-and-fix task.
- Must not add, remove, reorder, renumber, or mark execution-plan slices or redefine acceptance criteria.
Workflow
- Define review scope and changed surfaces.
- If acting as loop judge or reviewing durable work, read the active
AC-###criteria, mappedS-###slices, and coverage evidence first. - Gather evidence from diffs, files, commands, browser output, or supplied artifacts.
- Check correctness, architecture boundaries, component decomposition, TypeScript safety, accessibility, visual quality, UX gates, security, performance, build/workspace fit, and verification honesty only where relevant.
- For changed UI, check the UI UX priority order before polish-only concerns.
- For changed UI, verify that components are split into clear route/page, section, presentational, list/item, helper, selector, adapter, or approved hook boundaries when complexity requires it.
- Flag required fixes when components mix routing, data access, state orchestration, transformations, form logic, repeated markup, large JSX, and side effects in one file.
- Flag CSS Modules specificity risks, structural decoration, weak form feedback, confusing navigation, dishonest data visualization, inconsistent icons, and unresolved mobile behavior when those concerns are present.
- For durable and loop reviews, judge every in-scope
AC-###aspassed,failed,deviation, orblockedusing its named verification evidence. - Assign severity labels:
blocking,high,medium,low,nit, orpraise. - Distinguish required fixes from optional improvements.
- Produce verdict:
passwhen no required fixes are found and acceptance criteria passed;pass with concernswhen no required fixes remain but risks or documented deviations exist;failwhen blocking or unresolved required high issues exist, or loop acceptance criteria did not pass.
- Report remaining work as findings. Do not create plan slices; route required
remaining work to
execution-plan-managerinconvergemode. - Check lint result when code changed and a lint command exists.
- Report unknowns and blocked checks honestly.
Output Contract
Final response: return only facts that affect the user's understanding, confidence, or next action. Omit empty fields and workflow narration.
Return findings first, ordered by severity:
Verdict:
Loop acceptance:
Criteria reviewed: AC-### -> passed | failed | deviation | blocked
Coverage evidence:
Required fixes:
Optional improvements:
Decomposition review:
UX gates reviewed:
Evidence checked:
Lint/build/visual verification:
Unknowns or blocked checks:
Praise:
Use file and line references for code findings whenever available.
Validation Gates
- Every blocking or high claim must cite concrete evidence.
- Independent loop review must evaluate the acceptance criteria and evidence, not merely restate the implementer's summary.
- Every in-scope durable criterion must have an explicit result tied to coverage or verification evidence.
- Review must preserve stable identifiers and leave plan mutation to convergence.
- Review must not trigger broad rewrite by itself.
- Required fixes and optional improvements must be separate.
- Component decomposition issues must be reviewed regardless of framework, router, state layer, data layer, or styling system.
- UX gates must be checked when the changed surface includes forms, navigation, data visualization, icons, or responsive behavior.
- Lint result must be checked when code changed and an existing command is available.
- Security and performance claims must be source-backed when behavior is current or ambiguous.
- No testing workflow, UI library, package install, or framework migration may be introduced by default.
Trigger Evals
Should trigger:
- "Review this frontend change before I merge it."
- "Check this implementation for AI slop and quality issues."
- "Audit the TypeScript, performance, and accessibility risks here."
- "Give me a pass/fail verdict on this UI implementation."
- "Check whether this component should be split."
- "Act as the independent reviewer for this loop contract."
Should not trigger:
- "Fix this bug."
- "Refactor this component."
- "Run visual QA only."
- "Create tests for this feature."
Reference Map
common/review-severity-model.mdcommon/independent-review-rules.mdcommon/planning-rules.mdcommon/convergence-rules.mdcommon/verification-loop-rules.mdcommon/approved-patterns.mdcommon/anti-patterns.mdcommon/ui-ux-priority-checklist.mdcommon/css-modules-specificity-rules.mdcommon/form-feedback-rules.mdcommon/navigation-ux-rules.mdcommon/data-visualization-rules.mdcommon/icon-quality-rules.mdcommon/mobile-responsive-rules.mdcommon/security-review-rules.mdcommon/performance-review-rules.mdcommon/typescript-discipline.mdcommon/build-tool-boundary-rules.mdcommon/lint-verification-rules.md