Delimit Spec Health
delimit_spec_healthScore an OpenAPI spec's quality across completeness, security, consistency, documentation, and best practices, returning a 0-100 score and A-F grade for quick assessment.
Instructions
Score an OpenAPI spec on quality dimensions (0-100, A-F grade).
When to use: for quick spec quality checks during onboarding or review — completeness, security, consistency, documentation, best practices. When NOT to use: as a breaking-change gate (use delimit_lint) or raw diff (delimit_diff).
Sibling contrast: delimit_lint compares two specs; this scores one spec on its own merits.
Side effects: read-only. Calls backends.gateway_core.run_spec_health. Works on any valid OpenAPI 3.x or Swagger 2.0 spec.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"spec": "<spec>"
},
"name": "delimit_spec_health"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec | Yes | Path to an OpenAPI spec file (YAML or JSON). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||