Federico Bartoli
a63f54b8ab
The repository was renamed from swe-skills to agent-skills but internal references were never updated. This caused: - session-start.sh to silently fail (path using-swe-skills/ did not exist; the directory is using-agent-skills/) - slash commands to invoke non-existent swe-skills: namespace - docs and setup guides to point at the old clone URL Rename all occurrences across 14 files: commands, CLAUDE.md, README tree, docs/, and hooks/.
1.4 KiB
1.4 KiB
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:
- Open Windsurf → Settings → AI → Global Rules
- 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
- Be selective — Windsurf's context is limited. Choose skills that address your biggest quality gaps.
- Reference in conversation — Paste additional skill content into the chat when working on specific phases (e.g., paste
security-and-hardeningwhen building auth). - Use references as checklists — Paste
references/security-checklist.mdand ask Windsurf to verify each item.