{"files":{"SKILL.md":"---\nname: swagger-generator\ndescription: \"Swagger Generator API skill. Use when working with Swagger Generator for gen. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Swagger Generator\nAPI version: 2.4.49\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://generator.swagger.io/api\n\n## Setup\n1. No auth setup needed\n2. GET /gen/servers -- gets languages supported by the server generator\n3. POST /gen/servers/{framework} -- create first server\n\n## Endpoints\n7 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Gen\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /gen/download/{fileId} | Downloads a pre-generated file |\n| GET | /gen/servers | Gets languages supported by the server generator |\n| GET | /gen/servers/{framework} | Returns options for a server framework |\n| POST | /gen/servers/{framework} | Generates a server library |\n| GET | /gen/clients/{language} | Returns options for a client library |\n| POST | /gen/clients/{language} | Generates a client library |\n| GET | /gen/clients | Gets languages supported by the client generator |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get download details?\" -> GET /gen/download/{fileId}\n- \"List all servers?\" -> GET /gen/servers\n- \"Get server details?\" -> GET /gen/servers/{framework}\n- \"Get client details?\" -> GET /gen/clients/{language}\n- \"List all clients?\" -> GET /gen/clients\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Swagger Generator\n@base https://generator.swagger.io/api\n@version 2.4.49\n@endpoints 7\n@toc gen(7)\n\n@endpoint GET /gen/download/{fileId}\n@desc Downloads a pre-generated file\n@required {fileId: any}\n@returns(200) successful operation\n\n@endpoint GET /gen/servers\n@desc Gets languages supported by the server generator\n@returns(200) successful operation\n\n@endpoint GET /gen/servers/{framework}\n@desc Returns options for a server framework\n@required {framework: any # The target language for the server framework}\n@returns(200) successful operation\n\n@endpoint POST /gen/servers/{framework}\n@desc Generates a server library\n@required {framework: any # framework, body: map # parameters}\n@returns(200) successful operation\n\n@endpoint GET /gen/clients/{language}\n@desc Returns options for a client library\n@required {language: any # The target language for the client library}\n@returns(200) successful operation\n\n@endpoint POST /gen/clients/{language}\n@desc Generates a client library\n@required {language: any # The target language for the client library, body: map # Configuration for building the client library}\n@returns(200) successful operation\n\n@endpoint GET /gen/clients\n@desc Gets languages supported by the client generator\n@returns(200) successful operation\n\n@end\n"}}