jeremylongshore

windsurf-api-development

@jeremylongshore/windsurf-api-development
jeremylongshore
1,004
123 forks
Updated 1/18/2026
View on GitHub

Generate API clients and documentation with Cascade. Activate when users mention "generate api client", "api documentation", "openapi generation", "sdk generation", or "api integration". Handles API development workflows. Use when working with APIs or building integrations. Trigger with phrases like "windsurf api development", "windsurf development", "windsurf".

Installation

$skills install @jeremylongshore/windsurf-api-development
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathplugins/saas-packs/skill-databases/windsurf/skills/windsurf-api-development/SKILL.md
Branchmain
Scoped Name@jeremylongshore/windsurf-api-development

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: "windsurf-api-development" description: | Generate API clients and documentation with Cascade. Activate when users mention "generate api client", "api documentation", "openapi generation", "sdk generation", or "api integration". Handles API development workflows. Use when working with APIs or building integrations. Trigger with phrases like "windsurf api development", "windsurf development", "windsurf". allowed-tools: "Read,Write,Edit,Bash(cmd:*),Grep" version: 1.0.0 license: MIT author: "Jeremy Longshore jeremy@intentsolutions.io"

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. It accelerates API development from design through implementation to documentation.

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 {baseDir}/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 {baseDir}/references/errors.md for comprehensive error handling.

Examples

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

Resources

More by jeremylongshore

View all
rabbitmq-queue-setup
1,004

Rabbitmq Queue Setup - Auto-activating skill for Backend Development. Triggers on: rabbitmq queue setup, rabbitmq queue setup Part of the Backend Development skill category.

model-evaluation-suite
1,004

evaluating-machine-learning-models: This skill allows Claude to evaluate machine learning models using a comprehensive suite of metrics. It should be used when the user requests model performance analysis, validation, or testing. Claude can use this skill to assess model accuracy, precision, recall, F1-score, and other relevant metrics. Trigger this skill when the user mentions "evaluate model", "model performance", "testing metrics", "validation results", or requests a comprehensive "model evaluation".

neural-network-builder
1,004

building-neural-networks: This skill allows Claude to construct and configure neural network architectures using the neural-network-builder plugin. It should be used when the user requests the creation of a new neural network, modification of an existing one, or assistance with defining the layers, parameters, and training process. The skill is triggered by requests involving terms like "build a neural network," "define network architecture," "configure layers," or specific mentions of neural network types (e.g., "CNN," "RNN," "transformer").

oauth-callback-handler
1,004

Oauth Callback Handler - Auto-activating skill for API Integration. Triggers on: oauth callback handler, oauth callback handler Part of the API Integration skill category.