react-hook-form-audit
Audit existing React Hook Form code for correctness, accessibility, validation, data ownership, submission, dirty-state, field-array, wizard, controlled-widget, and performance problems. Use when reviewing RHF forms, investigating form bugs or rerenders, or checking an RHF-heavy
Install
npx skills add https://github.com/kriscard/Skills/tree/main/skills/dev/react-hook-form-audit
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kriscard-skills@llmmart
git clone https://github.com/kriscard/Skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kriscard/skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
React Hook Form Audit
Audit evidence, not syntax in isolation. A pattern becomes a finding only when its consequence is visible from the code, installed version, or verified runtime behavior.
Process
1. Establish scope and versions
Choose scope from the request before inventorying files. For a targeted bug or change review, include the requested or changed forms and follow their components, schemas, defaults, serializers, mutations, and tests. Inventory every RHF form only for an explicit repository-wide audit. Read project guidance and detect the installed RHF, React, resolver, schema, UI-library, data-fetching, and framework versions.
Completion: the scope is explicit, and every included form has an entry point and its supporting files accounted for.
2. Reconstruct each form contract
For each form, identify:
- form and payload types;
- create/edit and server-data ownership model;
- default-values and dirty baseline;
- native versus controlled adapters;
- validation and error paths;
- conditional, wizard, and field-array behavior;
- submission, success, failure, and reset lifecycle.
Completion: each submitted value can be traced from initialization through serialization.
3. Run the checks
Read references/checks.md completely. Load the bundled mirror of the build skill's canonical
branch reference when the audited form uses that branch:
references/server-data-and-lifecycle.mdreferences/adapters-and-accessibility.mdreferences/wizards-and-conditionals.mdreferences/field-arrays.mdreferences/version-8.mdreferences/actions-boundary.md
Completion: every applicable check and branch rule was evaluated against every in-scope form.
4. Validate findings
Use source and types to distinguish a defect from a heuristic smell. Run the project's TypeScript typecheck; do not modify source to make it pass. Tests are optional—run focused existing tests when they can prove or disprove a suspected behavior. Prefer silence over speculative findings.
Completion: each reported finding has a concrete consequence, file and line, smallest safe direction, and confidence; unrelated typecheck failures are separated.
5. Report
Order findings by user impact:
- Critical: data loss, invalid submission, inaccessible completion, or broken production flow.
- High: likely correctness/reliability failure in a common path.
- Medium: demonstrated performance, maintainability, or UX cost.
- Low: verified local issue with limited impact.
Use:
[Severity] Short title
File: path:line
Evidence: what the code does and the scenario that exposes it
Impact: concrete user or engineering consequence
Direction: smallest safe correction
Confidence: high | medium
Then list forms reviewed, typecheck command/result, tests run or skipped, and residual risks. If no findings survive validation, say so directly.
Hard boundaries
- Remain read-only; report files are allowed only when the user requests one.
- Do not label
watch,Controller,useFormContext, missing defaults,onChange, oruseActionStateas defects without contextual evidence. - Do not claim performance impact without identifying the subscription and rerender boundary or measuring it when measurement is feasible.
- Do not infer App Router client-boundary requirements in Pages Router or non-Next projects.
Files (skills)
-
references
-
actions-boundary.md 1.1 KB
Loading… -
adapters-and-accessibility.md 2.8 KB
Loading… -
checks.md 4.8 KB
Loading… -
field-arrays.md 1.3 KB
Loading… -
server-data-and-lifecycle.md 3 KB
Loading… -
version-8.md 1.1 KB
Loading… -
wizards-and-conditionals.md 2.4 KB
Loading…
-
-
SKILL.md 3.7 KB
--- name: react-hook-form-audit description: >- Audit existing React Hook Form code for correctness, accessibility, validation, data ownership, submission, dirty-state, field-array, wizard, controlled-widget, and performance problems. Use when reviewing RHF forms, investigating form bugs or rerenders, or checking an RHF-heavy change. Read-only; use react-hook-form for implementation. --- # React Hook Form Audit Audit evidence, not syntax in isolation. A pattern becomes a finding only when its consequence is visible from the code, installed version, or verified runtime behavior. ## Process ### 1. Establish scope and versions Choose scope from the request before inventorying files. For a targeted bug or change review, include the requested or changed forms and follow their components, schemas, defaults, serializers, mutations, and tests. Inventory every RHF form only for an explicit repository-wide audit. Read project guidance and detect the installed RHF, React, resolver, schema, UI-library, data-fetching, and framework versions. Completion: the scope is explicit, and every included form has an entry point and its supporting files accounted for. ### 2. Reconstruct each form contract For each form, identify: - form and payload types; - create/edit and server-data ownership model; - default-values and dirty baseline; - native versus controlled adapters; - validation and error paths; - conditional, wizard, and field-array behavior; - submission, success, failure, and reset lifecycle. Completion: each submitted value can be traced from initialization through serialization. ### 3. Run the checks Read `references/checks.md` completely. Load the bundled mirror of the build skill's canonical branch reference when the audited form uses that branch: - `references/server-data-and-lifecycle.md` - `references/adapters-and-accessibility.md` - `references/wizards-and-conditionals.md` - `references/field-arrays.md` - `references/version-8.md` - `references/actions-boundary.md` Completion: every applicable check and branch rule was evaluated against every in-scope form. ### 4. Validate findings Use source and types to distinguish a defect from a heuristic smell. Run the project's TypeScript typecheck; do not modify source to make it pass. Tests are optional—run focused existing tests when they can prove or disprove a suspected behavior. Prefer silence over speculative findings. Completion: each reported finding has a concrete consequence, file and line, smallest safe direction, and confidence; unrelated typecheck failures are separated. ### 5. Report Order findings by user impact: - **Critical:** data loss, invalid submission, inaccessible completion, or broken production flow. - **High:** likely correctness/reliability failure in a common path. - **Medium:** demonstrated performance, maintainability, or UX cost. - **Low:** verified local issue with limited impact. Use: ```text [Severity] Short title File: path:line Evidence: what the code does and the scenario that exposes it Impact: concrete user or engineering consequence Direction: smallest safe correction Confidence: high | medium ``` Then list forms reviewed, typecheck command/result, tests run or skipped, and residual risks. If no findings survive validation, say so directly. ## Hard boundaries - Remain read-only; report files are allowed only when the user requests one. - Do not label `watch`, `Controller`, `useFormContext`, missing defaults, `onChange`, or `useActionState` as defects without contextual evidence. - Do not claim performance impact without identifying the subscription and rerender boundary or measuring it when measurement is feasible. - Do not infer App Router client-boundary requirements in Pages Router or non-Next projects.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.