[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PVATV8HVWAYKJFBHEK91X9":3,"skill-same:01M6PVATV8HVWAYKJFBHEK91X9":67},{"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},"01M6PVATV8HVWAYKJFBHEK91X9","rule-delivery-gate",null,"Pre-commit gate over staged trait and role injections. Use when composing a role that carries the `ai-hats-dev` trait, or when diagnosing why the rule-delivery hook blocked a commit.","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\u002Frule-delivery-gate\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32],"gate","delivery","rule","rule delivery gate","delivery gate","commit","dev","pre-commit","why","hats","use","hook","role","staged","2026-11-10 10:12:30",false,"---\nname: rule-delivery-gate\ndescription: >-\n  Pre-commit gate over staged trait and role injections. Use when\n  composing a role that carries the `ai-hats-dev` trait, or when\n  diagnosing why the rule-delivery hook blocked a commit.\nai_hats:\n  schema_version: 1\n  type: skill\n  # hook-carrier skill. The assembler installs the script below\n  # into `.githooks\u002Fpre-commit.d\u002F` at composition time. On a staged\n  # `{ai_hats_library,library}\u002F**\u002Fconfig.yaml` it runs\n  # `python -m ai_hats.rule_delivery \u003Clibrary root>`\n  # and blocks the commit if a `see rule X` pointer names an undeliverable\n  # rule. Fail-open if python\u002Fai_hats absent; override AI_HATS_RULE_DELIVERY_ACK=1.\nlicense: MIT\n---\n\n# Rule Delivery Gate\n\nPure-infrastructure hook-carrier skill. It contributes one git pre-commit hook\nthat enforces the rule-delivery contract: a `see rule X` pointer in a\ndelivered trait\u002Frole injection must name a rule the agent can actually read.\nThere is no agent-side decision logic here — the value is delivered entirely\nthrough composition.\n\n## What it gates\n\n- **Scope:** fires only when a commit stages a trait\u002Frole injection —\n  `{ai_hats_library,library}\u002F**\u002Fconfig.yaml`: the monorepo package, or the\n  pre-monorepo `library\u002F` the e2e fixtures use. The check then scans that\n  library root at the checkout, because a pointer's validity depends on rule\n  existence across the library, not a single diff. With no library root at the\n  checkout the gate is a loud, journalled skip.\n- **Not a consumer's `libraries\u002F`:** this skill ships in the `ai-hats-dev`\n  layer, which is addressed to the ai-hats repository, not to a consuming project.\n- **Invariant:** every `see rule X` must resolve to a rule that exists in the library.\n  A pointer to a non-existent rule blocks the commit.\n- **Effect:** the same pure function the G2 unit test uses\n  (`python -m ai_hats.rule_delivery \u003Clibrary root>`) returns non-zero → commit\n  blocked with the offending `source: see rule X` lines.\n\nBecause the scope is the changed files, the gate only fires on commits that\ntouch an injection — it never retro-blocks the pre-existing library.\n\n## Who gets it\n\nWhatever composes this skill, and nothing else: the hook is written into\n`.githooks\u002Fpre-commit.d\u002F` at composition time, so a role that does not carry\nit never sees the gate. The server-side counterpart is the G2 unit test, run by CI on every PR\u002Fpush to master.\n\n## How to bypass\n\nFix the pointer — create the missing rule in the library or drop the pointer — or, after\nconfirming the pointer is intentional, ask the supervisor to skip the gate for a\nsingle commit: `AI_HATS_RULE_DELIVERY_ACK=1`, exported in the shell that runs the\ncommit. Writing it onto your own command line is refused — see **safety-guard**.\n\nIf `python` \u002F the `ai_hats` package is unavailable the hook is a loud no-op\n(fail-open): it prints a SKIPPED notice and allows the commit, so a missing dev\ntool never wedges work. Inside an ai-hats dev\u002Fagent env the package is present,\nso the gate is live.\n\n## Overrides\n\n- `AI_HATS_RULE_DELIVERY_ACK=1` — allow the current commit despite findings.\n- `AI_HATS_RULE_DELIVERY_CMD` — override the checker invocation (default:\n  `-m ai_hats.rule_delivery` under the checkout's own `.venv\u002Fbin\u002Fpython3`, else\n  `python3` on PATH); used by the test suite to inject a stub.\n","# Rule Delivery Gate\n\nPure-infrastructure hook-carrier skill. It contributes one git pre-commit hook\nthat enforces the rule-delivery contract: a `see rule X` pointer in a\ndelivered trait\u002Frole injection must name a rule the agent can actually read.\nThere is no agent-side decision logic here — the value is delivered entirely\nthrough composition.\n\n## What it gates\n\n- **Scope:** fires only when a commit stages a trait\u002Frole injection —\n  `{ai_hats_library,library}\u002F**\u002Fconfig.yaml`: the monorepo package, or the\n  pre-monorepo `library\u002F` the e2e fixtures use. The check then scans that\n  library root at the checkout, because a pointer's validity depends on rule\n  existence across the library, not a single diff. With no library root at the\n  checkout the gate is a loud, journalled skip.\n- **Not a consumer's `libraries\u002F`:** this skill ships in the `ai-hats-dev`\n  layer, which is addressed to the ai-hats repository, not to a consuming project.\n- **Invariant:** every `see rule X` must resolve to a rule that exists in the library.\n  A pointer to a non-existent rule blocks the commit.\n- **Effect:** the same pure function the G2 unit test uses\n  (`python -m ai_hats.rule_delivery \u003Clibrary root>`) returns non-zero → commit\n  blocked with the offending `source: see rule X` lines.\n\nBecause the scope is the changed files, the gate only fires on commits that\ntouch an injection — it never retro-blocks the pre-existing library.\n\n## Who gets it\n\nWhatever composes this skill, and nothing else: the hook is written into\n`.githooks\u002Fpre-commit.d\u002F` at composition time, so a role that does not carry\nit never sees the gate. The server-side counterpart is the G2 unit test, run by CI on every PR\u002Fpush to master.\n\n## How to bypass\n\nFix the pointer — create the missing rule in the library or drop the pointer — or, after\nconfirming the pointer is intentional, ask the supervisor to skip the gate for a\nsingle commit: `AI_HATS_RULE_DELIVERY_ACK=1`, exported in the shell that runs the\ncommit. Writing it onto your own command line is refused — see **safety-guard**.\n\nIf `python` \u002F the `ai_hats` package is unavailable the hook is a loud no-op\n(fail-open): it prints a SKIPPED notice and allows the commit, so a missing dev\ntool never wedges work. Inside an ai-hats dev\u002Fagent env the package is present,\nso the gate is live.\n\n## Overrides\n\n- `AI_HATS_RULE_DELIVERY_ACK=1` — allow the current commit despite findings.\n- `AI_HATS_RULE_DELIVERY_CMD` — override the checker invocation (default:\n  `-m ai_hats.rule_delivery` under the checkout's own `.venv\u002Fbin\u002Fpython3`, else\n  `python3` on PATH); used by the test suite to inject a stub.\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\u002Frule-delivery-gate","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 rule-delivery-gate",{"tool":53,"command":54},"bunx","bunx skills add muratovv\u002Fai-hats --skill rule-delivery-gate",{"tool":56,"command":57},"pnpm","pnpm dlx skills add muratovv\u002Fai-hats --skill rule-delivery-gate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Frule-delivery-gate\u002FSKILL.md",true,[61],{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"git_hooks\u002Fpre-commit-rule-delivery.sh","SCRIPT","脚本",5712,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Frule-delivery-gate\u002Fgit_hooks\u002Fpre-commit-rule-delivery.sh",[68,94,119,141,164,176],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"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",[],[75,76,77,78,79,80,81,82,83,84,29,85,86,87,88,89,90,91,92,93],"protocol","Evaluation","tool","tool evaluation protocol","testing","ml","libraries","adoption","methodology","Tools","dependency","up","frameworks","time","project","recommendation","for","bounded","candidate",{"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":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"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",[],[101,102,103,104,75,105,106,107,108,109,29,110,111,112,113,114,115,116,117,118],"systematic debugging","debugging","systematic","test","monitoring","hypothesis","verify","behavior","fix","evidence","bug","reports","pattern","users","error","with","bug-fix","phase",{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":130,"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",[125],{"categoryNo":126,"categoryName":127,"taxonomyType":128,"taxonomyTypeDesc":129},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[131,132,133,134,28,108,135,29,136,113,137,138,139,91,140],"template","skill template","validation","compliance","guide","new skill","structural","canonical","which","Existing",{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":148,"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",[147],{"categoryNo":126,"categoryName":127,"taxonomyType":128,"taxonomyTypeDesc":129},[149,150,151,152,153,154,155,156,157,158,29,159,160,161,162,31,163],"Optimization","skill optimization","components","component","issues","library","audit","refactor","Budget","Rules","periodic","maintenance","token","token budget","high",{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"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",[],[19,171,172,173,174,175,29,30,91],"fallback","silent fallback gate","python","write","edit",{"skillNo":177,"name":178,"nameZh":6,"description":179,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":180,"categories":181,"keywords":183,"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",[182],{"categoryNo":126,"categoryName":127,"taxonomyType":128,"taxonomyTypeDesc":129},[184,185,186,187,152,188,189,190,158,108,29,191,192,89,193,194,195,196,197,198],"framework","retro","retro to framework","change","retrospective","projects","convert","incident","across","problem","about","more","skill update","single","generic"]