Skill Details
Runtime
(claude-5-5-sonnet)
Example user message
[userMessage]: Validate this OpenAPI JSON schema and identify any design issues: {"type": "object", "properties": {"email": {"type": "string"}, "age": {"type": "integer"}}, "required": ["email"]}
Example agent response
The schema has several issues:
1. **Email field missing validation**: Add format: "email" to validate email addresses
2. **Age field missing constraints**: Add minimum: 0 and maximum: 150 for reasonable age values
3. **No description fields**: Add descriptions for API documentation clarity
4. **Missing additionalProperties constraint**: Set "additionalProperties": false to reject unknown fields
Here's the improved schema:
```json
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "User email address"
},
"age": {
"type": "integer",
"minimum": 0,
"maximum": 150,
"description": "User age in years"
}
},
"required": ["email"],
"additionalProperties": false
}
```
By purchasing this skill, you agree to our terms of service
CLAUDE-5-5-SONNET
aValidates and improves JSON schemas for APIs, detecting design flaws, missing validations, and structural inconsistencies. Identifies ambiguous field types, missing required constraints, and inheritance issues. Generates strict schemas from natural descriptions or refactors existing ones for better clarity, type safety, and API contract robustness.
...more
Added 46 minutes ago
