[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M70HZYVQDXFTS8RZRP4N633W":3,"skill-same:01M70HZYVQDXFTS8RZRP4N633W":88},{"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":31,"publishedAt":49,"linkOnly":50,"markdownContent":51,"markdownBody":52,"frontMatter":53,"refName":54,"commitSha":55,"skillDirectory":56,"forksCount":57,"repositoryHtmlUrl":58,"repositoryHomepageUrl":59,"ownerHtmlUrl":60,"ownerBlogUrl":61,"ownerDescription":62,"updatedAt":63,"install":64,"resources":77},"01M70HZYVQDXFTS8RZRP4N633W","technical-writing",null,"Create architectural decision records (ADRs), system documentation, API documentation, and operational runbooks. Use when capturing design decisions, documenting system architecture, creating API references, or writing operational procedures.","shengdabai\u002FTony-Claude-Code-Skills","shengdabai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F116417419?v=4","01M70F6D2WY5PQV5A92BKYJQEW","Tony Sheng","01M70F6D3GAAAYZ5H4CC1G8VXM",3,"MIT","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002FSKILL.md",[18,23,28],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":29,"categoryName":30,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000036","内容创作者",[32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48],"writing","technical writing","technical","references","create","documentation","api","architecture","decisions","when","use","design","decision","runbooks","records","system","api documentation","2026-11-10 10:12:30",false,"---\nname: technical-writing\ndescription: Create architectural decision records (ADRs), system documentation, API documentation, and operational runbooks. Use when capturing design decisions, documenting system architecture, creating API references, or writing operational procedures.\n---\n\n# Documentation Creation\n\nA development skill for creating and maintaining technical documentation that preserves knowledge, enables informed decision-making, and supports system operations. This skill provides templates and patterns for common documentation needs.\n\n## When to Use\n\n- Recording architectural or design decisions with context and rationale\n- Documenting system architecture for new team members or stakeholders\n- Creating API documentation for internal or external consumers\n- Writing runbooks for operational procedures and incident response\n- Capturing tribal knowledge before it's lost to team changes\n\n## Core Documentation Types\n\n### Architecture Decision Records (ADRs)\n\nADRs capture the context, options considered, and rationale behind significant architectural decisions. They serve as a historical record that helps future developers understand why the system is built a certain way.\n\n**When to create an ADR:**\n\n- Choosing between different technologies, frameworks, or approaches\n- Making decisions that are difficult or expensive to reverse\n- Establishing patterns that will be followed across the codebase\n- Deprecating existing approaches in favor of new ones\n- Any decision that a future developer might question\n\nSee: `templates\u002Fadr-template.md`\n\n### System Documentation\n\nSystem documentation provides a comprehensive view of how a system works, its components, and their relationships. It helps new team members onboard and serves as a reference for operations.\n\n**Key elements:**\n\n- System overview and purpose\n- Architecture diagrams showing component relationships\n- Data flows and integration points\n- Deployment architecture\n- Operational requirements\n\nSee: `templates\u002Fsystem-doc-template.md`\n\n### API Documentation\n\nAPI documentation describes how to interact with a service, including endpoints, request\u002Fresponse formats, authentication, and error handling.\n\n**Key elements:**\n\n- Authentication and authorization\n- Endpoint reference with examples\n- Request and response schemas\n- Error codes and handling\n- Rate limits and quotas\n- Versioning strategy\n\n### Runbooks\n\nRunbooks provide step-by-step procedures for operational tasks, from routine maintenance to incident response.\n\n**Key elements:**\n\n- Pre-requisites and access requirements\n- Step-by-step procedures with expected outcomes\n- Troubleshooting common issues\n- Escalation paths\n- Recovery procedures\n\n## Documentation Patterns\n\n### Pattern 1: Decision Context First\n\nAlways document the context and constraints that led to a decision before stating the decision itself. Future readers need to understand the \"why\" before the \"what.\"\n\n```markdown\n## Context\n\nWe need to store user session data that must be:\n- Available across multiple application instances\n- Retrieved in under 10ms\n- Retained for 24 hours after last activity\n\nOur current database is PostgreSQL, which would require additional\ninfrastructure for session management.\n\n## Decision\n\nWe will use Redis for session storage.\n```\n\n### Pattern 2: Living Documentation\n\nDocumentation should be updated as part of the development process, not as an afterthought. Integrate documentation updates into your definition of done.\n\n- Update ADRs when decisions change (mark old ones as superseded)\n- Revise system docs when architecture evolves\n- Keep API docs in sync with implementation (prefer generated docs where possible)\n- Review runbooks after each incident for accuracy\n\n### Pattern 3: Audience-Appropriate Detail\n\nTailor documentation depth to its intended audience:\n\n| Audience | Focus | Detail Level |\n|----------|-------|--------------|\n| New developers | Onboarding, getting started | High-level concepts, step-by-step guides |\n| Experienced team | Reference, troubleshooting | Technical details, edge cases |\n| Operations | Deployment, monitoring | Procedures, commands, expected outputs |\n| Business stakeholders | Capabilities, limitations | Non-technical summaries, diagrams |\n\n### Pattern 4: Diagrams Over Prose\n\nUse diagrams to communicate complex relationships. A well-designed diagram can replace pages of text and is easier to maintain.\n\n**Recommended diagram types:**\n\n- **System context**: Shows system boundaries and external interactions\n- **Container**: Shows major components and their relationships\n- **Sequence**: Shows how components interact for specific flows\n- **Data flow**: Shows how data moves through the system\n\n### Pattern 5: Executable Documentation\n\nWhere possible, make documentation executable or verifiable:\n\n- API examples that can be run against a test environment\n- Code snippets that are extracted from actual tested code\n- Configuration examples that are validated in CI\n- Runbook steps that have been recently executed\n\n## ADR Lifecycle\n\nADRs follow a specific lifecycle:\n\n1. **Proposed**: Decision is being discussed, not yet accepted\n2. **Accepted**: Decision has been made and should be followed\n3. **Deprecated**: Decision is being phased out, new work should not follow it\n4. **Superseded**: Decision has been replaced by a newer ADR (link to new one)\n\nWhen superseding an ADR:\n- Add \"Superseded by ADR-XXX\" to the old record\n- Add \"Supersedes ADR-YYY\" to the new record\n- Explain what changed and why in the new ADR's context\n\n## Best Practices\n\n- Write documentation close to the code it describes (prefer docs-as-code)\n- Use templates consistently to make documentation predictable\n- Include diagrams for architecture; text for procedures\n- Date all documents and note last review date\n- Keep ADRs immutable once accepted (create new ones to supersede)\n- Store documentation in version control alongside code\n- Review documentation accuracy during code reviews\n- Delete or archive documentation for removed features\n\n## Anti-Patterns to Avoid\n\n- **Documentation Drift**: Docs that no longer match reality are worse than no docs\n- **Over-Documentation**: Documenting obvious code reduces signal-to-noise\n- **Wiki Sprawl**: Documentation scattered across multiple systems becomes unfindable\n- **Future Fiction**: Documenting features that don't exist yet as if they do\n- **Write-Only Docs**: Creating docs that no one reads or maintains\n\n## References\n\n- `templates\u002Fadr-template.md` - Architecture Decision Record template\n- `templates\u002Fsystem-doc-template.md` - System documentation template\n","# Documentation Creation\n\nA development skill for creating and maintaining technical documentation that preserves knowledge, enables informed decision-making, and supports system operations. This skill provides templates and patterns for common documentation needs.\n\n## When to Use\n\n- Recording architectural or design decisions with context and rationale\n- Documenting system architecture for new team members or stakeholders\n- Creating API documentation for internal or external consumers\n- Writing runbooks for operational procedures and incident response\n- Capturing tribal knowledge before it's lost to team changes\n\n## Core Documentation Types\n\n### Architecture Decision Records (ADRs)\n\nADRs capture the context, options considered, and rationale behind significant architectural decisions. They serve as a historical record that helps future developers understand why the system is built a certain way.\n\n**When to create an ADR:**\n\n- Choosing between different technologies, frameworks, or approaches\n- Making decisions that are difficult or expensive to reverse\n- Establishing patterns that will be followed across the codebase\n- Deprecating existing approaches in favor of new ones\n- Any decision that a future developer might question\n\nSee: `templates\u002Fadr-template.md`\n\n### System Documentation\n\nSystem documentation provides a comprehensive view of how a system works, its components, and their relationships. It helps new team members onboard and serves as a reference for operations.\n\n**Key elements:**\n\n- System overview and purpose\n- Architecture diagrams showing component relationships\n- Data flows and integration points\n- Deployment architecture\n- Operational requirements\n\nSee: `templates\u002Fsystem-doc-template.md`\n\n### API Documentation\n\nAPI documentation describes how to interact with a service, including endpoints, request\u002Fresponse formats, authentication, and error handling.\n\n**Key elements:**\n\n- Authentication and authorization\n- Endpoint reference with examples\n- Request and response schemas\n- Error codes and handling\n- Rate limits and quotas\n- Versioning strategy\n\n### Runbooks\n\nRunbooks provide step-by-step procedures for operational tasks, from routine maintenance to incident response.\n\n**Key elements:**\n\n- Pre-requisites and access requirements\n- Step-by-step procedures with expected outcomes\n- Troubleshooting common issues\n- Escalation paths\n- Recovery procedures\n\n## Documentation Patterns\n\n### Pattern 1: Decision Context First\n\nAlways document the context and constraints that led to a decision before stating the decision itself. Future readers need to understand the \"why\" before the \"what.\"\n\n```markdown\n## Context\n\nWe need to store user session data that must be:\n- Available across multiple application instances\n- Retrieved in under 10ms\n- Retained for 24 hours after last activity\n\nOur current database is PostgreSQL, which would require additional\ninfrastructure for session management.\n\n## Decision\n\nWe will use Redis for session storage.\n```\n\n### Pattern 2: Living Documentation\n\nDocumentation should be updated as part of the development process, not as an afterthought. Integrate documentation updates into your definition of done.\n\n- Update ADRs when decisions change (mark old ones as superseded)\n- Revise system docs when architecture evolves\n- Keep API docs in sync with implementation (prefer generated docs where possible)\n- Review runbooks after each incident for accuracy\n\n### Pattern 3: Audience-Appropriate Detail\n\nTailor documentation depth to its intended audience:\n\n| Audience | Focus | Detail Level |\n|----------|-------|--------------|\n| New developers | Onboarding, getting started | High-level concepts, step-by-step guides |\n| Experienced team | Reference, troubleshooting | Technical details, edge cases |\n| Operations | Deployment, monitoring | Procedures, commands, expected outputs |\n| Business stakeholders | Capabilities, limitations | Non-technical summaries, diagrams |\n\n### Pattern 4: Diagrams Over Prose\n\nUse diagrams to communicate complex relationships. A well-designed diagram can replace pages of text and is easier to maintain.\n\n**Recommended diagram types:**\n\n- **System context**: Shows system boundaries and external interactions\n- **Container**: Shows major components and their relationships\n- **Sequence**: Shows how components interact for specific flows\n- **Data flow**: Shows how data moves through the system\n\n### Pattern 5: Executable Documentation\n\nWhere possible, make documentation executable or verifiable:\n\n- API examples that can be run against a test environment\n- Code snippets that are extracted from actual tested code\n- Configuration examples that are validated in CI\n- Runbook steps that have been recently executed\n\n## ADR Lifecycle\n\nADRs follow a specific lifecycle:\n\n1. **Proposed**: Decision is being discussed, not yet accepted\n2. **Accepted**: Decision has been made and should be followed\n3. **Deprecated**: Decision is being phased out, new work should not follow it\n4. **Superseded**: Decision has been replaced by a newer ADR (link to new one)\n\nWhen superseding an ADR:\n- Add \"Superseded by ADR-XXX\" to the old record\n- Add \"Supersedes ADR-YYY\" to the new record\n- Explain what changed and why in the new ADR's context\n\n## Best Practices\n\n- Write documentation close to the code it describes (prefer docs-as-code)\n- Use templates consistently to make documentation predictable\n- Include diagrams for architecture; text for procedures\n- Date all documents and note last review date\n- Keep ADRs immutable once accepted (create new ones to supersede)\n- Store documentation in version control alongside code\n- Review documentation accuracy during code reviews\n- Delete or archive documentation for removed features\n\n## Anti-Patterns to Avoid\n\n- **Documentation Drift**: Docs that no longer match reality are worse than no docs\n- **Over-Documentation**: Documenting obvious code reduces signal-to-noise\n- **Wiki Sprawl**: Documentation scattered across multiple systems becomes unfindable\n- **Future Fiction**: Documenting features that don't exist yet as if they do\n- **Write-Only Docs**: Creating docs that no one reads or maintains\n\n## References\n\n- `templates\u002Fadr-template.md` - Architecture Decision Record template\n- `templates\u002Fsystem-doc-template.md` - System documentation template\n",{"name":5,"description":7},"main","7850740bd837adb32f0a109ab2af82482196c6f2","skills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing",1,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills","https:\u002F\u002Fzturnsgo.com","https:\u002F\u002Fgithub.com\u002Fshengdabai","https:\u002F\u002Fzturnsgo.com\u002F","AI × education creator — producer, not consumer. Taught 6,000+ learners; shipping learning tools & daily essays with Claude Code, practicing @xiaolai's way 🥋","2026-11-01 21:28:23",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":76},[66,69,72],{"tool":67,"command":68},"npx","npx skills add shengdabai\u002FTony-Claude-Code-Skills --skill technical-writing",{"tool":70,"command":71},"bunx","bunx skills add shengdabai\u002FTony-Claude-Code-Skills --skill technical-writing",{"tool":73,"command":74},"pnpm","pnpm dlx skills add shengdabai\u002FTony-Claude-Code-Skills --skill technical-writing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002FSKILL.md",true,[78,84],{"path":79,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":82,"sourceHtmlUrl":83},"templates\u002Fadr-template.md","REFERENCE","参考文档",5356,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002Ftemplates\u002Fadr-template.md",{"path":85,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":86,"sourceHtmlUrl":87},"templates\u002Fsystem-doc-template.md",11721,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002Ftemplates\u002Fsystem-doc-template.md",[89,98,106,114,122,130],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":97},"01M73H7XKBHE1ETQDZT94MF9HH","seedance-prompt-en","Write effective prompts for Jimeng Seedance 2.0 multimodal AI video generation. Use when users want to create video prompts using text, images, videos, and audio inputs with the @ reference system. Covers camera movements, effects replication, video extension, editing, music beat-matching, e-commerce ads, short dramas, and educational content.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":102,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":97},"01M73GRE9998Q1DZWC71N41JWG","onepage-pdf","Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file\u002Freport\u002Fproposal into a \"single-page PDF\", \"long PDF\", \"不分页 PDF\", \"单页 PDF\", \"长图式 PDF\", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":110,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":97},"01M73GQG1KZDADVPV3MHAT1J5A","native-feel-cross-platform-desktop","Use when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a native app to its users — fast launch, native windowing, native input handling, native materials. Trigger words include \"cross-platform desktop\", \"Electron alternative\", \"Tauri vs native\", \"WebView wrapper\", \"near-native performance\", \"Raycast architecture\", \"WebKit\u002FWebView2 quirks\", \"WKWebView\", \"system tray app\", \"global hotkey app\", \"launcher app\". Do NOT trigger this skill for pure web apps, pure mobile apps, or for greenfield projects that have no native-feel requirement.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FSKILL.md",[],[],{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":118,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":97},"01M73G87PDNSMKG2FHWCYER6N8","gstack","Router for the gstack skill suite. (gstack)","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FSKILL.md",[],[],{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":126,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":97},"01M73G3EAQWKCM8DB8D0N0QSVG","fireworks-tech-graph","Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent\u002Fmemory, or concept map - and export as SVG+PNG. Trigger on: \"画图\" \"帮我画\" \"生成图\" \"做个图\" \"架构图\" \"流程图\" \"可视化一下\" \"出图\" \"generate diagram\" \"draw diagram\" \"visualize\" or any system\u002Fflow description the user wants illustrated.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FSKILL.md",[],[],{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":97},"01M73G086AXAH9DW1H5G5N3CPB","dbs-video-extract","接收抖音、小红书、微信视频号等短视频链接或分享文案，查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用；运行前检查 TikHub 与轻抖使用凭证，缺少时用新手能理解的方式引导购买和安全配置。","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fdbs-video-extract\u002FSKILL.md",[],[]]