Teach Windsurf new skills 8 skills
Windsurf: Agent Skills (.windsurf/skills/ (or ~/.codeium/windsurf/skills/) ), MCP servers, and rules/instructions files.
Where: https://docs.windsurf.com/windsurf/cascade/skills
Skills MCP
🛡 Stay safe Read first
Official first — from the AI maker or the service’s own GitHub org / domain. Read SKILL.md and any scripts before installing. Skills can run code with your permissions. Never paste base64 or “curl … | sh” download-and-run lines from a skill.
Scan installed skills (free scanner by Snyk):
uvx snyk-agent-scan@latest <skills-folder> Copy
Real incidents: ClawHavoc (341+ malicious skills) · Snyk ToxicSkills (76 / 3,984) · fake postmark-mcp
Agent Skills in Windsurf 🟢 Official
Drop SKILL.md folders into .windsurf/skills/ (or ~/.codeium/windsurf/skills/) .
Skills
Create .windsurf/skills/ (or ~/.codeium/windsurf/skills/) <skill-name>/SKILL.md (or install with npx skills add <repo> -a <agent>)
⚠️ Skills can include scripts. Snyk's ToxicSkills study (Feb 2026) scanned 3,984 skills from ClawHub and skills.sh and confirmed 76 malicious ones; scan with `uvx snyk-agent-scan@latest <skills-folder>` before trusting community skills.
Can run code Reads your files
Anthropic example & document skills 🔵 Vendor-official
docx, pdf, pptx, xlsx creation/editing, skill-creator, mcp-builder, frontend-design, webapp-testing, canvas-design and more (19 skills).
Skills ★ 197k License: see repo updated 2 days ago
npx skills add anthropics/skills --skill skill-creator -a windsurf Copy
⚠️ Published by Anthropic but marked 'demonstration and educational'; document skills are source-available (not open source).
Can run code Reads your files
Context7 (up-to-date library docs) 🔵 Vendor-official
Pulls current, version-specific documentation for libraries so code isn't based on stale training data.
MCP ★ 65k MIT updated 1 day ago
choose this agent when prompted
⚠️ Vendor-official (Upstash). Sends your library queries to Context7's service.
Can run code Reads your files
Chrome DevTools MCP 🔵 Vendor-official
Debug pages: console, network, performance traces, screenshots in Chrome.
MCP ★ 58k Apache-2.0 updated 1 day ago
Add to Windsurf → Cascade → MCP → View raw config (mcp_config.json) → "mcpServers":
"chrome-devtools": {"command":"npx","args":["-y","chrome-devtools-mcp@latest"]} Copy
⚠️ Official Chrome DevTools team. Exposes the browser's content to the AI; avoid profiles with sensitive sessions.
Can run code Reads your files
Playwright MCP (browser control) 🔵 Vendor-official
Open web pages, click, fill forms and test sites in a real browser via accessibility snapshots.
MCP ★ 39.8k Apache-2.0 updated 2 days ago
Add to Windsurf → Cascade → MCP → View raw config (mcp_config.json) → "mcpServers":
"playwright": {"command":"npx","args":["@playwright/mcp@latest"]} Copy
⚠️ Official Microsoft server. It can browse logged-in sites in the browser profile it uses; prefer a separate profile.
Can run code Reads your files
GitHub MCP server 🔵 Vendor-official
Read/search repos, issues, PRs, Actions; create issues and PRs on your behalf.
MCP ★ 34.5k MIT updated 2 days ago
Add to Windsurf → Cascade → MCP → View raw config (mcp_config.json) → "mcpServers":
"github": {"url":"https://api.githubcopilot.com/mcp/"} Copy OAuth or GitHub PAT header
⚠️ Official GitHub server. Give the token/OAuth the smallest scopes you need; write actions are real.
Reads your files Acts on your account
Superpowers (obra)
A disciplined dev workflow: brainstorm → plan → TDD → subagent execution → code review.
Skills ★ 319k MIT updated 15 days ago
npx skills add obra/superpowers -a windsurf Copy
⚠️ Community-made: read SKILL.md / scripts before installing; skills can run code with your user permissions.
Can run code
Trail of Bits security skills
Security auditing skills: static analysis, smart-contract review, fuzzing helpers.
Skills ★ 8.2k CC-BY-SA-4.0 updated 6 days ago
npx skills add trailofbits/skills -a windsurf Copy
⚠️ From a well-known security firm; still community (not vendor of this AI). License CC-BY-SA-4.0.
Can run code
No skills match these filters. Show all
Stars, license and last update come from GitHub (17 Nov 2026). Commands are copied from official docs and are not tested on a real machine yet. Access tags are our summary — always check the source. Skills for every AI →