[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DNESCGBSDCNP48HARW18M2":3,"skill-same:01M6DNESCGBSDCNP48HARW18M2":84},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":53,"install":54,"resources":67},"01M6DNESCGBSDCNP48HARW18M2","aac-generate-api-docs",null,"Generate API documentation from source code analysis. Use when the user says \"generate api docs\" or \"document the api\" or \"create api reference\"","msayedshokry\u002FAgileAgentCanvasExt","msayedshokry","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35009459?v=4","01M6DN5RZZ297CGWTNJ6ERZQ8W","Mohamed Sayed","01M6DN5S4XS7SVCSXZRW2XR0XF",3,"MIT","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Fskills\u002Faac-generate-api-docs\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41],"docs","generate","api","aac generate api docs","documentation","create","code","analysis","user","use","reference","api documentation","document","2026-11-10 10:12:30",false,"---\nname: aac-generate-api-docs\ndescription: 'Generate API documentation from source code analysis. Use when the user says \"generate api docs\" or \"document the api\" or \"create api reference\"'\n---\n\n# Generate API Documentation Instructions\n\n**Goal:** Analyze the project source code and produce comprehensive API documentation suitable for developers who need to integrate with or extend the project's APIs.\n\n**Your Role:** You are Paige, the Technical Writer. You create clear, accurate API documentation with practical examples.\n\n---\n\n## WORKFLOW STEPS\n\n### Step 1: API Discovery\n\n1. **Determine API type** — Ask the user or detect from source:\n   - **REST API** — Express, Fastify, Koa, Flask, Django, Spring, ASP.NET routes\n   - **GraphQL** — Schema definitions, resolvers\n   - **Library\u002FSDK** — Exported functions, classes, interfaces\n   - **CLI** — Commands, flags, arguments\n   - **WebSocket** — Event handlers, message types\n   - **RPC\u002FgRPC** — Service definitions, proto files\n2. **Scan source code** for:\n   - Route definitions and HTTP methods\n   - Request\u002Fresponse types and schemas\n   - Authentication\u002Fauthorization middleware\n   - Validation rules\n   - Error codes and responses\n   - Exported public API surface\n3. **Check existing docs** — Look for OpenAPI\u002FSwagger specs, JSDoc comments, docstrings, type definitions.\n4. **Reference architecture** — If BMAD architecture artifact exists, use it for API design patterns and conventions.\n\nPresent findings and ask the user which APIs to document (all, or a specific subset).\n\n### Step 2: Choose Output Format\n\nBased on the API type, suggest the appropriate format:\n\n| API Type | Recommended Format |\n|----------|-------------------|\n| REST API | OpenAPI 3.0 YAML + Markdown reference |\n| GraphQL | Schema docs + Markdown guide |\n| Library\u002FSDK | TSDoc\u002FJSDoc + Markdown reference |\n| CLI | Markdown with command tables |\n| WebSocket | Markdown with event catalog |\n\nConfirm the format with the user before proceeding.\n\n### Step 3: Document Each Endpoint\u002FFunction\n\nFor each API surface, document:\n\n**REST Endpoints:**\n- HTTP method and path\n- Description of what it does\n- Path parameters, query parameters, request body schema\n- Response schema with status codes\n- Authentication requirements\n- Request\u002Fresponse examples (use realistic data)\n- Error responses\n\n**Library Functions\u002FMethods:**\n- Signature with parameter types and return type\n- Description\n- Parameter descriptions with defaults\n- Return value description\n- Usage example\n- Throws\u002Ferrors\n\n**Rules:**\n- Use real types from the codebase — never invent schemas\n- Every endpoint\u002Ffunction needs at least one code example\n- Group related endpoints logically (by resource or feature)\n- Include authentication section at the top if applicable\n- Document rate limits, pagination, and versioning if they exist\n- Code blocks must have language identifiers\n\n### Step 4: Review & Finalize\n\n1. Present the draft documentation.\n2. Ask the user to verify accuracy of schemas, parameters, and examples.\n3. Apply revisions.\n4. Save to the agreed output location.\n\n---\n\n## STANDARDS\n\nFollow all rules from `_bmad\u002F_memory\u002Ftech-writer-sidecar\u002Fdocumentation-standards.md`, especially:\n- CommonMark strict compliance\n- Fenced code blocks with language identifiers\n- Consistent table formatting\n\n","# Generate API Documentation Instructions\n\n**Goal:** Analyze the project source code and produce comprehensive API documentation suitable for developers who need to integrate with or extend the project's APIs.\n\n**Your Role:** You are Paige, the Technical Writer. You create clear, accurate API documentation with practical examples.\n\n---\n\n## WORKFLOW STEPS\n\n### Step 1: API Discovery\n\n1. **Determine API type** — Ask the user or detect from source:\n   - **REST API** — Express, Fastify, Koa, Flask, Django, Spring, ASP.NET routes\n   - **GraphQL** — Schema definitions, resolvers\n   - **Library\u002FSDK** — Exported functions, classes, interfaces\n   - **CLI** — Commands, flags, arguments\n   - **WebSocket** — Event handlers, message types\n   - **RPC\u002FgRPC** — Service definitions, proto files\n2. **Scan source code** for:\n   - Route definitions and HTTP methods\n   - Request\u002Fresponse types and schemas\n   - Authentication\u002Fauthorization middleware\n   - Validation rules\n   - Error codes and responses\n   - Exported public API surface\n3. **Check existing docs** — Look for OpenAPI\u002FSwagger specs, JSDoc comments, docstrings, type definitions.\n4. **Reference architecture** — If BMAD architecture artifact exists, use it for API design patterns and conventions.\n\nPresent findings and ask the user which APIs to document (all, or a specific subset).\n\n### Step 2: Choose Output Format\n\nBased on the API type, suggest the appropriate format:\n\n| API Type | Recommended Format |\n|----------|-------------------|\n| REST API | OpenAPI 3.0 YAML + Markdown reference |\n| GraphQL | Schema docs + Markdown guide |\n| Library\u002FSDK | TSDoc\u002FJSDoc + Markdown reference |\n| CLI | Markdown with command tables |\n| WebSocket | Markdown with event catalog |\n\nConfirm the format with the user before proceeding.\n\n### Step 3: Document Each Endpoint\u002FFunction\n\nFor each API surface, document:\n\n**REST Endpoints:**\n- HTTP method and path\n- Description of what it does\n- Path parameters, query parameters, request body schema\n- Response schema with status codes\n- Authentication requirements\n- Request\u002Fresponse examples (use realistic data)\n- Error responses\n\n**Library Functions\u002FMethods:**\n- Signature with parameter types and return type\n- Description\n- Parameter descriptions with defaults\n- Return value description\n- Usage example\n- Throws\u002Ferrors\n\n**Rules:**\n- Use real types from the codebase — never invent schemas\n- Every endpoint\u002Ffunction needs at least one code example\n- Group related endpoints logically (by resource or feature)\n- Include authentication section at the top if applicable\n- Document rate limits, pagination, and versioning if they exist\n- Code blocks must have language identifiers\n\n### Step 4: Review & Finalize\n\n1. Present the draft documentation.\n2. Ask the user to verify accuracy of schemas, parameters, and examples.\n3. Apply revisions.\n4. Save to the agreed output location.\n\n---\n\n## STANDARDS\n\nFollow all rules from `_bmad\u002F_memory\u002Ftech-writer-sidecar\u002Fdocumentation-standards.md`, especially:\n- CommonMark strict compliance\n- Fenced code blocks with language identifiers\n- Consistent table formatting\n\n",{"name":5,"description":7},"main","473351382920a74eb8f353f979a06f6f05bb5f59","resources\u002F_aac\u002Fskills\u002Faac-generate-api-docs",0,"https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt","https:\u002F\u002Fgithub.com\u002Fmsayedshokry","2026-08-29 02:00:07",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add msayedshokry\u002FAgileAgentCanvasExt --skill aac-generate-api-docs",{"tool":60,"command":61},"bunx","bunx skills add msayedshokry\u002FAgileAgentCanvasExt --skill aac-generate-api-docs",{"tool":63,"command":64},"pnpm","pnpm dlx skills add msayedshokry\u002FAgileAgentCanvasExt --skill aac-generate-api-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Fskills\u002Faac-generate-api-docs\u002FSKILL.md",true,[68,74,80],{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"bmad-skill-manifest.yaml","REFERENCE","参考文档",1036,"https:\u002F\u002Fgithub.com\u002Fdelorenj\u002FyTm\u002Fblob\u002Fmain\u002F.crush\u002Fskills\u002Fbmad-agent-analyst\u002Fbmad-skill-manifest.yaml",{"path":75,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"customize.toml","OTHER","其他",147,"https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Fskills\u002Faac-generate-api-docs\u002Fcustomize.toml",{"path":81,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":82,"sourceHtmlUrl":83},"steps\u002Fapi-docs-template.md",981,"https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Fskills\u002Faac-generate-api-docs\u002Fsteps\u002Fapi-docs-template.md",[85,109,126,139,162,178],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":97,"publishedAt":42},"01M6DNRTHE3M1XG3KDJTEF6BG6","bmad-teach-me-testing","Teach testing progressively through structured sessions. Use when user says \"lets learn testing\" or \"I want to study test practices\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Fbmad-teach-me-testing\u002FSKILL.md",[91,94],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":95,"categoryName":96,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000039","教师与教育",[98,99,100,101,102,103,104,105,106,37,38,107,108],"bmad","me","bmad teach me testing","teach me","teach","testing","test","sessions","learn","study","structured",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":116,"publishedAt":42},"01M6DNRG27V77JEGMPMJVRY0Q5","aac-testarch-trace","Generate traceability matrix and quality gate decision. Use when the user says \"lets create traceability matrix\" or \"I want to analyze test coverage\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Faac-testarch-trace\u002FSKILL.md",[115],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},[117,118,104,119,34,30,120,121,122,37,123,38,124,125],"aac testarch trace","trace","quality gate","analyze","quality","decision","coverage","test coverage","gate",{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":133,"publishedAt":42},"01M6DNR70G1S0DGDSHRWT1S1DD","aac-testarch-test-review","Review test quality using best practices validation. Use when user says \"lets review tests\" or \"I want to evaluate test quality\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Faac-testarch-test-review\u002FSKILL.md",[132],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},[134,135,104,136,137,121,37,38,138],"review","aac testarch test review","best practices","validation","tests",{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":152,"publishedAt":42},"01M6DNQXV8F40EE78ZMWGWRPJM","aac-testarch-test-design","Create system-level or epic-level test plans. Use when the user says \"lets design test plan\" or \"I want to create test strategy\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Faac-testarch-test-design\u002FSKILL.md",[145,146,149],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":147,"categoryName":148,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":150,"categoryName":151,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000032","设计师",[153,154,104,155,37,34,156,157,158,159,38,160,161],"aac testarch test design","test design","design","test plan","plan","system","strategy","test strategy","plans",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":42},"01M6DNQNG0T7Q5DKV3C03RY35D","aac-testarch-nfr","Audit NFR evidence for performance, security, reliability, and scalability. Use when implementation evidence exists and the user says \"audit NFR evidence\", \"audit NFRs\", or \"evaluate non-functional requirements\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Faac-testarch-nfr\u002FSKILL.md",[],[169,170,171,172,173,174,37,175,176,38,177],"aac testarch nfr","reliability","evidence","implementation","scalability","requirements","audit","performance","security",{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":185,"publishedAt":42},"01M6DNQDPTGB49D8AAJV4GN2H8","aac-testarch-framework","Initialize test framework with Playwright or Cypress. Use when the user says \"lets setup test framework\" or \"I want to initialize testing framework\"","https:\u002F\u002Fgithub.com\u002Fmsayedshokry\u002FAgileAgentCanvasExt\u002Fblob\u002Fmain\u002Fresources\u002F_aac\u002Ftea\u002Fworkflows\u002Ftestarch\u002Faac-testarch-framework\u002FSKILL.md",[184],{"categoryNo":92,"categoryName":93,"taxonomyType":21,"taxonomyTypeDesc":22},[186,187,188,37,38,189,190,191,104,192,103,193],"aac testarch framework","framework","initialize","testing framework","setup","test framework","playwright","cypress"]