air

AI Agents for Windsurf

AI-powered IDE by Codeium

Windsurf reads agents from the .agents/agents/ directory using the Agent Skills specification. Its Cascade feature provides multi-step AI workflows that work well with specialized agent definitions. Browse 32 agents on Agent Shelf, all compatible with Windsurf.

rocket_launchHow to use agents in Windsurf

Copy or download the agent .md file

Place it in .agents/agents/ in your project root

Windsurf auto-discovers agents from this directory

Use Cascade or chat to invoke the agent's capabilities

Agent directory: .agents/agents/

hubMCP server for Windsurf

Connect Windsurf to Agent Shelf via MCP to search and download agents without leaving your editor. Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agentshelf": {
      "type": "http",
      "url": "https://www.agentshelf.dev/api/mcp"
    }
  }
}

Once connected, Windsurf can search agents, read details, and download Markdown files directly from Agent Shelf. Full MCP setup guide

check_circleWindsurf capabilities

check

Auto-discovers agents from .agents/agents/

check

Cascade multi-step AI workflows

check

Supports .windsurfrules for project instructions

check

Full codebase indexing and context

check

MCP server integration

check

Agent Skills spec compatible

trending_upPopular agents

View allarrow_forward

terminal

Coding

Database Architect

Designs database schemas, writes optimized queries, plans migrations, and advises on database selection and scaling strategies for application data needs.

databasesqlschema-design+3

Security Auditor

Performs security audits on codebases, dependencies, and infrastructure. Identifies vulnerabilities, suggests fixes, and helps achieve compliance with OWASP, SOC 2, and GDPR standards.

securityauditvulnerability+4

Changelog Writer

Generates clear, user-facing changelogs from git history, pull requests, and commit messages. Categorizes changes and writes release notes that users actually read.

changelogrelease-notesdocumentation+3

UI/UX Designer

Designs user interfaces, creates component specifications, builds design systems, and provides UX feedback. Generates accessible, responsive layouts following Material Design and modern design principles.

Brand Copywriter

Crafts brand messaging, taglines, value propositions, and website copy that captures a company's voice and resonates with target audiences.

brandingcopywritingmessaging+2

Incident Responder

Guides teams through production incidents with structured response procedures, root cause analysis, remediation steps, and post-incident review facilitation.

incident-responseproductionoutage+3