{"id":"b0461403-de8f-4ca9-80c6-42e5334356cd","shortId":"ExhN6y","kind":"skill","title":"docs-architect","tagline":"Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks.","description":"## Use this skill when\n\n- Working on docs architect tasks or workflows\n- Needing guidance, best practices, or checklists for docs architect\n\n## Do not use this skill when\n\n- The task is unrelated to docs architect\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/implementation-playbook.md`.\n\nYou are a technical documentation architect specializing in creating comprehensive, long-form documentation that captures both the what and the why of complex systems.\n\n## Core Competencies\n\n1. **Codebase Analysis**: Deep understanding of code structure, patterns, and architectural decisions\n2. **Technical Writing**: Clear, precise explanations suitable for various technical audiences\n3. **System Thinking**: Ability to see and document the big picture while explaining details\n4. **Documentation Architecture**: Organizing complex information into digestible, navigable structures\n5. **Visual Communication**: Creating and describing architectural diagrams and flowcharts\n\n## Documentation Process\n\n1. **Discovery Phase**\n   - Analyze codebase structure and dependencies\n   - Identify key components and their relationships\n   - Extract design patterns and architectural decisions\n   - Map data flows and integration points\n\n2. **Structuring Phase**\n   - Create logical chapter/section hierarchy\n   - Design progressive disclosure of complexity\n   - Plan diagrams and visual aids\n   - Establish consistent terminology\n\n3. **Writing Phase**\n   - Start with executive summary and overview\n   - Progress from high-level architecture to implementation details\n   - Include rationale for design decisions\n   - Add code examples with thorough explanations\n\n## Output Characteristics\n\n- **Length**: Comprehensive documents (10-100+ pages)\n- **Depth**: From bird's-eye view to implementation specifics\n- **Style**: Technical but accessible, with progressive complexity\n- **Format**: Structured with chapters, sections, and cross-references\n- **Visuals**: Architectural diagrams, sequence diagrams, and flowcharts (described in detail)\n\n## Key Sections to Include\n\n1. **Executive Summary**: One-page overview for stakeholders\n2. **Architecture Overview**: System boundaries, key components, and interactions\n3. **Design Decisions**: Rationale behind architectural choices\n4. **Core Components**: Deep dive into each major module/service\n5. **Data Models**: Schema design and data flow documentation\n6. **Integration Points**: APIs, events, and external dependencies\n7. **Deployment Architecture**: Infrastructure and operational considerations\n8. **Performance Characteristics**: Bottlenecks, optimizations, and benchmarks\n9. **Security Model**: Authentication, authorization, and data protection\n10. **Appendices**: Glossary, references, and detailed specifications\n\n## Best Practices\n\n- Always explain the \"why\" behind design decisions\n- Use concrete examples from the actual codebase\n- Create mental models that help readers understand the system\n- Document both current state and evolutionary history\n- Include troubleshooting guides and common pitfalls\n- Provide reading paths for different audiences (developers, architects, operations)\n\n## Output Format\n\nGenerate documentation in Markdown format with:\n- Clear heading hierarchy\n- Code blocks with syntax highlighting\n- Tables for structured data\n- Bullet points for lists\n- Blockquotes for important notes\n- Links to relevant code files (using file_path:line_number format)\n\nRemember: Your goal is to create documentation that serves as the definitive technical reference for the system, suitable for onboarding new team members, architectural reviews, and long-term maintenance.\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.","tags":["docs","architect","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-docs-architect","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/docs-architect","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34831 github stars · SKILL.md body (4,174 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T06:51:05.300Z","embedding":null,"createdAt":"2026-04-18T21:36:15.169Z","updatedAt":"2026-04-24T06:51:05.300Z","lastSeenAt":"2026-04-24T06:51:05.300Z","tsv":"'-100':263 '1':123,182,305 '10':262,378 '2':135,208,314 '3':146,228,323 '4':160,330 '5':170,339 '6':348 '7':356 '8':363 '9':370 'abil':149 'access':278 'action':85 'actual':399 'add':251 'aid':224 'alway':387 'analysi':125 'analyz':11,185 'api':351 'appendic':379 'appli':77 'architect':3,34,46,59,101,430 'architectur':12,133,162,176,200,242,292,315,328,358,494 'ask':534 'audienc':145,428 'authent':373 'author':374 'behind':327,391 'benchmark':369 'best':40,79,385 'big':155 'bird':267 'block':444 'blockquot':456 'bottleneck':366 'boundari':318,542 'bullet':452 'captur':111 'chapter':285 'chapter/section':213 'characterist':258,365 'checklist':43 'choic':329 'clarif':536 'clarifi':71 'clear':138,440,509 'code':129,252,443,463 'codebas':10,124,186,400 'common':421 'communic':172 'compet':122 'complex':119,164,219,281 'compon':192,320,332 'comprehens':5,105,260 'concret':395 'consider':362 'consist':226 'constraint':73 'core':121,331 'creat':4,104,173,211,401,476 'criteria':545 'cross':289 'cross-refer':288 'current':412 'data':203,340,345,376,451 'decis':134,201,250,325,393 'deep':126,333 'definit':482 'depend':189,355 'deploy':357 'depth':265 'describ':175,298,513 'design':13,197,215,249,324,343,392 'detail':17,90,159,245,300,383 'develop':429 'diagram':177,221,293,295 'differ':63,427 'digest':167 'disclosur':217 'discoveri':183 'dive':334 'doc':2,33,45,58 'docs-architect':1 'document':7,100,109,153,161,180,261,347,410,435,477 'domain':64 'ebook':26 'environ':525 'environment-specif':524 'establish':225 'event':352 'evolutionari':415 'exampl':91,253,396 'execut':233,306 'exist':9 'expert':530 'explain':158,388 'explan':140,256 'extern':354 'extract':196 'eye':270 'file':464,466 'flow':204,346 'flowchart':179,297 'form':22,108 'format':282,433,438,470 'generat':434 'glossari':380 'goal':72,473 'guid':419 'guidanc':39 'head':441 'help':405 'hierarchi':214,442 'high':240 'high-level':239 'highlight':447 'histori':416 'identifi':190 'implement':16,244,273 'import':458 'includ':246,304,417 'inform':165 'infrastructur':359 'input':76,539 'instruct':70 'integr':206,349 'interact':322 'key':191,301,319 'length':259 'level':241 'limit':501 'line':468 'link':460 'list':455 'logic':212 'long':21,107,498 'long-form':20,106 'long-term':497 'mainten':500 'major':337 'manual':24 'map':202 'markdown':437 'match':510 'member':493 'mental':402 'miss':547 'model':341,372,403 'module/service':338 'navig':168 'need':38,61 'new':491 'note':459 'number':469 'onboard':490 'one':309 'one-pag':308 'open':94 'oper':361,431 'optim':367 'organ':163 'outcom':83 'output':257,432,519 'outsid':67 'overview':236,311,316 'page':264,310 'path':425,467 'pattern':14,131,198 'perform':364 'permiss':540 'phase':184,210,230 'pictur':156 'pitfal':422 'plan':220 'point':207,350,453 'practic':41,80,386 'precis':139 'process':181 'produc':19 'progress':216,237,280 'protect':377 'provid':84,423 'rational':247,326 'read':424 'reader':406 'refer':290,381,484 'relationship':195 'relev':78,462 'rememb':471 'requir':75,93,538 'resources/implementation-playbook.md':95 'review':495,531 's-ey':268 'safeti':541 'schema':342 'scope':69,512 'section':286,302 'secur':371 'see':151 'sequenc':294 'serv':479 'skill':29,51,504 'skill-docs-architect' 'source-sickn33' 'special':102 'specif':274,384,526 'stakehold':313 'start':231 'state':413 'step':86 'stop':532 'structur':130,169,187,209,283,450 'style':275 'substitut':522 'success':544 'suitabl':141,488 'summari':234,307 'syntax':446 'system':120,147,317,409,487 'tabl':448 'task':35,54,508 'team':492 'technic':6,23,99,136,144,276,483 'term':499 'terminolog':227 'test':528 'think':148 'thorough':255 'tool':66 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':517 'troubleshoot':418 'understand':127,407 'unrel':56 'use':27,49,394,465,502 'valid':82,527 'various':143 'verif':88 'view':271 'visual':171,223,291 'work':31 'workflow':37 'write':137,229","prices":[{"id":"68e95b70-826a-4c20-87c4-aa05d7863f4e","listingId":"b0461403-de8f-4ca9-80c6-42e5334356cd","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:36:15.169Z"}],"sources":[{"listingId":"b0461403-de8f-4ca9-80c6-42e5334356cd","source":"github","sourceId":"sickn33/antigravity-awesome-skills/docs-architect","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/docs-architect","isPrimary":false,"firstSeenAt":"2026-04-18T21:36:15.169Z","lastSeenAt":"2026-04-24T06:51:05.300Z"}],"details":{"listingId":"b0461403-de8f-4ca9-80c6-42e5334356cd","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"docs-architect","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34831,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"0d8047417d6edbe49a97774aacc6c7a05726fe6c","skill_md_path":"skills/docs-architect/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/docs-architect"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"docs-architect","description":"Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/docs-architect"},"updatedAt":"2026-04-24T06:51:05.300Z"}}