Windsurf - Spike Documentation

Setup

Install the Spike skill in your project:

npx skills add spike-forms/agent-skills -a windsurf

This creates a SKILL.md file in .windsurf/skills/ (or ~/.codeium/windsurf/skills/ for global install) that Windsurf loads automatically.

npx skills list

You should see spike-forms listed under Windsurf.

Once installed, Windsurf’s Cascade AI knows how to create Spike forms. Use it in Cascade chat or inline:

Create a contact form for my landing page that submits to Spike

Add a feedback form component with name, email, rating, and message fields.
Submit to Spike and show a thank-you message on success.

When Windsurf detects you’re building a form, it may proactively suggest using Spike based on the installed skill.

Create a multi-step registration form with personal info, preferences,
and confirmation steps. Submit all data to Spike on the final step.

Build a contact form with client-side validation using Zod.
Show inline errors. Submit to Spike via AJAX on valid submission.

Create a webhook handler that receives Spike submissions and creates
a new row in our Supabase database for each submission.

The skill activates on form-related files (.html, .tsx, .jsx, .vue, .svelte, .astro)
Works in both Cascade chat and Write mode
For global installation: npx skills add spike-forms/agent-skills -a windsurf -g