[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-18499804-3d14-42f1-b9e9-1beb862520b0":3,"$ft6-Kupf3e4D2tG9EikscNORd5fT2Ur4RpiSOJyk3vwA":42},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":33},"18499804-3d14-42f1-b9e9-1beb862520b0","openapi-spec-generation","生成和维护从代码、设计优先规范和验证模式生成的OpenAPI 3.1规范。用于创建API文档、生成SDK或确保API合同合规性。","cat_coding_backend","mod_coding","sickn33,coding","---\nname: openapi-spec-generation\ndescription: \"Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.\"\nrisk: safe\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# OpenAPI Spec Generation\n\nComprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.\n\n## Use this skill when\n\n- Creating API documentation from scratch\n- Generating OpenAPI specs from existing code\n- Designing API contracts (design-first approach)\n- Validating API implementations against specs\n- Generating client SDKs from specs\n- Setting up API documentation portals\n\n## Do not use this skill when\n\n- The task is unrelated to openapi spec generation\n- You need a different domain or tool outside this scope\n\n## Instructions\n\n- Clarify goals, constraints, and required inputs.\n- Apply relevant best practices and validate outcomes.\n- Provide actionable steps and verification.\n- If detailed examples are required, open `resources\u002Fimplementation-playbook.md`.\n\n## Resources\n\n- `resources\u002Fimplementation-playbook.md` for detailed patterns and examples.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,195,1398,"2026-05-16 13:32:53",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":25,"skillCount":32,"createdAt":26},"后端开发","backend","mdi-server","API、数据库、服务端架构",296,[34],{"id":35,"skillId":4,"version":36,"fileName":37,"fileSize":38,"filePath":39,"fileHash":40,"manifest":41,"createdAt":19},"4aa1b769-9c3f-4586-9be1-2b9e4895fa00","1.0.0","openapi-spec-generation.zip",7232,"uploads\u002Fskills\u002F18499804-3d14-42f1-b9e9-1beb862520b0\u002Fopenapi-spec-generation.zip","32fc5382035d08b1d90d182bde176342d7ee36fe7b017c5c72ed6a82f0e1ae75","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":1528},{\"path\":\"resources\u002Fimplementation-playbook.md\",\"isDirectory\":false,\"size\":24564}]",{"code":43,"message":44,"data":45},200,"success",{"items":46,"stats":47,"page":50},[],{"averageRating":48,"totalRatings":48,"ratingCounts":49},0,[48,48,48,48,48],{"limit":51,"offset":48,"hasMore":52,"nextOffset":51,"ratedOnly":16},15,false]