windsurf-workspace-setup

Initialize Windsurf workspace with project-specific AI rules. Activate when users mention"create windsurfrules", "setup workspace", "configure project ai", "initialize windsurf workspace",or "migrate to windsurf". Handles workspace configuration and team standardization.

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

When & Why to Use This Skill

This Claude skill automates the initialization and configuration of Windsurf workspaces by generating project-specific AI rules and editor settings. It streamlines the setup process for developers and teams, ensuring consistent AI behavior through the creation of .windsurfrules, settings.json, and extension recommendations to enhance productivity and maintain coding standards.

Use Cases

  • New Project Onboarding: Rapidly initialize a new repository with tailored .windsurfrules to ensure the AI assistant understands the project architecture and conventions immediately.
  • Team Standardization: Deploy consistent editor configurations and team-wide coding standards across multiple contributors to minimize environment discrepancies.
  • IDE Migration: Simplify the transition to the Windsurf IDE by automating the setup of multi-root workspaces and cross-editor consistency files.
  • AI Behavior Customization: Configure specific rules for AI interactions within a workspace to improve the relevance and accuracy of code generation and debugging.
name"windsurf-workspace-setup"
description|
allowed-tools"Read,Write,Edit,Bash(cmd:*)"
version1.0.0
licenseMIT
author"Jeremy Longshore <jeremy@intentsolutions.io>"

Windsurf Workspace Setup

Overview

This skill enables rapid workspace setup for Windsurf projects. It covers creating .windsurfrules for AI behavior, configuring editor settings, establishing team conventions, and setting up multi-root workspaces. Proper workspace setup ensures consistent AI assistance across all team members and projects.

Prerequisites

  • Windsurf IDE installed
  • Project repository cloned
  • Understanding of project architecture
  • Team conventions documented
  • Admin access for team-wide settings (optional)

Instructions

  1. Create .windsurfrules
  2. Configure Editor Settings
  3. Set Up Extensions
  4. Configure Cross-Editor Consistency
  5. Establish Team Standards

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

Output

  • Configured .windsurfrules file
  • Editor settings.json
  • Extension recommendations
  • Cross-editor configuration files
  • Workspace configuration for monorepos

Error Handling

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

Examples

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

Resources