install guideWindsurf · skillsupdated 2026-09-03 · v1.0.0

Install a skill into Windsurf

Windsurf reads skills from a local skills folder. Add a skill folder and it is picked up for the agent.

Step 1

Find the skills folder

Windsurf uses a skills folder (often .windsurf/skills/) for the project. Create it if needed.

Step 2

Add the skill folder

Copy the whole skill folder (SKILL.md + any references/scripts/assets) into the skills folder.

Step 3

Reload the workspace

Reload Windsurf so it re-scans the skills folder and the new skill becomes available.