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
SKILL.md
View on GitHub---
name: soap-to-rest-converter
description: Convert SOAP web services to REST APIs with WSDL parsing and resource modeling
allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Edit"]
graph:
domains: [domain:software-engineering]
specializations: [specialization:code-migration-modernization]
skillAreas: [skill-area:api-design, skill-area:breaking-change-management]
roles: [role:backend-engineer, role:architect]
workflows: [workflow:technical-debt-reduction]
topics: [topic:refactoring]
---
# 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
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 |