form-refactorer — Claude Code skill: React form refactoring
form-refactorer rewrites legacy forms to Field components from Redpanda UI Registry with Zod validation and react-hook-form state management.
no license 1 installs ★ 4,353 updated 2026-10-29
npx skills add redpanda-data/console --skill form-refactorer -a claude-codeWhat form-refactorer does
The skill replaces outdated form patterns with a structured architecture: Field, FieldLabel, FieldError components instead of legacy wrappers, Zod schemas instead of Yup, zodResolver to wire up react-hook-form. It includes a verification checklist (whether every FieldLabel has htmlFor, whether errors render via FieldError, whether Yup is gone) and code patterns for vertical and horizontal field layouts.
Handles dynamic fields, field arrays and multi-section forms via FieldSet and FieldLegend. No FFmpeg or Python needed — this is pure React refactoring. Triggers: requests to modernize forms, migrate to Field components, or replace legacy patterns.
What it helps with
- rewrite a form using Field components and Zod
- replace Yup schemas with Zod and zodResolver
- group related fields semantically with FieldSet
- render validation errors via FieldError
- remove deprecated Form imports and legacy wrappers
Example prompts for the agent
- Update the topic creation form: use
Field,FieldLabel,FieldErrorand Zod for validation - Refactor the settings form — replace old components with
FieldSetandreact-hook-form - Rewrite the signup form: add
FieldDescription,FieldSeparatorand a Zod schema
How to install form-refactorer
1Skills CLI (Vercel)
npx skills add redpanda-data/console --skill form-refactorer -a claude-code2Manually: put the files in place
~/.claude/skills/form-refactorer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/form-refactorer/
1Skills CLI (Vercel)
npx skills add redpanda-data/console --skill form-refactorer -a codex2Manually: put the files in place
.agents/skills/form-refactorer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add redpanda-data/console --skill form-refactorer -a cursor2Manually: put the files in place
.cursor/skills/form-refactorer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install redpanda-data/console frontend/.claude/skills/form-refactorer2Manually: put the files in place
.github/skills/form-refactorer/SKILL.md1Skills CLI (Vercel)
npx skills add redpanda-data/console --skill form-refactorer -a gemini-cli2Platform CLI
gemini skills install https://github.com/redpanda-data/console --path frontend/.claude/skills/form-refactorerManually: put the files in place
.devin/skills/form-refactorer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add redpanda-data/console --skill form-refactorer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about form-refactorer
How to install form-refactorer in Claude Code?
Run npx skills add redpanda-data/console --skill form-refactorer -a claude-code, the skill lands in ~/.claude/skills/form-refactorer/SKILL.md.
What does form-refactorer do?
It rewrites React forms to modern Field components from Redpanda UI Registry, replaces Yup with Zod, adds react-hook-form and verifies pattern compliance via a checklist.
Which patterns does form-refactorer consider legacy?
The legacy Form component from components/redpanda-ui/components/form, Yup schemas, forms without FieldLabel and htmlFor, error rendering without FieldError and data-invalid.