Skip to content
Skillv1.0.0

windsurf-api-development

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 d

by jeremylongshore(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-api-d60442/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-windsurf-api-d60442.ocm.jsonjson
{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-windsurf-api-d60442",
  "kind": "skill",
  "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\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "saas",
      "skill-databases",
      "api",
      "workflow",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/windsurf-api-development/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/windsurf-api-development/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/windsurf-api-development/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,Write,Edit,Bash(cmd:*),Grep"
    ],
    "license": "MIT"
  },
  "instructions": "# Windsurf Api Development\n\n## Overview\n\nThis 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.\n\n## Prerequisites\n\n- Windsurf IDE with Cascade enabled\n- OpenAPI/Swagger specification or API endpoints\n- Target language runtime (Node.js, Python, etc.)\n- Understanding of API design patterns\n- Documentation requirements defined\n\n## Instructions\n\n1. **Define API Specification**\n2. **Generate Client",
  "cost": {
    "context_tokens": 337
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-windsurf-api-d60442/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.