openapi-review
OpenAPI Specification Review
Review OpenAPI specification files systematically for standards compliance, security, API design best practices, and documentation quality.
Input Handling
Determine the input type and gather the specification accordingly:
- Direct content -- Spec provided inline in the conversation. Review as-is.
- File path(s) -- Read the specified
.yaml,.yml, or.jsonfiles. - Directory path -- Find all OpenAPI spec files recursively. If multiple specs are found, ask the user which to review.
- URL -- If given a URL, ask the user to provide the file content directly.
Before starting the review phases, determine:
More from theepan/ai-agent-skills
software-requirements
>-
24business-naming
>-
19java-code-review
>-
13learning-guide-creator
>
9domain-name-generator
Generate short, pronounceable, catchy domain names for products, startups, or projects. Use when the user asks for domain name ideas, brand names, startup names, or wants help naming something with an available web domain.
8saas-landing-theme
Generate modern, light-themed SaaS landing pages with a warm editorial aesthetic, conversion-focused layout, and polished UI. Use this skill whenever the user asks to create a SaaS website, landing page, marketing site, startup homepage, product page, or any professional web page for a software product or service. Also trigger when the user mentions "landing page", "marketing site", "SaaS site", "startup website", "product homepage", "pricing page", "saas theme", or wants a professional light-themed web design with hero sections, feature grids, pricing tables, testimonials, or CTA sections. This skill produces production-ready HTML or React (JSX) with the full design system baked in.
2