[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6JGX2V4VRZ4S9BZ3J92MEAD":3,"skill-same:01M6JGX2V4VRZ4S9BZ3J92MEAD":84},{"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":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":47,"repositoryHtmlUrl":48,"repositoryHomepageUrl":6,"ownerHtmlUrl":49,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":50,"install":51,"resources":64},"01M6JGX2V4VRZ4S9BZ3J92MEAD","skill-template",null,"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.","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\u002Fusage\u002Fskills\u002Fskill-template\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"template","skill template","validation","compliance","hats","behavior","guide","use","new skill","pattern","structural","canonical","which","for","Existing","2026-11-10 10:12:30",false,"---\nname: skill-template\ndescription: >-\n  Canonical template and validation guide for ai-hats skills. Use when\n  creating a new skill, reviewing an existing one for structural\n  compliance, or deciding which pattern fits a new behavior.\nlicense: MIT\n---\n\n# Skill Template\n\nGuide for creating and validating skills in the ai-hats library.\n\n## When to Use\n\n- Creating a new skill\n- Reviewing an existing skill for structural compliance\n- Deciding which pattern fits a new behavior\n\n## Canonical Structure\n\nEvery SKILL.md follows this layout:\n\n```\n# \u003CSkill Name>\n\n\u003COne-line purpose.>\n\n## When to Use\n\u003CBoundaries & disambiguation the one-line description can't carry:\nwhen NOT to use, which sibling skill to prefer, scope edges.\nComplements the description's triggers — does not restate them.>\n\n## \u003CMain Section>\n\u003CCore content. Section name depends on pattern (see below).>\n\n## Completion                ← required for protocol\u002Fchecklist; optional for reference\n\u003CDone-criteria and expected artifacts; include the validation scenario.>\n\n## Anti-Patterns             ← recommended\n\u003CCommon mistakes, 2-5 bullets.>\n```\n\n### `description` vs `## When to Use` — two lifecycle stages\n\nThey are read at different moments, so they carry different content:\n\n- **`description`** is in the always-on skill index (selection-time). It\n  is the *only* thing the selector sees, so it holds the **triggers** —\n  \"what it does. Use when \u003CX>\". It must NOT summarize the procedure body:\n  a step-by-step summary in the index is a shortcut the selector acts on\n  *instead of* loading the skill, so the actual procedure never runs.\n- **`## When to Use`** loads only *after* the skill is invoked\n  (post-load). The \"should I use this\" call is already made by then, so\n  restating triggers adds nothing. Use it for **boundaries &\n  disambiguation**: when NOT to use, which sibling skill to prefer,\n  scope edges — the nuance a one-line description can't hold.\n\n## Patterns\n\nChoose the main section heading by pattern:\n\n| Pattern      | Main Heading | Used When                                 |\n| ------------ | ------------ | ----------------------------------------- |\n| protocol     | Procedure    | Step-by-step process with ordered phases  |\n| checklist    | Checklist    | Verification \u002F audit with pass\u002Ffail items |\n| orchestrator | Workflow     | State machine coordinating other skills   |\n| reference    | Conventions  | Declarative guidelines, no procedure      |\n| template     | Format       | Prescribes a specific output structure    |\n\n## Scripts vs prose\n\nAdd a `scripts\u002F` utility (rather than prose the agent re-generates) when\nthe operation is **deterministic, repeatable, and benefits from explicit\nerror handling**. A committed script saves tokens and is more reliable\nthan code regenerated from a description each time. Keep ad-hoc, one-off,\nor judgment-heavy steps as prose.\n\n**Name the script so the agent can resolve it.** A `hooks\u002F` script is wired by\nthe engine, which knows where it lives; a `scripts\u002F` one is run by the agent,\nwhose cwd is the project root. A bare `scripts\u002F\u003Cname>` therefore reads as the\n*project's* `scripts\u002F` — a directory most repos already have. Say which\ndirectory you mean, in the step that invokes it: `scripts\u002F\u003Cname>` **resolved\nagainst this skill's own directory**. `references\u002F` paths are read, not\nexecuted, and carry no such collision.\n\n## Declaring a hook from a skill\n\nThis is how the ladder's top rung is actually built: a skill's `SKILL.md`\nfrontmatter declares **hooks** under a top-level `ai_hats:` key — `git_hooks`\n(git events), `runtime_hooks` (`PreToolUse` \u002F `PostToolUse`), and `worktree`\n(`wt_in` \u002F `wt_out` lifecycle). The skill directory carries the script:\n\n```yaml\n---\nname: migration-freeze\ndescription: >-\n  PreToolUse hook — refuses edits under `db\u002Fmigrations\u002F` while a release\n  branch is open, and records the attempt. Use when diagnosing why a\n  migration edit was blocked.\nai_hats:\n  runtime_hooks:\n    PreToolUse:\n      - matcher: Bash             # tool name or regex\n        script: hooks\u002Fguard.sh    # path relative to THIS skill's directory\n    PostToolUse:\n      - matcher: Edit|Write|MultiEdit\n        script: hooks\u002Faudit.py\n---\n```\n\nTwo rules that are not guessable:\n\n- **Name the tool in Claude's vocabulary, always** — `Bash`,\n  `Edit|Write|MultiEdit` — even on another surface. Each surface translates at\n  spawn, so enumerating other surfaces' tool names guards nothing extra.\n- **Your script reads ONE dialect**: `tool_name`, `tool_input.command`,\n  `tool_input.file_path`. Do not add a second reading for another surface's\n  payload shape; the adapter has already mapped it.\n\nA shipped example to copy: `usage\u002Fskills\u002Fpy-security-lint\u002F` — frontmatter plus\n`hooks\u002F`. Fuller contract, when you have the ai-hats checkout at hand:\n`docs\u002Fhow-to-extend.md` § \"Declaring hooks from a skill\".\n\n## When your edit takes effect\n\n**No command.** Roles are composed fresh at every session launch, so editing a\n`SKILL.md` body is live for the next session. The same holds for `ai-hats.yaml`\n— it is re-read at launch, so adding your skill to a trait or role also lands on\nits own. `ai-hats self init` validates the config and refreshes the project\nscaffold; it is not how composition changes take effect — with one exception, a\nskill declaring a git hook on an event that has no `.githooks\u002F\u003Cevent>`\ndispatcher yet (`library-editing` §4).\n\nSkills materialize into the per-session cache under\n`\u003Ccache_root>\u002Fsessions\u002F\u003Csid>\u002F` — outside the project, default\n`~\u002F.cache\u002Fai-hats\u002F`; the exact subpath is provider-specific\n(claude `plugin\u002F`, agy `rules\u002F.agents\u002Fskills\u002F`, cline `skills\u002F`).\n\n**Never `cp` skill files by hand** into `.claude\u002Fskills\u002F` or\n`\u003Cai_hats_dir>\u002Flibrary\u002Fskills\u002F`. Neither is a root the resolver reads: the\nfirst is retired, the second is created empty by `ai-hats init` as the landing\nspot for a legacy `.agent\u002Fskills\u002F` and nothing composes from it. A skill\n**you** author lives in `\u003Cproject>\u002Flibraries\u002Fskills\u002F\u003Cname>\u002F` (the other roots:\n`library-editing` §1). A hand-made copy in either place drifts from\nsource-of-truth and never reaches a prompt.\n\nConfirm what a launch would actually compose with `ai-hats config status` or\n`ai-hats --dry-run`.\n\n## Validation scenario (RED → GREEN → REFACTOR)\n\nA skill is not done until one **named baseline scenario** shows it changes\nbehaviour — the same discipline we already apply to code:\n\n- **RED** — name a concrete task where an agent *without* this skill gets it\n  wrong (the failure the skill exists to prevent). If you can't name one, the\n  skill has no demonstrable value — stop and reconsider.\n- **GREEN** — the skill's guidance makes that same task come out right.\n- **REFACTOR** — tighten wording to close rationalization loopholes: an agent\n  should not be able to read the skill and still talk itself out of compliance.\n\nProse-level, not an eval harness: one scenario named in the skill body or its\ntask card — no `evals.json`, no scoring. (Adapted from obra\u002Fsuperpowers\nwriting-skills, MIT.)\n\n## Validation Checklist\n\n- [ ] H1 + one-liner present\n- [ ] **Description includes BOTH capability AND trigger conditions** — it\n      is the *only* thing the skill selector sees. \"What it does. Use when\n      \u003Cspecific triggers>.\"\n- [ ] **Description does NOT summarize the procedure body** — one capability\n      phrase is fine; enumerating the skill's steps\u002Fmethod is not. A body-summary\n      in the always-on index is a shortcut the selector acts on *instead of*\n      loading the skill, so the procedure gets skipped. (CSO discipline adapted\n      from obra\u002Fsuperpowers, MIT.)\n- [ ] **Description is a folded strip scalar** — `description: >-`. A plain\n      or quoted line is the same string in a second spelling, and clip `>`\n      keeps a trailing newline, so the skill index wraps the path. The push\n      to master runs `bash scripts\u002Fgates.sh skill-desc`.\n- [ ] **Validation scenario present** — one named RED baseline (an agent\n      *without* the skill fails) that the skill demonstrably fixes; see\n      \"Validation scenario\" above\n- [ ] `## When to Use` adds boundary\u002Fdisambiguation value beyond the\n      description (when NOT to use, sibling-skill preference, scope edges) —\n      not a restatement of the description's triggers\n- [ ] Main body uses the correct heading for its pattern\n- [ ] `## Completion` present (unless reference\u002Ftemplate pattern)\n- [ ] `## Anti-Patterns` present (unless trivially small)\n- [ ] Frontmatter declares `name` + `description` (single-file SKILL.md — no\n      `metadata.yaml` sidecar; any hooks go under a top-level `ai_hats:` key)\n- [ ] **References one level deep** — `SKILL.md → references\u002F*.md`, never\n      `references\u002F*.md → references\u002Fsub\u002F*.md`. No reference pyramids.\n- [ ] **Length policy:** `≤50` lines ideal · `50–150` warning (justify in\n      the skill or split) · `>150` must split — move content into\n      `references\u002F` or sibling skills. If a skill cleanly divides into two\n      domains, split it.\n- [ ] **Target behavior stated positively** — a prohibition survives only as\n      a hard guardrail on behavior that can't be phrased positively, and then\n      paired with its replacement (\"Redirect instead: …\"). Naming the\n      forbidden move drags it into context and makes it *more* available.\n- [ ] **Every omission is a decision** — read the draft for silences: each\n      thing the component doesn't say is delegated to model priors; fill it,\n      or leave it open deliberately. (Both lenses adapted from\n      mattpocock\u002Fskills `writing-great-skills`, MIT.)\n\n## References\n\nFor detailed guidance on success metrics, testing, and troubleshooting,\nsee `references\u002Fanthropic-skills-guide.md`.\n\nFor external frameworks (skillcreator, Anthropic skill-creator),\nsee `references\u002Fexternal-skill-frameworks.md`.\n\n## Anti-Patterns\n\n- Dumping hundreds of lines into one SKILL.md — split heavy content into `references\u002F`\n- `## When to Use` that merely restates the description — once the skill\n  is loaded the selection decision is already made; give boundaries \u002F\n  disambiguation \u002F when-NOT instead\n- Vague triggers in the `description` that match everything — be specific\n- **`description` that summarizes the procedure body** — enumerating the\n  skill's steps in the always-on index lets the agent act on the summary and\n  skip loading the skill; keep it triggers + one capability phrase\n- Mixing multiple domains in one skill — split into focused skills\n- Omitting completion criteria — the agent won't know when to stop\n- **Shipping a skill with no validation scenario** — if no RED baseline shows\n  an agent failing without it, the skill's value is unproven\n- Prohibition-led wording with no positive replacement — \"never X\" alone\n  half-reads as an instruction to X; state what to do instead\n- Silent defaults — the component omits a decision (location, format, edge\n  case) and every agent fills the gap differently from priors\n","# Skill Template\n\nGuide for creating and validating skills in the ai-hats library.\n\n## When to Use\n\n- Creating a new skill\n- Reviewing an existing skill for structural compliance\n- Deciding which pattern fits a new behavior\n\n## Canonical Structure\n\nEvery SKILL.md follows this layout:\n\n```\n# \u003CSkill Name>\n\n\u003COne-line purpose.>\n\n## When to Use\n\u003CBoundaries & disambiguation the one-line description can't carry:\nwhen NOT to use, which sibling skill to prefer, scope edges.\nComplements the description's triggers — does not restate them.>\n\n## \u003CMain Section>\n\u003CCore content. Section name depends on pattern (see below).>\n\n## Completion                ← required for protocol\u002Fchecklist; optional for reference\n\u003CDone-criteria and expected artifacts; include the validation scenario.>\n\n## Anti-Patterns             ← recommended\n\u003CCommon mistakes, 2-5 bullets.>\n```\n\n### `description` vs `## When to Use` — two lifecycle stages\n\nThey are read at different moments, so they carry different content:\n\n- **`description`** is in the always-on skill index (selection-time). It\n  is the *only* thing the selector sees, so it holds the **triggers** —\n  \"what it does. Use when \u003CX>\". It must NOT summarize the procedure body:\n  a step-by-step summary in the index is a shortcut the selector acts on\n  *instead of* loading the skill, so the actual procedure never runs.\n- **`## When to Use`** loads only *after* the skill is invoked\n  (post-load). The \"should I use this\" call is already made by then, so\n  restating triggers adds nothing. Use it for **boundaries &\n  disambiguation**: when NOT to use, which sibling skill to prefer,\n  scope edges — the nuance a one-line description can't hold.\n\n## Patterns\n\nChoose the main section heading by pattern:\n\n| Pattern      | Main Heading | Used When                                 |\n| ------------ | ------------ | ----------------------------------------- |\n| protocol     | Procedure    | Step-by-step process with ordered phases  |\n| checklist    | Checklist    | Verification \u002F audit with pass\u002Ffail items |\n| orchestrator | Workflow     | State machine coordinating other skills   |\n| reference    | Conventions  | Declarative guidelines, no procedure      |\n| template     | Format       | Prescribes a specific output structure    |\n\n## Scripts vs prose\n\nAdd a `scripts\u002F` utility (rather than prose the agent re-generates) when\nthe operation is **deterministic, repeatable, and benefits from explicit\nerror handling**. A committed script saves tokens and is more reliable\nthan code regenerated from a description each time. Keep ad-hoc, one-off,\nor judgment-heavy steps as prose.\n\n**Name the script so the agent can resolve it.** A `hooks\u002F` script is wired by\nthe engine, which knows where it lives; a `scripts\u002F` one is run by the agent,\nwhose cwd is the project root. A bare `scripts\u002F\u003Cname>` therefore reads as the\n*project's* `scripts\u002F` — a directory most repos already have. Say which\ndirectory you mean, in the step that invokes it: `scripts\u002F\u003Cname>` **resolved\nagainst this skill's own directory**. `references\u002F` paths are read, not\nexecuted, and carry no such collision.\n\n## Declaring a hook from a skill\n\nThis is how the ladder's top rung is actually built: a skill's `SKILL.md`\nfrontmatter declares **hooks** under a top-level `ai_hats:` key — `git_hooks`\n(git events), `runtime_hooks` (`PreToolUse` \u002F `PostToolUse`), and `worktree`\n(`wt_in` \u002F `wt_out` lifecycle). The skill directory carries the script:\n\n```yaml\n---\nname: migration-freeze\ndescription: >-\n  PreToolUse hook — refuses edits under `db\u002Fmigrations\u002F` while a release\n  branch is open, and records the attempt. Use when diagnosing why a\n  migration edit was blocked.\nai_hats:\n  runtime_hooks:\n    PreToolUse:\n      - matcher: Bash             # tool name or regex\n        script: hooks\u002Fguard.sh    # path relative to THIS skill's directory\n    PostToolUse:\n      - matcher: Edit|Write|MultiEdit\n        script: hooks\u002Faudit.py\n---\n```\n\nTwo rules that are not guessable:\n\n- **Name the tool in Claude's vocabulary, always** — `Bash`,\n  `Edit|Write|MultiEdit` — even on another surface. Each surface translates at\n  spawn, so enumerating other surfaces' tool names guards nothing extra.\n- **Your script reads ONE dialect**: `tool_name`, `tool_input.command`,\n  `tool_input.file_path`. Do not add a second reading for another surface's\n  payload shape; the adapter has already mapped it.\n\nA shipped example to copy: `usage\u002Fskills\u002Fpy-security-lint\u002F` — frontmatter plus\n`hooks\u002F`. Fuller contract, when you have the ai-hats checkout at hand:\n`docs\u002Fhow-to-extend.md` § \"Declaring hooks from a skill\".\n\n## When your edit takes effect\n\n**No command.** Roles are composed fresh at every session launch, so editing a\n`SKILL.md` body is live for the next session. The same holds for `ai-hats.yaml`\n— it is re-read at launch, so adding your skill to a trait or role also lands on\nits own. `ai-hats self init` validates the config and refreshes the project\nscaffold; it is not how composition changes take effect — with one exception, a\nskill declaring a git hook on an event that has no `.githooks\u002F\u003Cevent>`\ndispatcher yet (`library-editing` §4).\n\nSkills materialize into the per-session cache under\n`\u003Ccache_root>\u002Fsessions\u002F\u003Csid>\u002F` — outside the project, default\n`~\u002F.cache\u002Fai-hats\u002F`; the exact subpath is provider-specific\n(claude `plugin\u002F`, agy `rules\u002F.agents\u002Fskills\u002F`, cline `skills\u002F`).\n\n**Never `cp` skill files by hand** into `.claude\u002Fskills\u002F` or\n`\u003Cai_hats_dir>\u002Flibrary\u002Fskills\u002F`. Neither is a root the resolver reads: the\nfirst is retired, the second is created empty by `ai-hats init` as the landing\nspot for a legacy `.agent\u002Fskills\u002F` and nothing composes from it. A skill\n**you** author lives in `\u003Cproject>\u002Flibraries\u002Fskills\u002F\u003Cname>\u002F` (the other roots:\n`library-editing` §1). A hand-made copy in either place drifts from\nsource-of-truth and never reaches a prompt.\n\nConfirm what a launch would actually compose with `ai-hats config status` or\n`ai-hats --dry-run`.\n\n## Validation scenario (RED → GREEN → REFACTOR)\n\nA skill is not done until one **named baseline scenario** shows it changes\nbehaviour — the same discipline we already apply to code:\n\n- **RED** — name a concrete task where an agent *without* this skill gets it\n  wrong (the failure the skill exists to prevent). If you can't name one, the\n  skill has no demonstrable value — stop and reconsider.\n- **GREEN** — the skill's guidance makes that same task come out right.\n- **REFACTOR** — tighten wording to close rationalization loopholes: an agent\n  should not be able to read the skill and still talk itself out of compliance.\n\nProse-level, not an eval harness: one scenario named in the skill body or its\ntask card — no `evals.json`, no scoring. (Adapted from obra\u002Fsuperpowers\nwriting-skills, MIT.)\n\n## Validation Checklist\n\n- [ ] H1 + one-liner present\n- [ ] **Description includes BOTH capability AND trigger conditions** — it\n      is the *only* thing the skill selector sees. \"What it does. Use when\n      \u003Cspecific triggers>.\"\n- [ ] **Description does NOT summarize the procedure body** — one capability\n      phrase is fine; enumerating the skill's steps\u002Fmethod is not. A body-summary\n      in the always-on index is a shortcut the selector acts on *instead of*\n      loading the skill, so the procedure gets skipped. (CSO discipline adapted\n      from obra\u002Fsuperpowers, MIT.)\n- [ ] **Description is a folded strip scalar** — `description: >-`. A plain\n      or quoted line is the same string in a second spelling, and clip `>`\n      keeps a trailing newline, so the skill index wraps the path. The push\n      to master runs `bash scripts\u002Fgates.sh skill-desc`.\n- [ ] **Validation scenario present** — one named RED baseline (an agent\n      *without* the skill fails) that the skill demonstrably fixes; see\n      \"Validation scenario\" above\n- [ ] `## When to Use` adds boundary\u002Fdisambiguation value beyond the\n      description (when NOT to use, sibling-skill preference, scope edges) —\n      not a restatement of the description's triggers\n- [ ] Main body uses the correct heading for its pattern\n- [ ] `## Completion` present (unless reference\u002Ftemplate pattern)\n- [ ] `## Anti-Patterns` present (unless trivially small)\n- [ ] Frontmatter declares `name` + `description` (single-file SKILL.md — no\n      `metadata.yaml` sidecar; any hooks go under a top-level `ai_hats:` key)\n- [ ] **References one level deep** — `SKILL.md → references\u002F*.md`, never\n      `references\u002F*.md → references\u002Fsub\u002F*.md`. No reference pyramids.\n- [ ] **Length policy:** `≤50` lines ideal · `50–150` warning (justify in\n      the skill or split) · `>150` must split — move content into\n      `references\u002F` or sibling skills. If a skill cleanly divides into two\n      domains, split it.\n- [ ] **Target behavior stated positively** — a prohibition survives only as\n      a hard guardrail on behavior that can't be phrased positively, and then\n      paired with its replacement (\"Redirect instead: …\"). Naming the\n      forbidden move drags it into context and makes it *more* available.\n- [ ] **Every omission is a decision** — read the draft for silences: each\n      thing the component doesn't say is delegated to model priors; fill it,\n      or leave it open deliberately. (Both lenses adapted from\n      mattpocock\u002Fskills `writing-great-skills`, MIT.)\n\n## References\n\nFor detailed guidance on success metrics, testing, and troubleshooting,\nsee `references\u002Fanthropic-skills-guide.md`.\n\nFor external frameworks (skillcreator, Anthropic skill-creator),\nsee `references\u002Fexternal-skill-frameworks.md`.\n\n## Anti-Patterns\n\n- Dumping hundreds of lines into one SKILL.md — split heavy content into `references\u002F`\n- `## When to Use` that merely restates the description — once the skill\n  is loaded the selection decision is already made; give boundaries \u002F\n  disambiguation \u002F when-NOT instead\n- Vague triggers in the `description` that match everything — be specific\n- **`description` that summarizes the procedure body** — enumerating the\n  skill's steps in the always-on index lets the agent act on the summary and\n  skip loading the skill; keep it triggers + one capability phrase\n- Mixing multiple domains in one skill — split into focused skills\n- Omitting completion criteria — the agent won't know when to stop\n- **Shipping a skill with no validation scenario** — if no RED baseline shows\n  an agent failing without it, the skill's value is unproven\n- Prohibition-led wording with no positive replacement — \"never X\" alone\n  half-reads as an instruction to X; state what to do instead\n- Silent defaults — the component omits a decision (location, format, edge\n  case) and every agent fills the gap differently from priors\n",{"name":5,"license":15,"description":7},"master","b4819add93efbaf4d80627118ec34680406b309b","packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template",1,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats","https:\u002F\u002Fgithub.com\u002Fmuratovv","2026-11-05 20:59:10",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add muratovv\u002Fai-hats --skill skill-template",{"tool":57,"command":58},"bunx","bunx skills add muratovv\u002Fai-hats --skill skill-template",{"tool":60,"command":61},"pnpm","pnpm dlx skills add muratovv\u002Fai-hats --skill skill-template","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template\u002FSKILL.md",true,[65,70,76,80],{"path":66,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"LICENSE","许可证",1070,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template\u002FLICENSE",{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"metadata.yaml","REFERENCE","参考文档",758,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template\u002Fmetadata.yaml",{"path":77,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fanthropic-skills-guide.md",3649,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template\u002Freferences\u002Fanthropic-skills-guide.md",{"path":81,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fexternal-skill-frameworks.md",3762,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fusage\u002Fskills\u002Fskill-template\u002Freferences\u002Fexternal-skill-frameworks.md",[85,110,133,139,163,177],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":39},"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",[],[92,93,94,95,96,97,98,99,100,101,31,102,103,104,105,106,107,37,108,109],"protocol","Evaluation","tool","tool evaluation protocol","testing","ml","libraries","adoption","methodology","Tools","dependency","up","frameworks","time","project","recommendation","bounded","candidate",{"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":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":39},"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",[],[117,118,119,120,92,121,122,123,29,124,31,125,126,127,33,128,129,130,131,132],"systematic debugging","debugging","systematic","test","monitoring","hypothesis","verify","fix","evidence","bug","reports","users","error","with","bug-fix","phase",{"skillNo":134,"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":135,"categories":136,"keywords":138,"publishedAt":39},"01M6PVF3MTQN3RPF73AN34856J","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fskill-template\u002FSKILL.md",[137],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":146,"publishedAt":39},"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",[145],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[147,148,149,150,151,152,153,154,155,156,31,157,158,159,160,161,162],"Optimization","skill optimization","components","component","issues","library","audit","refactor","Budget","Rules","periodic","maintenance","token","token budget","role","high",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":39},"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",[],[170,171,172,173,174,175,31,176,37],"gate","fallback","silent fallback gate","python","write","edit","hook",{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":184,"publishedAt":39},"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",[183],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[185,186,187,188,150,189,190,191,156,29,31,192,193,106,194,195,196,197,198,199],"framework","retro","retro to framework","change","retrospective","projects","convert","incident","across","problem","about","more","skill update","single","generic"]