creating-windsurf-packages

This skill provides a standardized framework for developers and AI agents to create, maintain, and optimize rules for the Windsurf IDE. Designed for integration within the PRPM ecosystem, it ensures that your project-specific guidelines remain within the hard constraints enforced by Windsurf, specifically the 12,000 character limit and the mandatory single-file structure (.windsurf/rules). It is an essential tool for maintaining high-quality, project-specific context without triggering system errors or exceeding storage budgets.

• Enforces strict compliance with the .windsurf/rules single-file architecture.

• Provides templates for project-specific patterns, tech stack documentation, and coding conventions.

• Offers character optimization strategies to help you prioritize essential information while trimming redundant or generic best practices.

• Facilitates the migration of legacy rule sets into the optimized, frontmatter-free Markdown format required by Windsurf.

• Includes validation workflows to check character counts before implementation.

• Use this skill when initializing a new project or onboarding a new developer to a Windsurf-based workflow.

• Ideal for documenting directory structures, state management (e.g., Zustand), testing patterns (e.g., React Testing Library), and API client configurations.

• Always keep the file structure flat and avoid YAML frontmatter to prevent parsing errors.

• If your rule set approaches the 12,000 character limit, use the provided compression techniques such as linking to external documentation or focusing strictly on delta patterns unique to the codebase.

• Periodically run wc -m .windsurf/rules to monitor your remaining character budget and ensure room for future project growth.

• Best suited for technical leads and engineers who need to ensure that their AI coding assistants stay aligned with specific team standards and architectural requirements.