Agent Integration
Windsurf
Top Skills for Windsurf Cascade
Equip Windsurf Cascade with production-grade agent skills. Add anti-slop design, automated SEO plumbing, and git hygiene.
Install KeySkills for Windsurf
$ bunx skills add NaveenGumaste/keyskills -a windsurf.windsurf/skills/Files installed here take effect for this repository and are version-controllable.
~/.codeium/windsurf/skills/Global path used when installed with the -g flag across all projects.
Windsurf Cascade picks up skills in .windsurf/skills/ to calibrate UI aesthetics, commit quality, and project cleanliness.
Included Skills
What Windsurf gains
SEO Setup
Equips autonomous coding agents to automatically generate metadata, OpenGraph cards, sitemap.xml, robots.txt, and JSON-LD schemas during repository init.
Design Taste Frontend
Stops AI agents from outputting generic purple-gradient, rounded-slop interfaces. Enforces editorial typography, calibrated contrast, intentional whitespace, and hardware-accelerated micro-motion.
Git Hygiene
Maintains disciplined git history by enforcing Conventional Commits, branch prefixes, pre-commit safety checks, and atomic changes.
Codebase Cleanup
Cleans up agent debris: scratch scripts, unused imports, orphan test outputs, and temporary benchmark files before finishing tasks.
README Badge Generator
Badge your repository
Show contributors your repo uses high-agency agent skills.
[](https://keyskills.ngxlabs.tech)Common questions for Windsurf
Can I use KeySkills with Windsurf and other tools in the same repo?
Yes. You can pass multiple agent flags like -a windsurf -a cursor or use --agent '*' to populate all configured agent harnesses simultaneously.
Do I need to re-run the install command when opening new sessions?
No. Once installed, the markdown instructions remain in your project's registered skill folder and are loaded automatically whenever Windsurf operates in that directory.