[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MG6TRJ2JVAF31T2KXF7YZF":3,"skill-same:01M6MG6TRJ2JVAF31T2KXF7YZF":75},{"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":23,"publishedAt":46,"linkOnly":47,"markdownContent":48,"markdownBody":49,"frontMatter":50,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":54,"repositoryHtmlUrl":55,"repositoryHomepageUrl":56,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6MG6TRJ2JVAF31T2KXF7YZF","book-technical",null,"Technical book craft reference: concept gradient, running project, failure-first teaching, code standards, diagrams, exercises, version handling, the technical-book AI tells. Read by all agents on programming, engineering, and data science books.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fepicsagas\u002FVelith\u002Fskills\u002Fbook-technical\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"book technical","book","technical","reference","running","gradient","concept","books","project","teaching","craft","diagrams","data science","standards","code standards","version","read","programming","science","first","data","code","2026-11-10 10:12:30",false,"---\nname: book-technical\ndescription: \"Technical book craft reference: concept gradient, running project, failure-first teaching, code standards, diagrams, exercises, version handling, the technical-book AI tells. Read by all agents on programming, engineering, and data science books.\"\n---\n\n# Technical\n\nThe reader of a technical book is trying to become someone who can do the thing. Every chapter must move them closer to doing it themselves, and the surest sign of a book that fails is a reader who can follow along but cannot deviate.\n\n## Structure\n\nDefault: **Intro (10-15%) → Foundations (25%) → Practice (30%) → Advanced (20%) → Reference (10%)**. Within that:\n\n- **Running project.** The reader builds one thing across the book. Each chapter adds a capability. By the end they have something that works and that they understand every line of. Books without a running project produce readers who have read about the thing.\n- **Concept gradient**: each concept is introduced once, at the first chapter that needs it, with the minimum needed then, and deepened later where it becomes necessary. The outline's dependency DAG enforces this; the architect verifies there are no forward references.\n- **Difficulty is monotonic non-decreasing** within a part; the first chapter of a part can step back slightly.\n- **Reference material** (API tables, option lists) goes to the back or an appendix, never inside a teaching chapter.\n\n## Failure-first teaching\n\nThe single largest gap between AI technical writing and good human technical writing: humans show the thing going wrong.\n\n- Show the naive version first. Run it. Show the actual error message or wrong output.\n- Explain why it fails in terms of the mental model, not just the fix.\n- Then the correct version. Then what else would have broken it.\n- Debugging is a chapter topic, not an afterthought. How would the reader know something is wrong? What would they look at first?\n- Performance, security, and edge cases appear where the reader would first hit them, not in a separate \"advanced considerations\" chapter.\n\n## Code standards\n\n- Every code block has a language tag and, when it is a file, a filename comment on line 1.\n- Runnable, or explicitly labeled `# pseudocode`. Imports included. Expected output shown after.\n- Lengths: 10-30 lines when introducing; 30-80 when building; 80+ only for a complete listing, and then with the key section explained separately.\n- Version pinned in `PRD.md` and stated once in the introduction; not repeated per chapter. Breaking changes and security-relevant versions are called out inline.\n- Prefer \"save the file\" to \"click File → Save\"; UI paths change, concepts do not.\n- The fact-checker runs code blocks where the environment allows. Write code that can be run.\n- Diagrams: Mermaid for flow\u002Fsequence, ASCII fallback for EPUB readers that do not render Mermaid, tables for comparisons. At most three per chapter.\n\n## Chapter design\n\n- **Hook**: a concrete task or a concrete failure the reader recognizes\n- **Concept**: minimum needed now, linked to what they already know from earlier chapters\n- **Build**: add to the running project; show the code, run it, show the output\n- **Break**: what goes wrong when the reader deviates; show it\n- **Explain**: the model behind the fix\n- **Exercise**: one thing the reader does without the book's hand (three levels: guided, hinted, goal-only)\n- **Exit**: what the next capability is and why the current build needs it. Not a summary.\n\n## Technical-book tells\n\n- Every chapter starts with \"In this chapter, you will learn.\"\n- Code that always works on the first try.\n- Explanations that restate the code line by line without adding a model.\n- \"It is important to note that\" before every caveat.\n- Bullet lists of \"best practices\" with no reasoning.\n- Diagrams of boxes and arrows that add nothing to the prose.\n- Exercises that repeat the chapter's example with a variable renamed.\n- A \"conclusion\" section per chapter.\n- Uniform confidence about tradeoffs that are genuinely contested.\n- Analogies for concepts that are simpler than the analogy.\n\n## Language notes\n\n- Korean technical books: 개발자 독자는 영문 용어 병기를 기대한다 (예: 컨텍스트 윈도(context window)). 첫 등장 시 병기, 이후 한글 또는 원어 중 STYLE.md에서 정한 쪽. 코드 주석은 영문 또는 한글 중 하나로 통일. 경어체(합니다체) 또는 평서체(한다체) 하나로 고정.\n- English: second person, present tense, active voice. \"You\" is the reader; \"we\" only if the fingerprint allows.\n- Japanese: です・ます体 for tutorials; だ・である体 for reference sections; do not mix within a chapter.\n\n## Validation (architect scoring for technical)\n\nDAG has no cycles and no forward references; running project defined and advanced in every practice chapter; failure shown in every build chapter; difficulty monotonic within parts; exercise per chapter with three levels; versions pinned; reference material segregated; diagrams ≤ 3\u002Fchapter and each does work the prose cannot.\n\n## Visuals\n\nDiagrams are code (Mermaid, D2, Graphviz, SVG), versioned in `visuals\u002Ffigures\u002Fsrc\u002F`, rendered to SVG for EPUB and PNG for print, with a single theme file for fonts and color roles. Architecture, sequence, state, and data-flow diagrams use the same node and edge grammar throughout (art bible figure system). Screenshots are real and cropped to the relevant region, annotated in SVG overlays, and dated in the caption if the UI may change. Terminal output is a code block, never an image. Charts from measured data with units. ≤ 3 figures per chapter; each does work the prose cannot. `figure-engineer` produces; `fact-checker` verifies every label against the text and the running project's actual state.\n","# Technical\n\nThe reader of a technical book is trying to become someone who can do the thing. Every chapter must move them closer to doing it themselves, and the surest sign of a book that fails is a reader who can follow along but cannot deviate.\n\n## Structure\n\nDefault: **Intro (10-15%) → Foundations (25%) → Practice (30%) → Advanced (20%) → Reference (10%)**. Within that:\n\n- **Running project.** The reader builds one thing across the book. Each chapter adds a capability. By the end they have something that works and that they understand every line of. Books without a running project produce readers who have read about the thing.\n- **Concept gradient**: each concept is introduced once, at the first chapter that needs it, with the minimum needed then, and deepened later where it becomes necessary. The outline's dependency DAG enforces this; the architect verifies there are no forward references.\n- **Difficulty is monotonic non-decreasing** within a part; the first chapter of a part can step back slightly.\n- **Reference material** (API tables, option lists) goes to the back or an appendix, never inside a teaching chapter.\n\n## Failure-first teaching\n\nThe single largest gap between AI technical writing and good human technical writing: humans show the thing going wrong.\n\n- Show the naive version first. Run it. Show the actual error message or wrong output.\n- Explain why it fails in terms of the mental model, not just the fix.\n- Then the correct version. Then what else would have broken it.\n- Debugging is a chapter topic, not an afterthought. How would the reader know something is wrong? What would they look at first?\n- Performance, security, and edge cases appear where the reader would first hit them, not in a separate \"advanced considerations\" chapter.\n\n## Code standards\n\n- Every code block has a language tag and, when it is a file, a filename comment on line 1.\n- Runnable, or explicitly labeled `# pseudocode`. Imports included. Expected output shown after.\n- Lengths: 10-30 lines when introducing; 30-80 when building; 80+ only for a complete listing, and then with the key section explained separately.\n- Version pinned in `PRD.md` and stated once in the introduction; not repeated per chapter. Breaking changes and security-relevant versions are called out inline.\n- Prefer \"save the file\" to \"click File → Save\"; UI paths change, concepts do not.\n- The fact-checker runs code blocks where the environment allows. Write code that can be run.\n- Diagrams: Mermaid for flow\u002Fsequence, ASCII fallback for EPUB readers that do not render Mermaid, tables for comparisons. At most three per chapter.\n\n## Chapter design\n\n- **Hook**: a concrete task or a concrete failure the reader recognizes\n- **Concept**: minimum needed now, linked to what they already know from earlier chapters\n- **Build**: add to the running project; show the code, run it, show the output\n- **Break**: what goes wrong when the reader deviates; show it\n- **Explain**: the model behind the fix\n- **Exercise**: one thing the reader does without the book's hand (three levels: guided, hinted, goal-only)\n- **Exit**: what the next capability is and why the current build needs it. Not a summary.\n\n## Technical-book tells\n\n- Every chapter starts with \"In this chapter, you will learn.\"\n- Code that always works on the first try.\n- Explanations that restate the code line by line without adding a model.\n- \"It is important to note that\" before every caveat.\n- Bullet lists of \"best practices\" with no reasoning.\n- Diagrams of boxes and arrows that add nothing to the prose.\n- Exercises that repeat the chapter's example with a variable renamed.\n- A \"conclusion\" section per chapter.\n- Uniform confidence about tradeoffs that are genuinely contested.\n- Analogies for concepts that are simpler than the analogy.\n\n## Language notes\n\n- Korean technical books: 개발자 독자는 영문 용어 병기를 기대한다 (예: 컨텍스트 윈도(context window)). 첫 등장 시 병기, 이후 한글 또는 원어 중 STYLE.md에서 정한 쪽. 코드 주석은 영문 또는 한글 중 하나로 통일. 경어체(합니다체) 또는 평서체(한다체) 하나로 고정.\n- English: second person, present tense, active voice. \"You\" is the reader; \"we\" only if the fingerprint allows.\n- Japanese: です・ます体 for tutorials; だ・である体 for reference sections; do not mix within a chapter.\n\n## Validation (architect scoring for technical)\n\nDAG has no cycles and no forward references; running project defined and advanced in every practice chapter; failure shown in every build chapter; difficulty monotonic within parts; exercise per chapter with three levels; versions pinned; reference material segregated; diagrams ≤ 3\u002Fchapter and each does work the prose cannot.\n\n## Visuals\n\nDiagrams are code (Mermaid, D2, Graphviz, SVG), versioned in `visuals\u002Ffigures\u002Fsrc\u002F`, rendered to SVG for EPUB and PNG for print, with a single theme file for fonts and color roles. Architecture, sequence, state, and data-flow diagrams use the same node and edge grammar throughout (art bible figure system). Screenshots are real and cropped to the relevant region, annotated in SVG overlays, and dated in the caption if the UI may change. Terminal output is a code block, never an image. Charts from measured data with units. ≤ 3 figures per chapter; each does work the prose cannot. `figure-engineer` produces; `fact-checker` verifies every label against the text and the running project's actual state.\n",{"name":5,"description":7},"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fepicsagas\u002FVelith\u002Fskills\u002Fbook-technical",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill book-technical",{"tool":67,"command":68},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill book-technical",{"tool":70,"command":71},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill book-technical","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fepicsagas\u002FVelith\u002Fskills\u002Fbook-technical\u002FSKILL.md",true,[],[76,86,94,102,110,118],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":85},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":85},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":98,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":85},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":106,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":85},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":114,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":85},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":122,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":85},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]