Skip to content

windsurf-setup.md

Latest commit

 

History

History
48 lines (31 loc) · 1.44 KB

windsurf-setup.md

File metadata and controls

48 lines (31 loc) · 1.44 KB

Using agent-skills with Windsurf

Setup

Project Rules

Windsurf uses .windsurfrules for project-specific agent instructions:

# Create a combined rules file from your most important skills
cat /path/to/agent-skills/skills/test-driven-development/SKILL.md > .windsurfrules
echo "\n---\n" >> .windsurfrules
cat /path/to/agent-skills/skills/incremental-implementation/SKILL.md >> .windsurfrules
echo "\n---\n" >> .windsurfrules
cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md >> .windsurfrules

Global Rules

For skills you want across all projects, add them to Windsurf's global rules:

  1. Open Windsurf → Settings → AI → Global Rules
  2. Paste the content of your most-used skills

Recommended Configuration

Keep .windsurfrules focused on 2-3 essential skills to stay within context limits:

# .windsurfrules
# Essential agent-skills for this project

[Paste test-driven-development SKILL.md]

---

[Paste incremental-implementation SKILL.md]

---

[Paste code-review-and-quality SKILL.md]

Usage Tips

  1. Be selective — Windsurf's context is limited. Choose skills that address your biggest quality gaps.
  2. Reference in conversation — Paste additional skill content into the chat when working on specific phases (e.g., paste security-and-hardening when building auth).
  3. Use references as checklists — Paste references/security-checklist.md and ask Windsurf to verify each item.