[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PVAA2206QDB57W32SNF0N5":3,"skill-same:01M6PVAA2206QDB57W32SNF0N5":61},{"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":33,"linkOnly":34,"markdownContent":35,"markdownBody":36,"frontMatter":37,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":40,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":46,"install":47,"resources":60},"01M6PVAA2206QDB57W32SNF0N5","d2-diagrams",null,"How a d2 diagram in this repo is drawn and rendered. Use when editing a `.d2` file, `docs\u002Fassets\u002Fdiagrams\u002F_palette.d2`, or `docs\u002Fassets\u002Fdiagrams\u002Frender.sh`.","muratovv\u002Fai-hats","muratovv","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7502801?v=4","01M6JGCBN4KEJX012GPJVSH04T","Fedor Muratov","01M6JGCBSNMN7CW3RGTPPE0MN2",3,"MIT","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fd2-diagrams\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32],"diagrams","d2 diagrams","d2","docs","diagram","file","how","assets","editing","repo","use","d2 diagram","palette","render","2026-11-10 10:12:30",false,"---\nname: d2-diagrams\ndescription: >-\n  How a d2 diagram in this repo is drawn and rendered. Use when editing a\n  `.d2` file, `docs\u002Fassets\u002Fdiagrams\u002F_palette.d2`, or\n  `docs\u002Fassets\u002Fdiagrams\u002Frender.sh`.\nlicense: MIT\nai_hats:\n  schema_version: 1\n  type: skill\n---\n\n# d2 diagrams\n\n## When to Use\n\nEditing or adding a file under `docs\u002Fassets\u002Fdiagrams\u002F`. Not mermaid, and not\nthe release checklist — that stays on the maintainer role.\n\n## Diagrams (d2)\n\nSources live at `docs\u002Fassets\u002Fdiagrams\u002F*.d2`; the brand-light palette is\nshared via `docs\u002Fassets\u002Fdiagrams\u002F_palette.d2` (imported in every diagram\nas `vars: @.\u002F_palette`). Render with `bash docs\u002Fassets\u002Fdiagrams\u002Frender.sh\n[\u003Cstem>]` — the script auto-extracts Source Code Pro Medium \u002F SemiBold \u002F\nMedium-Italic statics to `$TMPDIR\u002Fai-hats-fonts\u002F` on first run. Commit\nboth `.d2` source and `.svg` artifact; do NOT commit `.png`. Full\ntoolchain + shape conventions: `CONTRIBUTING.md#diagrams`.\n\n**Multiline labels.** Inside default or double-quoted label strings,\n`\\n` works for plain nodes:\n\n    node: First line\\nSecond line\n    node2: \"First line\\nSecond line\"\n\nSingle-quoted strings do NOT interpret escapes — `'foo\\nbar'` renders the\nliteral `\\n` characters. The `|md ... |` block syntax is reliable for\n`shape: callout` but fragile on plain nodes in sketch mode (labels often\ncollapse to a single line) — prefer `\\n` for plain nodes.\n\n**Theme overrides.** `vars.d2-config.theme-overrides` applies to both\nlight and dark `theme-id` standalone. The separate `dark-theme-overrides`\nfield applies only when a light theme is the default and a dark theme is\nset as an alternate — using it for `theme-id: 200` alone silently leaves\nthe Catppuccin Mocha base in place on the first attempt.\n\n**Palette slot map** (16 slots from `_palette.d2`): `N1`–`N7` neutrals\n(text → cream background `#faf2e6`), `B1`–`B6` navy spectrum (box fills,\narrow strokes), `AA2\u002FAA4\u002FAA5` brand-orange variants (`AA4 = #e8632b`,\nused for cylinder\u002Foval storage shapes), `AB4\u002FAB5` cream\u002Fbeige (soft\naccent parallelograms).\n\n**Containers + nested direction.** `direction: \u003Cinner>` inside a container\ncan be silently ignored by the ELK layout engine when it conflicts with\nthe outer direction. The backlog FSMs were once attempted as one diagram\nwith three containers → unreadable; resolved by splitting into 3 separate\n`.d2` files. Prefer **separate files** for independent diagrams when more\nthan ~10 nodes are involved.\n\n## Validation scenario\n\nRED: asked to add a second line to a plain node, the agent writes\n`'foo\\nbar'`. The render shows the characters `\\n`. The fix is a default\nor double-quoted label, where `\\n` is a newline.\n\n## Completion\n\n- The diagram uses the shared palette and renders with `render.sh`.\n- A multiline plain-node label is not single-quoted.\n- Both the `.d2` source and the `.svg` are committed. No `.png`.\n\n## Anti-Patterns\n\n- Single-quoted `\\n` — the escape is drawn literally.\n- `dark-theme-overrides` on a standalone dark `theme-id` — the Mocha base stays.\n- One file of independent diagrams — ELK drops a nested `direction`.\n","# d2 diagrams\n\n## When to Use\n\nEditing or adding a file under `docs\u002Fassets\u002Fdiagrams\u002F`. Not mermaid, and not\nthe release checklist — that stays on the maintainer role.\n\n## Diagrams (d2)\n\nSources live at `docs\u002Fassets\u002Fdiagrams\u002F*.d2`; the brand-light palette is\nshared via `docs\u002Fassets\u002Fdiagrams\u002F_palette.d2` (imported in every diagram\nas `vars: @.\u002F_palette`). Render with `bash docs\u002Fassets\u002Fdiagrams\u002Frender.sh\n[\u003Cstem>]` — the script auto-extracts Source Code Pro Medium \u002F SemiBold \u002F\nMedium-Italic statics to `$TMPDIR\u002Fai-hats-fonts\u002F` on first run. Commit\nboth `.d2` source and `.svg` artifact; do NOT commit `.png`. Full\ntoolchain + shape conventions: `CONTRIBUTING.md#diagrams`.\n\n**Multiline labels.** Inside default or double-quoted label strings,\n`\\n` works for plain nodes:\n\n    node: First line\\nSecond line\n    node2: \"First line\\nSecond line\"\n\nSingle-quoted strings do NOT interpret escapes — `'foo\\nbar'` renders the\nliteral `\\n` characters. The `|md ... |` block syntax is reliable for\n`shape: callout` but fragile on plain nodes in sketch mode (labels often\ncollapse to a single line) — prefer `\\n` for plain nodes.\n\n**Theme overrides.** `vars.d2-config.theme-overrides` applies to both\nlight and dark `theme-id` standalone. The separate `dark-theme-overrides`\nfield applies only when a light theme is the default and a dark theme is\nset as an alternate — using it for `theme-id: 200` alone silently leaves\nthe Catppuccin Mocha base in place on the first attempt.\n\n**Palette slot map** (16 slots from `_palette.d2`): `N1`–`N7` neutrals\n(text → cream background `#faf2e6`), `B1`–`B6` navy spectrum (box fills,\narrow strokes), `AA2\u002FAA4\u002FAA5` brand-orange variants (`AA4 = #e8632b`,\nused for cylinder\u002Foval storage shapes), `AB4\u002FAB5` cream\u002Fbeige (soft\naccent parallelograms).\n\n**Containers + nested direction.** `direction: \u003Cinner>` inside a container\ncan be silently ignored by the ELK layout engine when it conflicts with\nthe outer direction. The backlog FSMs were once attempted as one diagram\nwith three containers → unreadable; resolved by splitting into 3 separate\n`.d2` files. Prefer **separate files** for independent diagrams when more\nthan ~10 nodes are involved.\n\n## Validation scenario\n\nRED: asked to add a second line to a plain node, the agent writes\n`'foo\\nbar'`. The render shows the characters `\\n`. The fix is a default\nor double-quoted label, where `\\n` is a newline.\n\n## Completion\n\n- The diagram uses the shared palette and renders with `render.sh`.\n- A multiline plain-node label is not single-quoted.\n- Both the `.d2` source and the `.svg` are committed. No `.png`.\n\n## Anti-Patterns\n\n- Single-quoted `\\n` — the escape is drawn literally.\n- `dark-theme-overrides` on a standalone dark `theme-id` — the Mocha base stays.\n- One file of independent diagrams — ELK drops a nested `direction`.\n",{"name":5,"ai_hats":38,"license":15,"description":7},{"type":39,"schema_version":40},"skill",1,"master","f922a7f627276366873d546942d9ad899a86f71a","packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fd2-diagrams","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats","https:\u002F\u002Fgithub.com\u002Fmuratovv","2026-11-05 20:59:10",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add muratovv\u002Fai-hats --skill d2-diagrams",{"tool":53,"command":54},"bunx","bunx skills add muratovv\u002Fai-hats --skill d2-diagrams",{"tool":56,"command":57},"pnpm","pnpm dlx skills add muratovv\u002Fai-hats --skill d2-diagrams","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fd2-diagrams\u002FSKILL.md",true,[],[62,88,113,136,160,174],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":33},"01M6PVFB1SM738R2SRSRSF7CY6","tool-evaluation-protocol","Time-bounded protocol for evaluating new tools, libraries, or methodologies before adoption. Use when evaluating a candidate dependency for the project, researching a methodology (e.g. ML\u002FLLM frameworks, testing approaches), or following up on a hype-driven recommendation.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Ftool-evaluation-protocol\u002FSKILL.md",[],[69,70,71,72,73,74,75,76,77,78,29,79,80,81,82,83,84,85,86,87],"protocol","Evaluation","tool","tool evaluation protocol","testing","ml","libraries","adoption","methodology","Tools","dependency","up","frameworks","time","project","recommendation","for","bounded","candidate",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":33},"01M6PVF7HATBEX1G7N50E2QT57","systematic-debugging","4-phase bug-fix protocol (evidence, pattern, hypothesis, verify). Use when investigating any error, failure, or unexpected behavior, handling bug reports from users or monitoring, or diagnosing test failures with non-obvious causes.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[95,96,97,98,69,99,100,101,102,103,29,104,105,106,107,108,109,110,111,112],"systematic debugging","debugging","systematic","test","monitoring","hypothesis","verify","behavior","fix","evidence","bug","reports","pattern","users","error","with","bug-fix","phase",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":124,"publishedAt":33},"01M6PVF3MTQN3RPF73AN34856J","skill-template","Canonical template and validation guide for ai-hats skills. Use when creating a new skill, reviewing an existing one for structural compliance, or deciding which pattern fits a new behavior.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fskill-template\u002FSKILL.md",[119],{"categoryNo":120,"categoryName":121,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[125,126,127,128,129,102,130,29,131,107,132,133,134,85,135],"template","skill template","validation","compliance","hats","guide","new skill","structural","canonical","which","Existing",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":143,"publishedAt":33},"01M6PVF06SCV28QARM5MQPANC9","skill-optimization","Audit and refactor library components to eliminate redundancy and staleness. Use during periodic library maintenance, after adding multiple new skills or rules, when a role's token budget is too high, or after retrospectives identify component issues.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fskill-optimization\u002FSKILL.md",[142],{"categoryNo":120,"categoryName":121,"taxonomyType":122,"taxonomyTypeDesc":123},[144,145,146,147,148,149,150,151,152,153,29,154,155,156,157,158,159],"Optimization","skill optimization","components","component","issues","library","audit","refactor","Budget","Rules","periodic","maintenance","token","token budget","role","high",{"skillNo":161,"name":162,"nameZh":6,"description":163,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":164,"categories":165,"keywords":166,"publishedAt":33},"01M6PVEXM9717016T9MW82HDCT","silent-fallback-gate","PreToolUse hook — refuses an Edit or Write that adds an inert broad except. Use when a Python edit was blocked for a silent fallback.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fsilent-fallback-gate\u002FSKILL.md",[],[167,168,169,170,171,172,29,173,85],"gate","fallback","silent fallback gate","python","write","edit","hook",{"skillNo":175,"name":176,"nameZh":6,"description":177,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":178,"categories":179,"keywords":181,"publishedAt":33},"01M6PVESM49C5NT7SB7N3F76VS","retro-to-framework","Convert an observation about agent behavior — from a retrospective or from a single incident — into a framework-level change (hook, rule, skill, skill update). Use after a retrospective identifies problems that are not project-specific, after an incident where an agent misapplied a component it had read, when CLAUDE.md band-aids accumulate (more than 3 per-project rules that could be generic), or when the same problem recurs across multiple projects.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fretro-to-framework\u002FSKILL.md",[180],{"categoryNo":120,"categoryName":121,"taxonomyType":122,"taxonomyTypeDesc":123},[182,183,184,185,147,186,187,188,153,102,29,189,190,83,191,192,193,194,195,196],"framework","retro","retro to framework","change","retrospective","projects","convert","incident","across","problem","about","more","skill update","single","generic"]