windsurf-cascade-agents

Create custom Cascade agent configurations for specialized tasks. Activate when users mention"custom cascade agent", "specialized ai agent", "domain-specific cascade", "agent configuration",or "custom ai behavior". Handles custom agent creation and configuration.

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026⬇️1downloads

When & Why to Use This Skill

The Windsurf Cascade Agents skill empowers developers to build, configure, and deploy specialized AI agents tailored for specific project domains. By defining custom system prompts, activation triggers, and specialized context sources, it transforms the general-purpose Cascade assistant into a fleet of domain experts. This skill is essential for teams looking to automate complex workflows like security auditing, API standardization, and performance tuning within the Windsurf IDE environment.

Use Cases

  • Automated Security Auditing: Create a specialized agent configured with deep security domain knowledge to perform continuous code reviews and identify vulnerabilities.
  • API Design Consistency: Configure an agent that enforces organizational RESTful standards and project-specific conventions during the development of new endpoints.
  • Performance Optimization: Deploy a dedicated agent focused on identifying code bottlenecks and suggesting optimizations based on specific runtime requirements.
  • Technical Documentation Management: Set up an agent with access to project style guides to automatically generate and update documentation that matches the project's voice and structure.
name"windsurf-cascade-agents"
description|
allowed-tools"Read,Write,Edit,Bash(cmd:*),Grep,Glob"
version1.0.0
licenseMIT
author"Jeremy Longshore <jeremy@intentsolutions.io>"

Windsurf Cascade Agents

Overview

This skill enables creation of specialized Cascade agents tailored for specific domains or tasks. Custom agents can be configured with domain knowledge, specialized prompts, and focused capabilities. Use cases include security review agents, API design agents, performance optimization agents, and documentation writers that understand your project's specific conventions and requirements.

Prerequisites

  • Windsurf IDE with Cascade Pro or Enterprise
  • Understanding of prompt engineering principles
  • Domain knowledge to encode in agent context
  • Project documentation and conventions documented
  • Test scenarios for agent validation

Instructions

  1. Define Agent Purpose
  2. Create System Prompt
  3. Configure Context Sources
  4. Set Activation Triggers
  5. Test and Refine

See {baseDir}/references/implementation.md for detailed implementation guide.

Output

  • Custom agent configurations in registry
  • Domain-specific system prompts
  • Context files with specialized knowledge
  • Activation trigger mappings

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources