Skip to main content
Windsurf (by Codeium) reads skills from .windsurf/skills and MCP config from ~/.codeium/windsurf/mcp_settings.json.

Paths

ResourcePath
Project skills.windsurf/skills
Global skills~/.codeium/windsurf/skills
MCP config~/.codeium/windsurf/mcp_settings.json
Audit search (project).windsurf/skills, .agents/skills, .github/skills, .claude/skills
Audit search (global)~/.codeium/windsurf/skills, ~/.agents/skills, ~/.copilot/skills
Package-manager search~/.windsurf/extensions

Skills example

gaal.yaml
skills:
  - source: anthropics/skills
    agents: [windsurf]
    select: [frontend-design]

MCP example

gaal.yaml
mcps:
  - name: filesystem
    target: ~/.codeium/windsurf/mcp_settings.json
    inline:
      command: uvx
      args: [mcp-server-filesystem, ~/projects]

Configure skills

Configure MCP servers