What problem does it solve? Writing and maintaining RESTful API specification documents by hand is slow and error-prone, and specs quickly drift out of sync with actual API implementations. This Skill automates the creation and updating of standardized API spec documents so documentation always matches the code. ## Core Features & Use Cases - Template-Based Generation: Applies a project-standard API spec template to produce complete documents with CRUD endpoints, request/response examples, validation rules, and error code definitions. - Flexible Input Sources: Accepts database table schemas (SQL DDL), Use Case documents, verbal descriptions, or existing Java Entity/DTO/Controller code as input. - Diagram Generation: Produces Mermaid architecture diagrams, ER diagrams, and sequence diagrams for CRUD, batch, and pagination flows. - Update Mode: Synchronizes existing spec documents when endpoints are added, modified, or deleted, marking changes with status indicators and bumping the document version. - Use Case: A backend developer adds a new query parameter to an employee management endpoint in a Spring Boot project and asks the AI to update the API spec; the Skill reads the template, updates only the affected sections, and increments the document version. ## Quick Start Ask the AI to generate an API specification document for your module based on its database table structure or use case description.
