[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PVAXTPC0GWQV9TAHBZRND7":3,"skill-same:01M6PVAXTPC0GWQV9TAHBZRND7":74},{"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":26,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":47,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":53,"install":54,"resources":67},"01M6PVAXTPC0GWQV9TAHBZRND7","skill-lint-gate",null,"Pre-commit gate over staged library `SKILL.md`. Use when composing a role that carries the `ai-hats-dev` trait, or when diagnosing why the skill-lint 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\u002Fskill-lint-gate\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30,31,32,33,34,35,36,37,38,39],"lint","gate","skill lint gate","commit","dev","library","pre-commit","why","hats","use","hook","role","staged","2026-11-10 10:12:30",false,"---\nname: skill-lint-gate\ndescription: >-\n  Pre-commit gate over staged library `SKILL.md`. Use when composing a\n  role that carries the `ai-hats-dev` trait, or when diagnosing why the\n  skill-lint 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. Over STAGED\n  # `{ai_hats_library,library}\u002F**\u002FSKILL.md` it runs two checks: (1) license\u002Fprovenance\n  # regression-guard (always-on, pure bash, covers golang-*); (2) agnix\n  # spec-lint against the repo-root `.agnix.toml` (excludes golang-*, fail-open\n  # if agnix\u002Fnode absent). Per-commit override AI_HATS_SKILL_LINT_ACK=1.\nlicense: MIT\n---\n\n# Skill Lint Gate\n\nPure-infrastructure hook-carrier skill. It contributes one git pre-commit hook\nthat runs two checks over the SKILL.md files a commit touches and blocks on\neither. There is no agent-side decision logic here — the value is delivered\nentirely through composition.\n\n## What it gates\n\nOver STAGED `{ai_hats_library,library}\u002F**\u002FSKILL.md` (changed-files scope, so the gate never\nretro-blocks the pre-existing backlog), the hook runs, in order. A consumer's\n`libraries\u002F` is out of scope: this skill ships in the `ai-hats-dev` layer, which\nis addressed to the ai-hats repository, not to a consuming project.\n\n1. **License\u002Fprovenance regression-guard** (pure bash, always-on, NOT\n   fail-open). Blocks when a skill has no non-empty `license:` frontmatter, or is\n   declared-derived (sibling `metadata.yaml` has an `upstream:` block) but is\n   missing its co-located `LICENSE` file. Its scope deliberately **includes** the\n   `golang-*` pack — that pack is exactly the third-party derived content this\n   guard protects. It exists to keep the licensing backfill from\n   silently regressing.\n2. **agnix spec-lint** ([agnix](https:\u002F\u002Fgithub.com\u002Favifenesh\u002Fagnix)\n   against the repo-root `.agnix.toml`; target `claude-code`; rules `XML-001` \u002F\n   `XP-SK-001` \u002F `VER-001` disabled as convention false positives). **Excludes**\n   the `golang-*` pack (drift handled separately). Fail-open if\n   agnix\u002Fnode is absent. agnix non-zero exit blocks the commit.\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 CI `lint-skills` job.\n\n## How to bypass\n\nFix the flagged issue, or — after confirming the skill is intentionally\nnon-conforming — ask the supervisor to skip the gate for a single commit:\n`AI_HATS_SKILL_LINT_ACK=1`, exported in the shell that runs the commit. Writing\nit onto your own command line is refused — see **safety-guard**.\n\nIf `agnix` \u002F `node` is not installed, only the **agnix** check is a loud no-op\n(fail-open): it prints a SKIPPED notice and allows the commit, so a missing\noptional dev tool never wedges work. The license\u002Fprovenance guard is pure bash\nand always runs. Inside an ai-hats agent node is present, so both checks are live.\n\n## Overrides\n\n- `AI_HATS_SKILL_LINT_ACK=1` — allow the current commit despite findings.\n- `AI_HATS_SKILL_LINT_CMD` — override the agnix invocation (default\n  `npx --yes agnix@0.29.0`); used by the test suite to inject a stub.\n","# Skill Lint Gate\n\nPure-infrastructure hook-carrier skill. It contributes one git pre-commit hook\nthat runs two checks over the SKILL.md files a commit touches and blocks on\neither. There is no agent-side decision logic here — the value is delivered\nentirely through composition.\n\n## What it gates\n\nOver STAGED `{ai_hats_library,library}\u002F**\u002FSKILL.md` (changed-files scope, so the gate never\nretro-blocks the pre-existing backlog), the hook runs, in order. A consumer's\n`libraries\u002F` is out of scope: this skill ships in the `ai-hats-dev` layer, which\nis addressed to the ai-hats repository, not to a consuming project.\n\n1. **License\u002Fprovenance regression-guard** (pure bash, always-on, NOT\n   fail-open). Blocks when a skill has no non-empty `license:` frontmatter, or is\n   declared-derived (sibling `metadata.yaml` has an `upstream:` block) but is\n   missing its co-located `LICENSE` file. Its scope deliberately **includes** the\n   `golang-*` pack — that pack is exactly the third-party derived content this\n   guard protects. It exists to keep the licensing backfill from\n   silently regressing.\n2. **agnix spec-lint** ([agnix](https:\u002F\u002Fgithub.com\u002Favifenesh\u002Fagnix)\n   against the repo-root `.agnix.toml`; target `claude-code`; rules `XML-001` \u002F\n   `XP-SK-001` \u002F `VER-001` disabled as convention false positives). **Excludes**\n   the `golang-*` pack (drift handled separately). Fail-open if\n   agnix\u002Fnode is absent. agnix non-zero exit blocks the commit.\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 CI `lint-skills` job.\n\n## How to bypass\n\nFix the flagged issue, or — after confirming the skill is intentionally\nnon-conforming — ask the supervisor to skip the gate for a single commit:\n`AI_HATS_SKILL_LINT_ACK=1`, exported in the shell that runs the commit. Writing\nit onto your own command line is refused — see **safety-guard**.\n\nIf `agnix` \u002F `node` is not installed, only the **agnix** check is a loud no-op\n(fail-open): it prints a SKIPPED notice and allows the commit, so a missing\noptional dev tool never wedges work. The license\u002Fprovenance guard is pure bash\nand always runs. Inside an ai-hats agent node is present, so both checks are live.\n\n## Overrides\n\n- `AI_HATS_SKILL_LINT_ACK=1` — allow the current commit despite findings.\n- `AI_HATS_SKILL_LINT_CMD` — override the agnix invocation (default\n  `npx --yes agnix@0.29.0`); used by the test suite to inject a stub.\n",{"name":5,"ai_hats":45,"license":15,"description":7},{"type":46,"schema_version":47},"skill",1,"master","f922a7f627276366873d546942d9ad899a86f71a","packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fskill-lint-gate","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats","https:\u002F\u002Fgithub.com\u002Fmuratovv","2026-11-05 20:59:10",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add muratovv\u002Fai-hats --skill skill-lint-gate",{"tool":60,"command":61},"bunx","bunx skills add muratovv\u002Fai-hats --skill skill-lint-gate",{"tool":63,"command":64},"pnpm","pnpm dlx skills add muratovv\u002Fai-hats --skill skill-lint-gate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fskill-lint-gate\u002FSKILL.md",true,[68],{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"git_hooks\u002Fpre-commit-skill-lint.sh","SCRIPT","脚本",6115,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fskill-lint-gate\u002Fgit_hooks\u002Fpre-commit-skill-lint.sh",[75,101,126,144,166,178],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":40},"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",[],[82,83,84,85,86,87,88,89,90,91,36,92,93,94,95,96,97,98,99,100],"protocol","Evaluation","tool","tool evaluation protocol","testing","ml","libraries","adoption","methodology","Tools","dependency","up","frameworks","time","project","recommendation","for","bounded","candidate",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":40},"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",[],[108,109,110,111,82,112,113,114,115,116,36,117,118,119,120,121,122,123,124,125],"systematic debugging","debugging","systematic","test","monitoring","hypothesis","verify","behavior","fix","evidence","bug","reports","pattern","users","error","with","bug-fix","phase",{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":133,"publishedAt":40},"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",[132],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[134,135,136,137,35,115,138,36,139,120,140,141,142,98,143],"template","skill template","validation","compliance","guide","new skill","structural","canonical","which","Existing",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":151,"publishedAt":40},"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",[150],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[152,153,154,155,156,32,157,158,159,160,36,161,162,163,164,38,165],"Optimization","skill optimization","components","component","issues","audit","refactor","Budget","Rules","periodic","maintenance","token","token budget","high",{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":170,"categories":171,"keywords":172,"publishedAt":40},"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",[],[28,173,174,175,176,177,36,37,98],"fallback","silent fallback gate","python","write","edit",{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":185,"publishedAt":40},"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",[184],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[186,187,188,189,155,190,191,192,160,115,36,193,194,96,195,196,197,198,199,200],"framework","retro","retro to framework","change","retrospective","projects","convert","incident","across","problem","about","more","skill update","single","generic"]