Agent skill

soap-to-rest-converter

Convert SOAP web services to REST APIs with WSDL parsing and resource modeling

Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/code-migration-modernization/skills/soap-to-rest-converter

SKILL.md

SOAP to REST Converter Skill

Converts SOAP web services to REST APIs, handling WSDL parsing, operation mapping, and RESTful resource modeling.

Purpose

Enable SOAP modernization for:

  • WSDL parsing
  • Operation-to-endpoint mapping
  • Type conversion
  • Authentication migration
  • REST resource modeling

Capabilities

1. WSDL Parsing

  • Parse WSDL documents
  • Extract operations
  • Map data types
  • Identify bindings

2. Operation-to-Endpoint Mapping

  • Map operations to HTTP methods
  • Design resource URIs
  • Handle parameters
  • Transform responses

3. Type Conversion

  • Convert XML types to JSON
  • Map complex types
  • Handle enumerations
  • Transform arrays

4. Authentication Migration

  • Convert WS-Security
  • Implement OAuth2
  • Migrate certificates
  • Handle API keys

5. SOAP Envelope Removal

  • Strip envelope structure
  • Extract body content
  • Transform headers
  • Handle faults

6. REST Resource Modeling

  • Design resource hierarchy
  • Implement HATEOAS
  • Define link relations
  • Model collections

Tool Integrations

Tool Purpose Integration Method
SOAP UI WSDL analysis GUI
wsdl2rest Conversion CLI
Custom transformers Type mapping Library

Output Schema

json
{
  "conversionId": "string",
  "timestamp": "ISO8601",
  "source": {
    "wsdl": "string",
    "operations": "number"
  },
  "target": {
    "openapi": "string",
    "endpoints": "number"
  },
  "mappings": [
    {
      "soapOperation": "string",
      "restEndpoint": "string",
      "method": "string",
      "notes": "string"
    }
  ],
  "typeConversions": [],
  "manualReview": []
}

Integration with Migration Processes

  • api-modernization: SOAP to REST conversion

Related Skills

  • openapi-generator: REST spec generation
  • api-inventory-scanner: Endpoint discovery

Related Agents

  • api-modernization-architect: API design

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results