Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-form -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/w-form/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-form/

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

Similar skills

SKILL.md skills catalog →

From the same set45

The whole set →
w-errors w-errors — a Claude Code skill that adds error handling in line with a repository’s conventions. Invoke it explicitly while changing code. CX Codex +1 647installs w-refactor The w-refactor Claude Code skill restructures selected code while preserving its behavior. It starts by recording a baseline with tests, type checks, or a manual scenario. CX Codex +1 647installs w-perf The w-perf Claude Code skill measures project performance and locates bottlenecks. It runs on requests to investigate slow code or improve performance. CX Codex +1 647installs w-a11y The w-a11y Claude Code skill checks UI accessibility against a repository’s docs and tests. It reports findings by default and changes code only when asked to fix issues. CX Codex +1 647installs w-v0 The w-v0 Claude Code skill drafts a v0.dev prompt from the current file, selection, and project stack. It opens the generated link only after OPEN. CX Codex +1 647installs w-shadcn The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui. CX Codex +1 647installs w-ui w-ui — a Claude Code skill for building or reshaping user-facing interfaces around a project’s existing tokens and accessible interactions. It checks rendered screens on desktop and mobile. CX Codex +1 647installs w-diagram The w-diagram Claude Code skill turns code, architecture, or data flows into Mermaid diagrams. For product and architecture requests, it compares named MDX or DESIGN.md files with the code. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open