[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74EQSFEG06NQSVMMMPRME4H":3,"skill-same:01M74EQSFEG06NQSVMMMPRME4H":56},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M74EQSFEG06NQSVMMMPRME4H","technical-document-craftsmanship",null,"Skill #37 — Technical Document Craftsmanship","CarlosCaPe\u002Foctorato","CarlosCaPe","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F39838249?v=4","01M72WXX4ZRR8MBH1EP1QND2FQ","dataqbs","01M72WXX5NA7YCKRSJ54GW1GQ8",18,"MIT","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Ftechnical-document-craftsmanship\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: technical-document-craftsmanship\ndescription: \"Skill #37 — Technical Document Craftsmanship\"\nmetadata:\n  short-description: \"Skill #37 — Technical Document Craftsmanship\"\n  original-index: 37\n---\n\n# Skill #37 — Technical Document Craftsmanship\n\n## Category: Process\n\n## Origin\n\nPROJ-100 — Acme Corp Migration Evaluation TDD\n\n## Principle\n\n> **The reader sees the final document, not the git history.**\n\nA technical document must read as a coherent, intentional artifact — not as a series of patches. Every section, term, and framing choice must be deliberate and consistent. If the document says \"migrate\" in one section and \"consolidate\" in another, the reader loses trust in the author's precision.\n\n## Why This Matters\n\n- **ARB members, leadership, and cross-team stakeholders** read the document once. They don't see our commits, our iterations, or our corrections.\n- **Inconsistent terminology** signals sloppy thinking. If we can't be precise about words, can we be precise about migration cost estimates?\n- **Draft vs. final is invisible** — the first version we share IS the final version in the reader's eyes. There are no \"first drafts\" once the document leaves our hands.\n\n## The Rules\n\n### 1. Terminology Consistency\n\nPick one term and use it everywhere. If the action is \"migrate,\" never write \"consolidate,\" \"move,\" \"transition,\" or \"convert\" as synonyms unless each has a distinct, defined meaning in the glossary.\n\n**Example — PROJ-100:**\n\n| Wrong (inconsistent) | Right (consistent) |\n|---|---|\n| \"Can we consolidate?\" (§1) + \"Can we migrate?\" (§2.3.5) | \"Can we migrate?\" everywhere — because that's the action being evaluated |\n\n### 2. Scope Alignment\n\nEvery statement must align with the document's declared scope. If the scope says \"Migration Feasibility Study,\" don't frame questions as \"consolidation\" — that's a strategic decision above our scope.\n\n| Term | Who Owns It | Our Role |\n|---|---|---|\n| **Migrate** | Engineering (us) | Evaluate feasibility, cost, risk |\n| **Consolidate** | Leadership \u002F ARB | Strategic decision based on our evaluation |\n\n### 3. Section Independence\n\nEach section should be readable in isolation. If someone jumps to §3.5.4 (Concurrency Model), they shouldn't need to read §1 to understand the framing. Don't rely on \"we fixed this in a later section\" — every section must stand on its own.\n\n### 4. No Visible Iteration Artifacts\n\n- No \"UPDATED:\" or \"FIXED:\" markers in the document body\n- No \"this was previously incorrect\" — just write the correct thing\n- No change logs inside the document — that's what git is for\n- Headers like \"The Question We Must Answer\" appear exactly once, in the right place\n\n### 5. Glossary as Contract\n\nIf a term appears in the document, it must be in the glossary. If it's in the glossary, it must be used consistently. The glossary is not a reference appendix — it's a **contract** with the reader about what words mean.\n\n## Checklist\n\n| # | Check | When |\n|---|-------|------|\n| 1 | Is every key term used consistently across all sections? | Before sharing |\n| 2 | Does each section align with the declared scope? | Before sharing |\n| 3 | Can each section be read independently without confusion? | Before sharing |\n| 4 | Are there any iteration artifacts visible to the reader? | Before sharing |\n| 5 | Is every term in the glossary used consistently in the body? | Before sharing |\n| 6 | Would someone reading this for the first time see a coherent document? | Before sharing |\n\n## Anti-Patterns\n\n| Anti-Pattern | Why It's Wrong | Fix |\n|---|---|---|\n| Using \"consolidate\" and \"migrate\" interchangeably | They mean different things and signal different ownership | Pick one; define it in glossary |\n| Duplicate headers in different sections | Reader sees two \"Questions We Must Answer\" and doesn't know which is authoritative | One canonical location per heading |\n| Leaving placeholder text from iterations | \"TBD — will be updated\" in a shared document undermines credibility | Either fill it or remove the section |\n| Framing our work beyond our scope | \"We recommend consolidation\" when our scope is migration feasibility | Stay in lane — evaluate, don't prescribe strategy |\n\n## Relationship to Other Skills\n\n| Skill | Relationship |\n|-------|-------------|\n| #08 — Deep Grep Code Review | Grep the document for inconsistent terms before sharing |\n| #11 — Gap Analysis Pattern | Same [OK]\u002F[--]\u002F[!!] discipline applies to document sections |\n| #14 — Research Checklist Discipline | Research the correct terminology before writing |\n| #36 — GitHub Copilot Usage Policy | AI-generated text must meet the same craftsmanship standard |\n\n---\n\n*Origin: PROJ-100 — Discovered when \"consolidate\" and \"migrate\" were used interchangeably in the Acme Corp TDD. The reader would have seen two different framings of the same question.*\n","# Skill #37 — Technical Document Craftsmanship\n\n## Category: Process\n\n## Origin\n\nPROJ-100 — Acme Corp Migration Evaluation TDD\n\n## Principle\n\n> **The reader sees the final document, not the git history.**\n\nA technical document must read as a coherent, intentional artifact — not as a series of patches. Every section, term, and framing choice must be deliberate and consistent. If the document says \"migrate\" in one section and \"consolidate\" in another, the reader loses trust in the author's precision.\n\n## Why This Matters\n\n- **ARB members, leadership, and cross-team stakeholders** read the document once. They don't see our commits, our iterations, or our corrections.\n- **Inconsistent terminology** signals sloppy thinking. If we can't be precise about words, can we be precise about migration cost estimates?\n- **Draft vs. final is invisible** — the first version we share IS the final version in the reader's eyes. There are no \"first drafts\" once the document leaves our hands.\n\n## The Rules\n\n### 1. Terminology Consistency\n\nPick one term and use it everywhere. If the action is \"migrate,\" never write \"consolidate,\" \"move,\" \"transition,\" or \"convert\" as synonyms unless each has a distinct, defined meaning in the glossary.\n\n**Example — PROJ-100:**\n\n| Wrong (inconsistent) | Right (consistent) |\n|---|---|\n| \"Can we consolidate?\" (§1) + \"Can we migrate?\" (§2.3.5) | \"Can we migrate?\" everywhere — because that's the action being evaluated |\n\n### 2. Scope Alignment\n\nEvery statement must align with the document's declared scope. If the scope says \"Migration Feasibility Study,\" don't frame questions as \"consolidation\" — that's a strategic decision above our scope.\n\n| Term | Who Owns It | Our Role |\n|---|---|---|\n| **Migrate** | Engineering (us) | Evaluate feasibility, cost, risk |\n| **Consolidate** | Leadership \u002F ARB | Strategic decision based on our evaluation |\n\n### 3. Section Independence\n\nEach section should be readable in isolation. If someone jumps to §3.5.4 (Concurrency Model), they shouldn't need to read §1 to understand the framing. Don't rely on \"we fixed this in a later section\" — every section must stand on its own.\n\n### 4. No Visible Iteration Artifacts\n\n- No \"UPDATED:\" or \"FIXED:\" markers in the document body\n- No \"this was previously incorrect\" — just write the correct thing\n- No change logs inside the document — that's what git is for\n- Headers like \"The Question We Must Answer\" appear exactly once, in the right place\n\n### 5. Glossary as Contract\n\nIf a term appears in the document, it must be in the glossary. If it's in the glossary, it must be used consistently. The glossary is not a reference appendix — it's a **contract** with the reader about what words mean.\n\n## Checklist\n\n| # | Check | When |\n|---|-------|------|\n| 1 | Is every key term used consistently across all sections? | Before sharing |\n| 2 | Does each section align with the declared scope? | Before sharing |\n| 3 | Can each section be read independently without confusion? | Before sharing |\n| 4 | Are there any iteration artifacts visible to the reader? | Before sharing |\n| 5 | Is every term in the glossary used consistently in the body? | Before sharing |\n| 6 | Would someone reading this for the first time see a coherent document? | Before sharing |\n\n## Anti-Patterns\n\n| Anti-Pattern | Why It's Wrong | Fix |\n|---|---|---|\n| Using \"consolidate\" and \"migrate\" interchangeably | They mean different things and signal different ownership | Pick one; define it in glossary |\n| Duplicate headers in different sections | Reader sees two \"Questions We Must Answer\" and doesn't know which is authoritative | One canonical location per heading |\n| Leaving placeholder text from iterations | \"TBD — will be updated\" in a shared document undermines credibility | Either fill it or remove the section |\n| Framing our work beyond our scope | \"We recommend consolidation\" when our scope is migration feasibility | Stay in lane — evaluate, don't prescribe strategy |\n\n## Relationship to Other Skills\n\n| Skill | Relationship |\n|-------|-------------|\n| #08 — Deep Grep Code Review | Grep the document for inconsistent terms before sharing |\n| #11 — Gap Analysis Pattern | Same [OK]\u002F[--]\u002F[!!] discipline applies to document sections |\n| #14 — Research Checklist Discipline | Research the correct terminology before writing |\n| #36 — GitHub Copilot Usage Policy | AI-generated text must meet the same craftsmanship standard |\n\n---\n\n*Origin: PROJ-100 — Discovered when \"consolidate\" and \"migrate\" were used interchangeably in the Acme Corp TDD. The reader would have seen two different framings of the same question.*\n",{"name":5,"metadata":24,"description":7},{"original-index":25,"short-description":7},37,"master","b4414608cd5a3f87d1525b518f1c6add8363540d","skills\u002Ftechnical-document-craftsmanship",6,"https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato","https:\u002F\u002Fwww.dataqbs.com\u002Foctorato","https:\u002F\u002Fgithub.com\u002FCarlosCaPe","www.dataqbs.com"," AI-powered data engineering\r\n& consulting\r\n\r\nWe build data platforms that turn complexity into clarity — from cloud architecture and ETL pipelines to AI-driven","2026-11-14 00:21:00",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add CarlosCaPe\u002Foctorato --skill technical-document-craftsmanship",{"tool":42,"command":43},"bunx","bunx skills add CarlosCaPe\u002Foctorato --skill technical-document-craftsmanship",{"tool":45,"command":46},"pnpm","pnpm dlx skills add CarlosCaPe\u002Foctorato --skill technical-document-craftsmanship","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Ftechnical-document-craftsmanship\u002FSKILL.md",true,[50],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"skill.json","REFERENCE","参考文档",177,"https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Ftechnical-document-craftsmanship\u002Fskill.json",[57,66,74,81,89,97],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":61,"licenseFileUrl":62,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M74EVAA4A4B4AKR5TT732GP4","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":61,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M74EV4WMRDKP2NQS4YWR8PXH","wrangler","Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fwrangler\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fwrangler\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M74EV05MHTXKEXD4B2QJEYTF","workspace-skill-discovery","Discover and include ALL skills across the workspace — not just global ones. Use at the start of every session or when the user asks about available skills. Ensures project-level skills (under .claude\u002Fskills\u002F or skills\u002F in any repo) are never missed.","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fworkspace-skill-discovery\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":61,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M74ETV78525B4VP2F28Z6NRD","workers-best-practices","Reviews and authors Cloudflare Workers code against production best practices. Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability). Biases towards retrieval from Cloudflare docs over pre-trained knowledge.","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fworkers-best-practices\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fworkers-best-practices\u002FSKILL.md",[],[],{"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":61,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M74ETR75NF67WGVEN7288ACV","winui-app","Create, build and design WinUI 3 desktop apps with C# and the Windows App SDK following Microsoft's official guidance and CommunityToolkit. Covers XAML, navigation, theming, accessibility and deployment.","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fwinui-app\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fwinui-app\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M74ETJFRNPPNSQZ36C6HD6CW","windows-brain-script-portability","Scripts in ~\u002F.claude\u002Fscripts\u002F that run on a Windows brain: use the python3.cmd shim and not bare python3, and reconfigure stdout to UTF-8 if you print symbols. Use it when writing a brain script or triaging a Windows-only crash.","https:\u002F\u002Fgithub.com\u002FCarlosCaPe\u002Foctorato\u002Fblob\u002Fmaster\u002Fskills\u002Fwindows-brain-script-portability\u002FSKILL.md",[],[]]