openapi-spec

openapi-spec is an API design & implementation skill for AI agents, published by blockscout in the blockscout repository on GitHub. Skillspace rates openapi-spec C (77/100) and it passed the safety scan; the rating is based on static analysis only.

Create, adjust, or inspect OpenAPI declarations for Blockscout API v2 endpoints. Use this skill whenever the user asks to: add an OpenAPI spec to an endpoint that lacks one, update a spec after controller/view changes, audit or fix an existing OpenAPI declaration, or work with open_api_spex annotations in the Blockscout codebase. Also trigger when the user mentions 'swagger', 'openapi', 'open_api_spex', 'API spec', 'API schema', or 'operation macro', or when debugging failures like 'response schema mismatch', 'CastAndValidate rejection', 'json_response validation error', 'Unexpected field', or extra/missing keys in API responses.

Grade
C
Quality
77 / 100
Safety
Passed
GitHub stars
4,599

Unproven: rated by static analysis only, not yet compared head-to-head.

Not launch-quality. It is graded C with a clean safety verdict, but our quality filters exclude it: a model that read it found it written only for the repository it lives in. So it is not in our launch-quality set, the skills our MCP server searches and recommends. How launch-quality is decided

This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.

View source on GitHubblockscout/blockscout

Our review

Architecture
100 / 100
Maturity
Structured: ships references or scripts
Security scan
Low-risk patterns
License
Not declared. Check the repository before reusing it.
Adoption
Adopted by 1 other repositories, in 0 collections
Scope
Repo-internal: written for the repository it lives in. Blockscout's own API v2 controllers and spec conventions

What the scanner flagged

  • over-broad allowed-tools ('*')
  • mentions secrets in text

Not checked yet

  • Not judged on the rubric yet (not a contender in its category)
  • No blind task eval yet
  • Sibling files (scripts, references) not fetched; security scan covers SKILL.md only

Better-rated skills in API design & implementation

Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.