update-openapi

Name: update-openapi
Availability: InStock
Author: Ather

Synchronize OpenAPI specification files with TypeScript route definitions in Node.js.

6|3|Updated Apr 30, 2026

Search Tags:#typescript #documentation #api #openapi #backend #swagger

Ready to run

npx skills add https://github.com/ather-techie/SlateFlow --skill update-openapi

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: update-openapi
Source: https://github.com/ather-techie/SlateFlow/tree/main/.claude/skills/update-openapi
Command: npx skills add https://github.com/ather-techie/SlateFlow --skill update-openapi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the common issue of API documentation drifting from the actual implementation, ensuring that your OpenAPI specifications remain accurate and reliable as your codebase evolves.

Core Features & Use Cases

Synchronization Workflow: Provides a structured, step-by-step process to map route changes to their corresponding domain-specific OpenAPI spec files.
Validation & Verification: Guides you through verifying your changes using local development tools like Swagger UI and curl.
Use Case: When adding a new endpoint to your project, use this skill to ensure the request bodies, response schemas, and path parameters are correctly documented in the TypeScript-based spec files.

Quick Start

Use the update-openapi skill to guide you through the process of updating the domain spec file after you have modified a route in the server directory.

Frequently Asked Questions about update-openapi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I keep my OpenAPI specs in sync with backend route changes in TypeScript?▼

To keep OpenAPI specs in sync with backend route changes, you map modified TypeScript route definitions to their corresponding domain-specific spec files, verifying HTTP methods, request schemas, and response envelopes for consistency.

What is the best way to update API documentation after adding a new endpoint?▼

The best way to update API documentation after adding an endpoint is to follow a structured synchronization workflow that manually verifies request bodies, response schemas, and path parameters against the new server route implementation.

How do I validate OpenAPI specification changes locally before deploying?▼

To validate OpenAPI specification changes locally, you can use development tools like Swagger UI and curl to test that the documented request schemas and response envelopes match the actual Node.js backend route behaviors.

Why does my API documentation drift from the actual implementation in Node.js?▼

API documentation drifts from the actual implementation when backend route files are modified but the corresponding OpenAPI specification files are not updated, causing inconsistencies between HTTP methods and documented schemas.

Can I use this workflow to update domain-specific OpenAPI spec modules?▼

Yes, you can use this workflow to update domain-specific OpenAPI spec modules by targeting TypeScript-based spec files and manually verifying their consistency with server directory route changes.