playbooks

home / skills / jeremylongshore / claude-code-plugins-plus-skills / windsurf-cascade-onboarding

windsurf-cascade-onboarding skill

/plugins/saas-packs/skill-databases/windsurf/skills/windsurf-cascade-onboarding

This skill helps teams onboard Windsurf Cascade projects quickly by configuring context, defaults, and onboarding materials.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill windsurf-cascade-onboarding

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
2.0 KB
---
name: "windsurf-cascade-onboarding"
description: |
  Configure Cascade AI agent for new team projects. Activate when users mention
  "setup cascade", "configure windsurf ai", "initialize cascade agent", "new windsurf project",
  or "onboard team to windsurf". Handles agent configuration, context settings, and team defaults. Use when working with windsurf cascade onboarding functionality. Trigger with phrases like "windsurf cascade onboarding", "windsurf onboarding", "windsurf".
allowed-tools: "Read,Write,Edit,Bash(cmd:*),Grep,Glob"
version: 1.0.0
license: MIT
author: "Jeremy Longshore <[email protected]>"
---

# Windsurf Cascade Onboarding

## Overview

This skill enables rapid onboarding of projects to Windsurf with optimized Cascade AI configuration. It covers creating .windsurfrules, setting up project context, configuring team defaults, and establishing best practices for AI-assisted development. Teams can achieve maximum Cascade productivity within the first week of adoption.

## Prerequisites

- Windsurf IDE installed for all team members
- Active Cascade AI subscription
- Project documentation (architecture, conventions)
- Team lead or admin access for configuration
- Understanding of project structure and patterns

## Instructions

1. **Initialize Windsurf Rules**
2. **Configure Cascade Context**
3. **Set Up Team Defaults**
4. **Train Team Members**
5. **Iterate Based on Feedback**


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

## Output

- Configured .windsurfrules file
- Project context documentation
- Team snippet library
- Onboarding guide for new members

## Error Handling

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

## Examples

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

## Resources

- [Windsurf Onboarding Guide](https://docs.windsurf.ai/getting-started/onboarding)
- [Writing Effective .windsurfrules](https://docs.windsurf.ai/features/windsurfrules)
- [Team Best Practices](https://docs.windsurf.ai/guides/team-best-practices)

Overview

This skill configures Cascade AI for new Windsurf projects to get teams productive quickly. It automates creation of .windsurfrules, sets project context, and applies team defaults so agents behave consistently. The goal is a repeatable onboarding flow that yields usable agent configuration and documentation within days.

How this skill works

The skill inspects project structure and existing docs, then generates a tailored .windsurfrules file and cascade context settings. It provisions team defaults (snippets, permissions, and conventions) and produces a short onboarding guide for new members. It also provides hooks for iterative updates based on team feedback and error reports.

When to use it

  • Starting a new Windsurf project that will use Cascade AI
  • Onboarding a team to Windsurf and standardizing agent behavior
  • When a project lacks agent context, rules, or shared snippet libraries
  • Resetting or reconfiguring Cascade settings after architectural changes
  • Preparing a repo for contributors who need consistent AI workflows

Best practices

  • Collect project architecture and coding conventions before running onboarding
  • Assign an admin or team lead to approve default rules and access controls
  • Start with conservative Cascade rules and iterate from real usage data
  • Include representative examples in the project context to guide agent replies
  • Train team members on the onboarding guide and snippet usage during the first week

Example use cases

  • Initialize .windsurfrules and context for a microservices repo to enforce service boundaries
  • Create team snippet library and defaults for a frontend app to speed up common tasks
  • Reconfigure Cascade after adding a new platform or changing CI/CD pipelines
  • Onboard contractors with a single command that sets up agent context and permissions

FAQ

What prerequisites are required before running this onboarding?

Ensure the Windsurf IDE is installed for team members, an active Cascade subscription exists, and a team lead can approve configuration changes.

What outputs will I get after running the skill?

You receive a configured .windsurfrules file, project context docs, a team snippet library, and a short onboarding guide for future members.