# Windsurf Skill Pack

> Master Windsurf IDE by Codeium — Cascade agentic AI, Supercomplete, Workflows, Rules, and enterprise deployment (30 skills)

Windsurf is an AI-powered code editor built on VS Code with Cascade (agentic multi-file editing), Supercomplete (intent-aware autocomplete), Workflows (reusable automation), and deep codebase indexing. This pack covers everything from first install to 1000-developer enterprise rollout.

## Installation

```bash
/plugin install windsurf-pack@claude-code-plugins-plus
```

## Skills Included

### Standard Skills (S01-S12)

| Skill | What It Does |
|-------|-------------|
| `windsurf-install-auth` | Install Windsurf IDE, authenticate with Codeium, select AI models |
| `windsurf-hello-world` | First Cascade interaction, Supercomplete, Command mode, @ mentions |
| `windsurf-local-dev-loop` | Dev workflow with Turbo mode, Previews, terminal AI, .windsurfrules |
| `windsurf-sdk-patterns` | .windsurfrules, workspace rules with triggers, MCP server config |
| `windsurf-core-workflow-a` | Cascade Write mode: multi-file agentic coding with checkpoints |
| `windsurf-core-workflow-b` | Workflows (slash commands), Memories, reusable automation |
| `windsurf-common-errors` | Diagnose Cascade failures, Supercomplete issues, indexing problems |
| `windsurf-debug-bundle` | Collect diagnostic data for Windsurf support tickets |
| `windsurf-rate-limits` | Credit system, per-model costs, conservation strategies |
| `windsurf-security-basics` | .codeiumignore, telemetry controls, secret protection |
| `windsurf-prod-checklist` | Team rollout checklist, onboarding script, monitoring setup |
| `windsurf-upgrade-migration` | Upgrade Windsurf, migrate from VS Code or Cursor |

### Pro Skills (P13-P18)

| Skill | What It Does |
|-------|-------------|
| `windsurf-ci-integration` | CI gates for .windsurfrules, AI code quality checks in GitHub Actions |
| `windsurf-deploy-integration` | Deploy from Windsurf: Netlify native, Vercel, Cloud Run, Cascade workflows |
| `windsurf-webhooks-events` | Build Windsurf extensions with VS Code API, event tracking |
| `windsurf-performance-tuning` | Indexing optimization, .codeiumignore, Cascade speed tuning |
| `windsurf-cost-tuning` | Seat utilization audit, tier matching, ROI per seat, credit budgeting |
| `windsurf-reference-architecture` | Complete project structure optimized for Cascade AI |

### Flagship Skills (F19-F24)

| Skill | What It Does |
|-------|-------------|
| `windsurf-multi-env-setup` | Configure per-service rules, monorepo strategy, team onboarding |
| `windsurf-observability` | Admin Dashboard analytics, adoption metrics, productivity tracking |
| `windsurf-incident-runbook` | Triage AI-caused bugs, service outages, rollback procedures |
| `windsurf-data-handling` | Data privacy, .codeiumignore for compliance, Codeium data model |
| `windsurf-enterprise-rbac` | SSO/SAML, RBAC, seat management, org-wide AI policies |
| `windsurf-migration-deep-dive` | Full migration from Cursor/VS Code, feature comparison, team rollout plan |

### Flagship+ Skills (X25-X30)

| Skill | What It Does |
|-------|-------------|
| `windsurf-advanced-troubleshooting` | Layer isolation, context debugging, MCP diagnostics, nuclear reset |
| `windsurf-load-scale` | 50-1000+ developer rollout, monorepo partitioning, config distribution |
| `windsurf-reliability-patterns` | Git checkpointing, incremental scoping, validation gates, team safety policy |
| `windsurf-policy-guardrails` | Terminal safety (Turbo allow/deny), code review gates, usage policies |
| `windsurf-architecture-variants` | Workspace strategies: solo, monorepo, multi-window, polyglot |
| `windsurf-known-pitfalls` | Top 10 Windsurf gotchas every developer should know |

## Key Concepts

| Windsurf Feature | What It Is |
|-----------------|------------|
| **Cascade** | Agentic AI assistant — Write mode edits files, Chat mode answers questions |
| **Supercomplete** | Intent-aware inline completions (press Tab) — free on all plans |
| **Command** | Inline code editing (Cmd/Ctrl+I) — select code, describe change |
| **.windsurfrules** | Project context file at repo root — highest-impact config for AI quality |
| **.codeiumignore** | Files excluded from AI indexing — gitignore syntax |
| **Workflows** | Reusable multi-step automation saved as markdown, invoked via slash commands |
| **Memories** | Persistent facts across Cascade sessions — auto-generated or manual |
| **Previews** | In-IDE web app preview with element selection — click to send to Cascade |
| **Turbo Mode** | Auto-execute terminal commands with allow/deny safety lists |
| **MCP** | Model Context Protocol — connect external tools (GitHub, databases) to Cascade |

## Usage

Skills trigger automatically when you discuss Windsurf topics. For example:

- "Help me set up Windsurf" triggers `windsurf-install-auth`
- "Cascade is slow" triggers `windsurf-performance-tuning`
- "Deploy from Windsurf" triggers `windsurf-deploy-integration`
- "Set up Windsurf for my team" triggers `windsurf-multi-env-setup`

## License

MIT
