a5c-ai/babysitter / library/specializations/code-migration-modernization/skills/soap-to-rest-converter
soap-to-rest-converter
VerifiedConvert SOAP web services to REST APIs with WSDL parsing and resource modeling
README.md
View on GitHub# SOAP to REST Converter Skill
## Overview
The SOAP to REST Converter skill modernizes SOAP web services to REST APIs. It parses WSDL documents and generates RESTful endpoint designs.
## Quick Start
### Prerequisites
- WSDL document
- Understanding of operations
- REST design principles
### Basic Usage
1. **Parse WSDL**
- Extract operations
- Map data types
- Identify endpoints
2. **Design REST resources**
- Map operations to methods
- Design URI structure
- Model resources
3. **Generate implementation**
- Create OpenAPI spec
- Implement endpoints
- Set up adapters
## Features
### Operation Mapping
| SOAP Pattern | REST Equivalent |
|--------------|-----------------|
| getUser | GET /users/{id} |
| createUser | POST /users |
| updateUser | PUT /users/{id} |
| deleteUser | DELETE /users/{id} |
| listUsers | GET /users |
### Type Conversions
- XML complex types -> JSON objects
- XML arrays -> JSON arrays
- XSD types -> JSON Schema
- Enumerations -> enums
## Configuration
```json
{
"source": {
"wsdl": "./service.wsdl"
},
"target": {
"format": "openapi-3.0",
"output": "./rest-api"
},
"options": {
"preserveOperationNames": false,
"generateExamples": true,
"authMigration": "oauth2"
}
}
```
## Related Documentation
- [SKILL.md](./SKILL.md) - Full skill specification
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |