w-form — Claude Code skill for Next.js forms and setup
The w-form Claude Code skill guides form work in a Next.js app through the mutation path the project already uses. Invoke it to build a form.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a claude-codeWhat w-form does
w-form lays out a workflow for adding a form to the current Next.js app. It starts by examining nearby forms and reusing their submission path. One Zod schema serves both client-side feedback and server validation.
The skill calls for accessible labels, error messages, pending status, and empty, error, and success states built with existing UI primitives. It also asks to run lint and test submission, validation failure, and keyboard use. When an API client such as Fastify with TanStack Query handles mutations, the skill rules out Server Actions, useFormStatus, and useOptimistic for those flows. If behavior or commands change, it points to /w-docs for documentation updates.
What it helps with
- add a form to a Next.js app
- reuse the submission path of nearby forms
- share Zod validation between client and server
- test form submission and keyboard interaction
Example prompts for the agent
- Build a form in the Next.js app following nearby forms.
- Use one Zod schema for client feedback and server validation.
- Test submission, validation errors, and keyboard interaction.
How to install w-form
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a claude-code2Manually: put the files in place
~/.claude/skills/w-form/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-form/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a codex2Manually: put the files in place
.agents/skills/w-form/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a cursor2Manually: put the files in place
.cursor/skills/w-form/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-form2Manually: put the files in place
.github/skills/w-form/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-formManually: put the files in place
.devin/skills/w-form/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-form -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 w-form
How do I install w-form in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-form -a claude-code. The skill file is at ~/.claude/skills/w-form/SKILL.md.
What does w-form do?
It guides form implementation in a Next.js app, reusing the app's submission route and sharing a Zod schema across client and server validation. It also covers interface states and keyboard testing.
What does w-form require when the app uses Fastify and TanStack Query?
For mutation flows handled by an API client using Fastify and TanStack Query, the skill says not to add Server Actions, useFormStatus, or useOptimistic.
Source text
SKILL.md · MIT
--- name: w-form description: Build a Next.js form using the app's existing mutation path, not a second stack. disable-model-invocation: true --- Implement a form in the current Next app. Follow `next-v16` and `shadcn-v3`. If the app already mutates through an API client (Fastify + TanStack Query), do not introduce Server Actions, `useFormStatus`, or `useOptimistic` for those flows. 1. Inspect how neighboring forms submit. Reuse that path. 2. Share one Zod schema for client UX and server validation. 3. Wire accessible labels, errors, pending, and empty/error/success states with existing UI primitives. 4. Run lint and exercise submit, validation failure, and keyboard path. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills