Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/windsurf-api-development/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-api-development. Copyright stays with the author (MIT).

Windsurf Api Development

Overview

This skill enables AI-assisted API development workflows within Windsurf. Cascade can generate type-safe API clients from OpenAPI/Swagger specs, create comprehensive API documentation, design REST and GraphQL schemas, and produce SDKs for multiple languages.

Prerequisites

• Windsurf IDE with Cascade enabled
• OpenAPI/Swagger specification or API endpoints
• Target language runtime (Node.js, Python, etc.)
• Understanding of API design patterns
• Documentation requirements defined

Instructions

1. Define API Specification
2. Generate Clients
3. Implement Endpoints
4. Create Documentation
5. Test and Validate

See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed implementation guide.

Output

• Generated API clients (TypeScript, Python, etc.)
• Type definitions and schemas
• API reference documentation
• Quick start guides and examples

Error Handling

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

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for detailed examples.

Resources

• Windsurf API Development
• OpenAPI Specification
• API Design Best Practices