[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BCY39YVMPWRMNGQCTQGAKW":3,"skill-same:01M7BCY39YVMPWRMNGQCTQGAKW":52},{"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":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":51},"01M7BCY39YVMPWRMNGQCTQGAKW","setup",null,"Verify the context-usage plugin on this machine: jq, node, whether its mod runs in this session, this session's snapshot freshness, zones.json, and every option's effective value. Seed or repair ~\u002F.claude\u002Fcontext-usage\u002Fzones.json from the shipped defaults. Use when: 'set up context-usage', 'is context-usage working', a consumer reports zone unknown in a live session, or after a plugin update. Actions: check (read-only; never edits settings), apply (writes ONLY ~\u002F.claude\u002Fcontext-usage\u002Fzones.json, and moves a directory left by the earlier plugin name, on explicit request), apply cache-line (places the prompt-cache status-line segment; prints the statusLine edit).","melodic-software\u002Fclaude-code-plugins","melodic-software","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F58273638?v=4","01M77JVQTXNGKCE4MDFY2BC936","Melodic Software","01M77JVQVN9QDWKAH6W03ANP76",30,"MIT","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcontext-usage\u002Fskills\u002Fsetup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"Verify the context-usage plugin on this machine: jq, node, whether its mod runs in this session, this session's snapshot freshness, zones.json, and every option's effective value. Seed or repair ~\u002F.claude\u002Fcontext-usage\u002Fzones.json from the shipped defaults. Use when: 'set up context-usage', 'is context-usage working', a consumer reports zone unknown in a live session, or after a plugin update. Actions: check (read-only; never edits settings), apply (writes ONLY ~\u002F.claude\u002Fcontext-usage\u002Fzones.json, and moves a directory left by the earlier plugin name, on explicit request), apply cache-line (places the prompt-cache status-line segment; prints the statusLine edit).\"\nargument-hint: \"[check|apply] [defaults|cache-line]\"\nuser-invocable: true\ndisable-model-invocation: true\nallowed-tools:\n  - \"Bash(command -v jq*)\"\n  - \"Bash(command -v node*)\"\nshell: bash\n---\n\n## Pre-computed context\n\nFour of `check`'s read-only probes run at load time. Read the values below; do not re-issue them.\n\n`jq` (a path = present, `absent` = missing): !`command -v jq 2>\u002Fdev\u002Fnull || echo \"absent\"`\n`node` (a path = present, `absent` = missing): !`command -v node 2>\u002Fdev\u002Fnull || echo \"absent\"`\n`zones.json` contents, capped at 40 lines, or one token distinguishing an absent file from an unreadable one: !`if [ -e \"$HOME\u002F.claude\u002Fcontext-usage\u002Fzones.json\" ]; then head -40 \"$HOME\u002F.claude\u002Fcontext-usage\u002Fzones.json\" 2>&1 || echo \"(present but unreadable)\"; else echo \"(absent)\"; fi`\nLeftover directory from the plugin's earlier name (its entries, or `(absent)`): !`if [ -d \"$HOME\u002F.claude\u002Fcontext-guard\" ]; then ls -A \"$HOME\u002F.claude\u002Fcontext-guard\" 2>&1; echo \"compaction markers: $(find \"$HOME\u002F.claude\u002Fcontext-guard\u002Fcontext\" -maxdepth 1 -name '*.compacted' 2>\u002Fdev\u002Fnull | wc -l)\"; else echo \"(absent)\"; fi`\n\n## Purpose\n\nNarrow-write setup. The plugin's module (`hooks\u002Fregister.tsx`, a Claude Code mod) writes each\nsession's snapshot, sends Claude the zone lines, draws the optional band row and\nserves the `mcp__context-usage__status` tool. Nothing about it needs wiring, so `check` inspects\nand reports PASS\u002FFAIL\u002FINFO with one remediation line per FAIL. The plugin also owns the machine file\n`~\u002F.claude\u002Fcontext-usage\u002Fzones.json`, whose schema it defines and whose values the operator may\nedit; that owned writable file is what obliges an `apply`, and a bare `apply` writes nothing else.\n`apply cache-line` places the one other file, the optional status-line segment.\n\nAction routing: no argument or `check` runs the check; `apply cache-line` runs only the cache-line\nsection below; any other `apply` runs the zones.json section.\n\nThe code is the source of truth for its own behavior. Read `${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fregister.tsx`\nand `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh` when a finding depends on what they do, rather\nthan reciting this file. The consumer-facing constants (snapshot path pattern, staleness rule,\ndefault zone bands, zones.json shape) are owned by\n`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Freader-contract.md`. Open plugin files by the `${CLAUDE_PLUGIN_ROOT}`\npaths this skill names, with the `Read` tool; never Glob or Grep the plugin directory.\n\n## `check` (read-only)\n\n1. **`jq`**. Read the pre-computed `jq` value. FAIL when it is `absent`: the bash resolver this\n   check runs for the zone report (`${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh`) then prints `unknown`, and `apply`\n   cannot merge into an existing `zones.json`. The module and the PostCompact marker hook do not\n   use jq. Remediation: install jq (\u003Chttps:\u002F\u002Fjqlang.org\u002Fdownload\u002F>).\n2. **`node`**. Read the pre-computed `node` value. FAIL when it is `absent`: the PostCompact marker\n   row in `${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fhooks.json` runs `node hooks\u002Fexec-bash.mjs`, and the module\n   writes each snapshot by running `node lib\u002Fwrite-snapshot.mjs`, and installing Claude Code does\n   not put `node` on `PATH` for them (pointer below). Without `node` on `PATH` the marker does not\n   launch and no snapshot is written, so file readers read `unknown`; report that the marker cannot\n   launch (how Claude Code treats a hook that cannot start:\n   [Hooks, \"Exit code output\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fhooks#exit-code-output)), since\n   nothing else says so. The module's zone lines, band row and status tool do not\n   need `node`. Remediation: install Node.js (\u003Chttps:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload>) and restart Claude\n   Code.\n   - **Pointer**: [Set up, \"Install with npm\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsetup#install-with-npm),\n     for whether the installed `claude` binary uses Node.\n3. **Module state.** The module loads only where mods can.\n   - **This session**: the module registers `mcp__context-usage__status` when the session starts.\n     Look for that name in your own tool list, deferred tool names included. Present → PASS, the\n     mod is running in this session. Absent → INFO \"mods off in this session, or the status tool\n     was refused by policy\" (a refused registration leaves one debug-log line, \"context-usage: the\n     status tool could not register\").\n   - Run `claude --version`. Older than 2.1.287 → FAIL \"mods off: Claude Code \u003Cversion> is older\n     than the 2.1.287 floor; older builds are unsupported\". Remediation: update Claude Code.\n   - A separate `claude plugin test` process never sees this session's settings (a\n     `disableAllHooks` in this session's settings, `--bare`, worker crashes), so it may only say\n     whether mods can load on this build, read against the troubleshoot table at the pointer\n     below; never report it as this session's state.\n   - Where mods are off, the plugin runs reactive-only there: no zone lines,\n     no band row, no status tool and no snapshot writes; the PostCompact marker, a\n     settings hook, still runs wherever settings hooks do.\n\n   - **Pointer**: [troubleshoot: check whether mods can load](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmods\u002Ftroubleshoot#check-whether-mods-can-load)\n     and [the mod doesn't load](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmods\u002Ftroubleshoot#the-mod-doesn%E2%80%99t-load).\n   - **As of**: 2026-10-03, Claude Code 2.1.288; the doesn't-load anchor 2026-10-11.\n   - **Recheck trigger**: that table changes a message, or the minimum version changes.\n4. **Live-session snapshot freshness**. This session's id is `${CLAUDE_SESSION_ID}`. The module\n   writes after every tool call, so this check's own Bash calls have each given it a chance to\n   write before you read the file. Read\n   `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F${CLAUDE_SESSION_ID}.json` with the `Read` tool:\n   - Exists and `captured_at` is within the reader contract's 10-minute staleness window → PASS\n     (zone-informed consumers get real data). Also report the zone:\n     `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh\" ${CLAUDE_SESSION_ID}`.\n   - Fresh but `used_percentage` or `current_usage` null → INFO: the state before the session's\n     first response or right after `\u002Fcompact`; the resolver correctly answers `unknown`. Not a\n     defect.\n   - Absent or stale while step 3 reported mods off → INFO \"mods off\": no module runs here to\n     write it, and readers take their conservative path. Not a missing instrument and not a\n     wiring defect.\n   - Absent or stale while step 3 found the mod running → FAIL: the module ran but its write did\n     not land. Check step 2 (`node`), then the debug log for \"context-usage: snapshot write failed\"\n     or \"context-usage: snapshot write did not run\", then name the permissions of\n     `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` as the operator's next check; never write or touch a file\n     there to test them.\n   - If the literal string `${CLAUDE_SESSION_ID}` appears unexpanded above, report that this\n     Claude Code version lacks the substitution and consumers will take the conservative path;\n     probe the newest file in `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` instead, labeled as such.\n5. **zones.json state**, a read-only report over the pre-computed `zones.json` value: absent\n   (shipped defaults in effect, percentage 50\u002F75 plus the window-class token bands; valid\n   zero-config state, not a defect), present and valid\n   (report the bands in effect, both shapes), or present with a malformed shape (report per\n   shape: the resolver validates percentage keys and `token_bands` independently and falls back\n   per shape with a stderr notice; a percentage-only file without `token_bands` is valid, with\n   shipped token bands silently in effect; remediation: `apply`). A `(present but unreadable)`\n   token, or a `cat:` error in place of the contents, is the fourth state: the file exists and\n   cannot be read, which is a defect the absent branch would hide. Report the read error and route\n   the operator to the file's permissions, not to `apply`. Also report the module's keys when\n   present (`approach_margin`, `actions`, `thresholds`; the reader contract's \"Zones\"\n   section defines them); an absent or invalid one means its default, never a defect. An old key\n   name (`smart_max_*`, `acceptable_max_*`, or `smart`, `acceptable` or `dumb` under `actions`) is\n   INFO: read as its new name for one release; remediation `apply`, which renames it. The module\n   resolves zones with the same bands from the live session, so a machine with no snapshot files\n   still gets lines.\n6. **Cache-line copy** (INFO only). When `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs` exists, compare\n   it byte for byte with `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs`: identical → INFO current;\n   different → INFO stale, remediation `apply cache-line`. Absent → INFO not installed, which is\n   the default and never a defect.\n7. **Option posture**. Report every option, each as its own row with the value substituted below\n   and what that value does. Never collapse them into one \"active\" status: a plugin that is\n   enabled while its kill switch is off, or whose lines are off, is the exact state an operator is\n   diagnosing when lines are missing.\n\n   | Option | Value | What it does |\n   |---|---|---|\n   | `context_usage_hooks_enabled` | `${user_config.context_usage_hooks_enabled}` | `false` → **INERT**: the module sends no lines and shows no toast or crossing notice, and the PostCompact marker hook exits at once. Snapshot writes, the band row and the status tool continue. |\n   | `model_notices` | `${user_config.model_notices}` | `false` (the default) → no lines to Claude and no operator-mode suggestions; the toast, band and writes continue. `true` sends the zone lines. |\n   | `zone_report_mode` | `${user_config.zone_report_mode}` | `automatic` sends the lines to Claude; `operator` holds them in a turn a person typed and offers them as a prompt suggestion plus a notice row. |\n   | `zone_line_data` | `${user_config.zone_line_data}` | The figures a line carries beside its zone (`percent`, `tokens`, `window`); `zone` alone means none. |\n   | `context_usage_band` | `${user_config.context_usage_band}` | `false` (the default) leaves the band row off; `true` draws it. `\u002Fcontext-usage band on` or `band off` sets it for one session. |\n   | `context_usage_toast` | `${user_config.context_usage_toast}` | `true` shows a toast at each zone crossing; `false` leaves only the transcript line. |\n\n   - Any value still showing its literal `${user_config.\u003Cname>}` token (unset key, or a Claude\n     Code without the substitution) → **UNKNOWN** for that row, never the default stated as fact.\n     Say which source was read: the module gets every option with the `${CLAUDE_PLUGIN_ROOT}\u002F.claude-plugin\u002Fplugin.json` default filled\n     in, and the PostCompact marker hook applies its own in-script default (on). The\n     operator-inspectable source of truth is this plugin's `pluginConfigs` options block in the\n     user `settings.json` (the hook-config-delivery convention,\n     \u003Chttps:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fdocs\u002Fcontracts\u002Fhook-config-delivery\u002FREADME.md>,\n     owns why the declared `default` field is not delivered to hook processes).\n   - A `zone_line_data` item outside the four words reads as that option's default, and the module\n     logs one transcript line naming it at session start. Report the value as invalid and the\n     default as what runs.\n   - A `pluginConfigs` key the plugin no longer declares (`zone_lines_enabled`, which\n     `model_notices` replaced; `zone_hook_mode`, `zone_gate_grace_calls`, `zone_block_unattended`),\n     or a `block` action in `zones.json` (which reads as `none`), gates nothing. Report it as INFO, safe to remove.\n   - Every option acts only where step 3 found the mod running, except\n     that the kill switch also turns off the PostCompact marker hook, a settings hook that can run\n     where mods are off.\n   - The module reads its options when it loads, and Claude Code reloads a module when its options\n     change, so a changed value acts from the next event. The marker hook reads its value at session\n     start.\n8. **Directory left by the earlier name** (migration). Read the pre-computed leftover value.\n   `(absent)` → PASS. Otherwise FAIL \"drift: `~\u002F.claude\u002Fcontext-guard\u002F` is left from the plugin's\n   earlier name\", list its entries and its compaction-marker count (each marker records a\n   session compacted before the rename; the module still reads them there until they move), and say\n   whether the user `settings.json` `statusLine` command names that directory. When it holds\n   `zones.json` and `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` is absent, add the drift line \"zones.json\n   still in the earlier directory\": the module and the resolver read the operator's bands from there\n   until `apply` moves them. Remediation: `apply`, which moves it (see \"Earlier-name directory\" below).\n   A session still running the plugin under its earlier name recreates `context\u002F` there until it\n   ends.\n\n## `apply` (writes only `~\u002F.claude\u002Fcontext-usage\u002F`, on explicit request)\n\n### Earlier-name directory (migration)\n\nRuns first, on every `apply` form, when `~\u002F.claude\u002Fcontext-guard\u002F` exists:\n\n1. `zones.json`: when `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` is absent, move the old file there\n   unchanged (create the directory with mode 700). When both exist and differ, keep both, report\n   the two band sets, and stop this section: the operator chooses which to keep.\n2. `cache-line.mjs`: when the old directory holds one, copy\n   `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs` to `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`.\n   When the `statusLine` in effect (found as in `apply cache-line` step 2) names the old path,\n   print the same `statusLine` with that path replaced by `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`\n   for the operator to paste; never write it.\n3. Compaction markers: move each `context\u002F\u003Csession_id>.compacted` to\n   `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` (create it with mode 700), never over a marker already there.\n   A marker is written only at a compaction, so a resumed session that lost it would read as never\n   compacted.\n4. Remove `~\u002F.claude\u002Fcontext-guard\u002F` (its snapshots are per-session state the module writes\n   afresh) unless step 1 stopped, a marker could not move, the `statusLine` still names it, or a\n   file in its `context\u002F` changed within the reader contract's 10-minute staleness window (a\n   session still running the plugin under its earlier name; a later `apply` finishes it). Report\n   what moved, what was copied and what was removed.\n\n### Zone bands\n\nSeed or refresh `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` from the shipped defaults\n(`light_max_used_percentage: 50`, `moderate_max_used_percentage: 75`, and the window-class\n`token_bands`, the reader contract owns these numbers; read them from\n`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Freader-contract.md` rather than this file if they ever disagree).\nThe `defaults` argument changes only how a present file is treated:\n\n1. **File absent**. Create the directory if needed and write exactly:\n\n   ```json\n   {\n     \"light_max_used_percentage\": 50,\n     \"moderate_max_used_percentage\": 75,\n     \"token_bands\": {\n       \"200000\": { \"light_max_tokens\": 100000, \"moderate_max_tokens\": 150000 },\n       \"1000000\": { \"light_max_tokens\": 128000, \"moderate_max_tokens\": 500000 }\n     }\n   }\n   ```\n\n2. **File present**. Behavior is mode-explicit, never ambiguous:\n   - `apply` (no argument): repair-only. Valid recognized band values are left untouched and\n     reported; recognized keys that are missing or invalid (non-numeric, inverted, out of range; for `token_bands`, invalid per the reader contract's per-shape validity rules) are set to the\n     shipped defaults. An absent `token_bands` is repaired by adding the shipped token bands\n     (absence is valid zero-config for the resolver, but the seeded SSOT should carry the full\n     tunable surface). An operator's custom-but-valid thresholds are never overwritten by a\n     bare `apply`.\n   - `apply defaults`: set all recognized band keys (both percentage keys and `token_bands`) to\n     the shipped defaults explicitly. This converges forward to a known state; it is not teardown,\n     and it never removes the file or any key it does not recognize.\n   - Both modes rename the old key names first, keeping their values: `smart_max_used_percentage`\n     → `light_max_used_percentage`, `acceptable_max_used_percentage` →\n     `moderate_max_used_percentage`, and in each `token_bands` row `smart_max_tokens` →\n     `light_max_tokens` and `acceptable_max_tokens` → `moderate_max_tokens`; under `actions`,\n     `smart` → `light`, `acceptable` → `moderate` and `dumb` → `heavy`. Where both names are set,\n     keep the new one and drop the old. Report each rename.\n   - Both modes **preserve every unrecognized key semantically**: same keys, same JSON values\n     (the file is a shared SSOT the operator's own tools may extend). The module's own keys\n     (`approach_margin`, `actions`, `thresholds`) are kept the same way. Preservation is\n     value-level, not lexical: a `jq` merge reserializes the document, so formatting and escape\n     spellings may normalize (`\"blue\"` → `\"blue\"`); consumers of this file must parse it as\n     JSON, never depend on its raw bytes. Use `jq` to merge so the result stays valid JSON. If\n     `jq` is absent while the file exists, FAIL with the jq install remediation\n     (\u003Chttps:\u002F\u002Fjqlang.org\u002Fdownload\u002F>) instead of attempting a merge, never risk clobbering the\n     operator's keys with a jq-less rewrite. (Step 1's template write needs no jq.)\n3. **Idempotent**, a second identical `apply` produces no content change; say so.\n4. **Report exactly what was written** (old bands → new bands, unrecognized keys preserved), and\n   remind that consumers re-read the file on their next zone decision. No restart needed.\n\n`apply` never touches `settings.json`, the snapshot directory (beyond the earlier-name\nmigration's marker move), or anything in `~\u002F.claude\u002Fcontext-usage\u002F` other than `zones.json` and\nthe earlier-name migration above.\n\n## `apply cache-line` (writes only `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, on explicit request)\n\nPlaces the optional prompt-cache status-line segment at a fixed path this plugin owns, so the\noperator's status line never depends on where the installed plugin's files live. Pointer: for\nwhere those files live, see\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmanifest-reference#where-each-variable-resolves>.\n\n1. **Copy** `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs` to\n   `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, creating the directory if needed. When the target is\n   already byte-identical, write nothing and say so.\n2. **Find the `statusLine` in effect.** Read (read-only) every settings file that can set it and\n   take the one that wins by Claude Code's settings precedence; name that file to the operator. When\n   the winner is managed settings, stop: the operator cannot change it, so report that and print no\n   edit. When no file sets it, the target is the user `settings.json`. Pointer: for the precedence\n   order and the scopes a status line can live in, see\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsettings#settings-precedence> and\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fstatusline#manually-configure-a-status-line>.\n3. **Print the statusLine edit; never write it, and never compose it by hand.** Pipe that file\n   (`{}` when it is absent) into `node \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs\" --wire` and\n   print its output as the paste-ready `statusLine` object for that same file. With an existing\n   `command` it wraps that command as one quoted argument to `--after`, which runs it on the same\n   input before the segment, and keeps every other `statusLine` key; with none it prints the bare\n   segment. Relay its stderr note when it says the line is already wired, and show the exact\n   current `command` it wrapped. On native Windows without Git Bash, say the wrapper's quoting is\n   POSIX and stop rather than print an edit that would break the existing line.\n\n   Then point the operator at this plugin README's \"Prompt-cache status-line segment\" section for\n   what the segment needs and covers, rather than restating it here.\n4. **After a plugin update**, re-running `apply cache-line` refreshes the copy; step 6 of `check`\n   reports a stale one.\n\n## Uninstalling\n\nOnce the plugin is uninstalled the module stops and nothing writes new snapshots (what an uninstall\nremoves:\n[Plugins CLI reference, \"What an uninstall deletes and keeps\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fcli-reference#what-an-uninstall-deletes-and-keeps)).\nThe operator's directory `~\u002F.claude\u002Fcontext-usage\u002F` (`zones.json`, the snapshots, the\ncompaction markers and, after `apply cache-line`, `cache-line.mjs`) stays. Removing it is safe once\nthe operator's `statusLine` no longer runs `cache-line.mjs`: restore the command `--after` wrapped,\nor drop the bare segment, first. Readers then read `unknown` and take their conservative path.\n\n## What this skill does not do\n\n- Write the plugin cache, Claude Code user settings, or `pluginConfigs`, per the uniform setup\n  contract (`docs\u002Fplugin-philosophy.md` \"Setup is explicit and repeatable\" in the marketplace\n  repository). Nor `settings.json` (user or project), the operator's status line command, or any\n  other Claude Code settings file; `apply cache-line` prints the statusLine edit for the operator\n  to paste.\n- Install `jq`, `node` or any system package.\n- Write to the snapshot directory `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F`, except moving `.compacted`\n  markers there in the earlier-name migration; the module owns those files.\n- Write anywhere outside `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` and, on `apply cache-line` or the\n  earlier-name migration only, `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, including the sibling\n  `rate-limits` directory. The migration's one removal is the earlier-name directory.\n","## Pre-computed context\n\nFour of `check`'s read-only probes run at load time. Read the values below; do not re-issue them.\n\n`jq` (a path = present, `absent` = missing): !`command -v jq 2>\u002Fdev\u002Fnull || echo \"absent\"`\n`node` (a path = present, `absent` = missing): !`command -v node 2>\u002Fdev\u002Fnull || echo \"absent\"`\n`zones.json` contents, capped at 40 lines, or one token distinguishing an absent file from an unreadable one: !`if [ -e \"$HOME\u002F.claude\u002Fcontext-usage\u002Fzones.json\" ]; then head -40 \"$HOME\u002F.claude\u002Fcontext-usage\u002Fzones.json\" 2>&1 || echo \"(present but unreadable)\"; else echo \"(absent)\"; fi`\nLeftover directory from the plugin's earlier name (its entries, or `(absent)`): !`if [ -d \"$HOME\u002F.claude\u002Fcontext-guard\" ]; then ls -A \"$HOME\u002F.claude\u002Fcontext-guard\" 2>&1; echo \"compaction markers: $(find \"$HOME\u002F.claude\u002Fcontext-guard\u002Fcontext\" -maxdepth 1 -name '*.compacted' 2>\u002Fdev\u002Fnull | wc -l)\"; else echo \"(absent)\"; fi`\n\n## Purpose\n\nNarrow-write setup. The plugin's module (`hooks\u002Fregister.tsx`, a Claude Code mod) writes each\nsession's snapshot, sends Claude the zone lines, draws the optional band row and\nserves the `mcp__context-usage__status` tool. Nothing about it needs wiring, so `check` inspects\nand reports PASS\u002FFAIL\u002FINFO with one remediation line per FAIL. The plugin also owns the machine file\n`~\u002F.claude\u002Fcontext-usage\u002Fzones.json`, whose schema it defines and whose values the operator may\nedit; that owned writable file is what obliges an `apply`, and a bare `apply` writes nothing else.\n`apply cache-line` places the one other file, the optional status-line segment.\n\nAction routing: no argument or `check` runs the check; `apply cache-line` runs only the cache-line\nsection below; any other `apply` runs the zones.json section.\n\nThe code is the source of truth for its own behavior. Read `${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fregister.tsx`\nand `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh` when a finding depends on what they do, rather\nthan reciting this file. The consumer-facing constants (snapshot path pattern, staleness rule,\ndefault zone bands, zones.json shape) are owned by\n`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Freader-contract.md`. Open plugin files by the `${CLAUDE_PLUGIN_ROOT}`\npaths this skill names, with the `Read` tool; never Glob or Grep the plugin directory.\n\n## `check` (read-only)\n\n1. **`jq`**. Read the pre-computed `jq` value. FAIL when it is `absent`: the bash resolver this\n   check runs for the zone report (`${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh`) then prints `unknown`, and `apply`\n   cannot merge into an existing `zones.json`. The module and the PostCompact marker hook do not\n   use jq. Remediation: install jq (\u003Chttps:\u002F\u002Fjqlang.org\u002Fdownload\u002F>).\n2. **`node`**. Read the pre-computed `node` value. FAIL when it is `absent`: the PostCompact marker\n   row in `${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fhooks.json` runs `node hooks\u002Fexec-bash.mjs`, and the module\n   writes each snapshot by running `node lib\u002Fwrite-snapshot.mjs`, and installing Claude Code does\n   not put `node` on `PATH` for them (pointer below). Without `node` on `PATH` the marker does not\n   launch and no snapshot is written, so file readers read `unknown`; report that the marker cannot\n   launch (how Claude Code treats a hook that cannot start:\n   [Hooks, \"Exit code output\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fhooks#exit-code-output)), since\n   nothing else says so. The module's zone lines, band row and status tool do not\n   need `node`. Remediation: install Node.js (\u003Chttps:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload>) and restart Claude\n   Code.\n   - **Pointer**: [Set up, \"Install with npm\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsetup#install-with-npm),\n     for whether the installed `claude` binary uses Node.\n3. **Module state.** The module loads only where mods can.\n   - **This session**: the module registers `mcp__context-usage__status` when the session starts.\n     Look for that name in your own tool list, deferred tool names included. Present → PASS, the\n     mod is running in this session. Absent → INFO \"mods off in this session, or the status tool\n     was refused by policy\" (a refused registration leaves one debug-log line, \"context-usage: the\n     status tool could not register\").\n   - Run `claude --version`. Older than 2.1.287 → FAIL \"mods off: Claude Code \u003Cversion> is older\n     than the 2.1.287 floor; older builds are unsupported\". Remediation: update Claude Code.\n   - A separate `claude plugin test` process never sees this session's settings (a\n     `disableAllHooks` in this session's settings, `--bare`, worker crashes), so it may only say\n     whether mods can load on this build, read against the troubleshoot table at the pointer\n     below; never report it as this session's state.\n   - Where mods are off, the plugin runs reactive-only there: no zone lines,\n     no band row, no status tool and no snapshot writes; the PostCompact marker, a\n     settings hook, still runs wherever settings hooks do.\n\n   - **Pointer**: [troubleshoot: check whether mods can load](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmods\u002Ftroubleshoot#check-whether-mods-can-load)\n     and [the mod doesn't load](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmods\u002Ftroubleshoot#the-mod-doesn%E2%80%99t-load).\n   - **As of**: 2026-10-03, Claude Code 2.1.288; the doesn't-load anchor 2026-10-11.\n   - **Recheck trigger**: that table changes a message, or the minimum version changes.\n4. **Live-session snapshot freshness**. This session's id is `${CLAUDE_SESSION_ID}`. The module\n   writes after every tool call, so this check's own Bash calls have each given it a chance to\n   write before you read the file. Read\n   `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F${CLAUDE_SESSION_ID}.json` with the `Read` tool:\n   - Exists and `captured_at` is within the reader contract's 10-minute staleness window → PASS\n     (zone-informed consumers get real data). Also report the zone:\n     `bash \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcontext-zone.sh\" ${CLAUDE_SESSION_ID}`.\n   - Fresh but `used_percentage` or `current_usage` null → INFO: the state before the session's\n     first response or right after `\u002Fcompact`; the resolver correctly answers `unknown`. Not a\n     defect.\n   - Absent or stale while step 3 reported mods off → INFO \"mods off\": no module runs here to\n     write it, and readers take their conservative path. Not a missing instrument and not a\n     wiring defect.\n   - Absent or stale while step 3 found the mod running → FAIL: the module ran but its write did\n     not land. Check step 2 (`node`), then the debug log for \"context-usage: snapshot write failed\"\n     or \"context-usage: snapshot write did not run\", then name the permissions of\n     `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` as the operator's next check; never write or touch a file\n     there to test them.\n   - If the literal string `${CLAUDE_SESSION_ID}` appears unexpanded above, report that this\n     Claude Code version lacks the substitution and consumers will take the conservative path;\n     probe the newest file in `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` instead, labeled as such.\n5. **zones.json state**, a read-only report over the pre-computed `zones.json` value: absent\n   (shipped defaults in effect, percentage 50\u002F75 plus the window-class token bands; valid\n   zero-config state, not a defect), present and valid\n   (report the bands in effect, both shapes), or present with a malformed shape (report per\n   shape: the resolver validates percentage keys and `token_bands` independently and falls back\n   per shape with a stderr notice; a percentage-only file without `token_bands` is valid, with\n   shipped token bands silently in effect; remediation: `apply`). A `(present but unreadable)`\n   token, or a `cat:` error in place of the contents, is the fourth state: the file exists and\n   cannot be read, which is a defect the absent branch would hide. Report the read error and route\n   the operator to the file's permissions, not to `apply`. Also report the module's keys when\n   present (`approach_margin`, `actions`, `thresholds`; the reader contract's \"Zones\"\n   section defines them); an absent or invalid one means its default, never a defect. An old key\n   name (`smart_max_*`, `acceptable_max_*`, or `smart`, `acceptable` or `dumb` under `actions`) is\n   INFO: read as its new name for one release; remediation `apply`, which renames it. The module\n   resolves zones with the same bands from the live session, so a machine with no snapshot files\n   still gets lines.\n6. **Cache-line copy** (INFO only). When `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs` exists, compare\n   it byte for byte with `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs`: identical → INFO current;\n   different → INFO stale, remediation `apply cache-line`. Absent → INFO not installed, which is\n   the default and never a defect.\n7. **Option posture**. Report every option, each as its own row with the value substituted below\n   and what that value does. Never collapse them into one \"active\" status: a plugin that is\n   enabled while its kill switch is off, or whose lines are off, is the exact state an operator is\n   diagnosing when lines are missing.\n\n   | Option | Value | What it does |\n   |---|---|---|\n   | `context_usage_hooks_enabled` | `${user_config.context_usage_hooks_enabled}` | `false` → **INERT**: the module sends no lines and shows no toast or crossing notice, and the PostCompact marker hook exits at once. Snapshot writes, the band row and the status tool continue. |\n   | `model_notices` | `${user_config.model_notices}` | `false` (the default) → no lines to Claude and no operator-mode suggestions; the toast, band and writes continue. `true` sends the zone lines. |\n   | `zone_report_mode` | `${user_config.zone_report_mode}` | `automatic` sends the lines to Claude; `operator` holds them in a turn a person typed and offers them as a prompt suggestion plus a notice row. |\n   | `zone_line_data` | `${user_config.zone_line_data}` | The figures a line carries beside its zone (`percent`, `tokens`, `window`); `zone` alone means none. |\n   | `context_usage_band` | `${user_config.context_usage_band}` | `false` (the default) leaves the band row off; `true` draws it. `\u002Fcontext-usage band on` or `band off` sets it for one session. |\n   | `context_usage_toast` | `${user_config.context_usage_toast}` | `true` shows a toast at each zone crossing; `false` leaves only the transcript line. |\n\n   - Any value still showing its literal `${user_config.\u003Cname>}` token (unset key, or a Claude\n     Code without the substitution) → **UNKNOWN** for that row, never the default stated as fact.\n     Say which source was read: the module gets every option with the `${CLAUDE_PLUGIN_ROOT}\u002F.claude-plugin\u002Fplugin.json` default filled\n     in, and the PostCompact marker hook applies its own in-script default (on). The\n     operator-inspectable source of truth is this plugin's `pluginConfigs` options block in the\n     user `settings.json` (the hook-config-delivery convention,\n     \u003Chttps:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fdocs\u002Fcontracts\u002Fhook-config-delivery\u002FREADME.md>,\n     owns why the declared `default` field is not delivered to hook processes).\n   - A `zone_line_data` item outside the four words reads as that option's default, and the module\n     logs one transcript line naming it at session start. Report the value as invalid and the\n     default as what runs.\n   - A `pluginConfigs` key the plugin no longer declares (`zone_lines_enabled`, which\n     `model_notices` replaced; `zone_hook_mode`, `zone_gate_grace_calls`, `zone_block_unattended`),\n     or a `block` action in `zones.json` (which reads as `none`), gates nothing. Report it as INFO, safe to remove.\n   - Every option acts only where step 3 found the mod running, except\n     that the kill switch also turns off the PostCompact marker hook, a settings hook that can run\n     where mods are off.\n   - The module reads its options when it loads, and Claude Code reloads a module when its options\n     change, so a changed value acts from the next event. The marker hook reads its value at session\n     start.\n8. **Directory left by the earlier name** (migration). Read the pre-computed leftover value.\n   `(absent)` → PASS. Otherwise FAIL \"drift: `~\u002F.claude\u002Fcontext-guard\u002F` is left from the plugin's\n   earlier name\", list its entries and its compaction-marker count (each marker records a\n   session compacted before the rename; the module still reads them there until they move), and say\n   whether the user `settings.json` `statusLine` command names that directory. When it holds\n   `zones.json` and `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` is absent, add the drift line \"zones.json\n   still in the earlier directory\": the module and the resolver read the operator's bands from there\n   until `apply` moves them. Remediation: `apply`, which moves it (see \"Earlier-name directory\" below).\n   A session still running the plugin under its earlier name recreates `context\u002F` there until it\n   ends.\n\n## `apply` (writes only `~\u002F.claude\u002Fcontext-usage\u002F`, on explicit request)\n\n### Earlier-name directory (migration)\n\nRuns first, on every `apply` form, when `~\u002F.claude\u002Fcontext-guard\u002F` exists:\n\n1. `zones.json`: when `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` is absent, move the old file there\n   unchanged (create the directory with mode 700). When both exist and differ, keep both, report\n   the two band sets, and stop this section: the operator chooses which to keep.\n2. `cache-line.mjs`: when the old directory holds one, copy\n   `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs` to `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`.\n   When the `statusLine` in effect (found as in `apply cache-line` step 2) names the old path,\n   print the same `statusLine` with that path replaced by `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`\n   for the operator to paste; never write it.\n3. Compaction markers: move each `context\u002F\u003Csession_id>.compacted` to\n   `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F` (create it with mode 700), never over a marker already there.\n   A marker is written only at a compaction, so a resumed session that lost it would read as never\n   compacted.\n4. Remove `~\u002F.claude\u002Fcontext-guard\u002F` (its snapshots are per-session state the module writes\n   afresh) unless step 1 stopped, a marker could not move, the `statusLine` still names it, or a\n   file in its `context\u002F` changed within the reader contract's 10-minute staleness window (a\n   session still running the plugin under its earlier name; a later `apply` finishes it). Report\n   what moved, what was copied and what was removed.\n\n### Zone bands\n\nSeed or refresh `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` from the shipped defaults\n(`light_max_used_percentage: 50`, `moderate_max_used_percentage: 75`, and the window-class\n`token_bands`, the reader contract owns these numbers; read them from\n`${CLAUDE_PLUGIN_ROOT}\u002Freference\u002Freader-contract.md` rather than this file if they ever disagree).\nThe `defaults` argument changes only how a present file is treated:\n\n1. **File absent**. Create the directory if needed and write exactly:\n\n   ```json\n   {\n     \"light_max_used_percentage\": 50,\n     \"moderate_max_used_percentage\": 75,\n     \"token_bands\": {\n       \"200000\": { \"light_max_tokens\": 100000, \"moderate_max_tokens\": 150000 },\n       \"1000000\": { \"light_max_tokens\": 128000, \"moderate_max_tokens\": 500000 }\n     }\n   }\n   ```\n\n2. **File present**. Behavior is mode-explicit, never ambiguous:\n   - `apply` (no argument): repair-only. Valid recognized band values are left untouched and\n     reported; recognized keys that are missing or invalid (non-numeric, inverted, out of range; for `token_bands`, invalid per the reader contract's per-shape validity rules) are set to the\n     shipped defaults. An absent `token_bands` is repaired by adding the shipped token bands\n     (absence is valid zero-config for the resolver, but the seeded SSOT should carry the full\n     tunable surface). An operator's custom-but-valid thresholds are never overwritten by a\n     bare `apply`.\n   - `apply defaults`: set all recognized band keys (both percentage keys and `token_bands`) to\n     the shipped defaults explicitly. This converges forward to a known state; it is not teardown,\n     and it never removes the file or any key it does not recognize.\n   - Both modes rename the old key names first, keeping their values: `smart_max_used_percentage`\n     → `light_max_used_percentage`, `acceptable_max_used_percentage` →\n     `moderate_max_used_percentage`, and in each `token_bands` row `smart_max_tokens` →\n     `light_max_tokens` and `acceptable_max_tokens` → `moderate_max_tokens`; under `actions`,\n     `smart` → `light`, `acceptable` → `moderate` and `dumb` → `heavy`. Where both names are set,\n     keep the new one and drop the old. Report each rename.\n   - Both modes **preserve every unrecognized key semantically**: same keys, same JSON values\n     (the file is a shared SSOT the operator's own tools may extend). The module's own keys\n     (`approach_margin`, `actions`, `thresholds`) are kept the same way. Preservation is\n     value-level, not lexical: a `jq` merge reserializes the document, so formatting and escape\n     spellings may normalize (`\"blue\"` → `\"blue\"`); consumers of this file must parse it as\n     JSON, never depend on its raw bytes. Use `jq` to merge so the result stays valid JSON. If\n     `jq` is absent while the file exists, FAIL with the jq install remediation\n     (\u003Chttps:\u002F\u002Fjqlang.org\u002Fdownload\u002F>) instead of attempting a merge, never risk clobbering the\n     operator's keys with a jq-less rewrite. (Step 1's template write needs no jq.)\n3. **Idempotent**, a second identical `apply` produces no content change; say so.\n4. **Report exactly what was written** (old bands → new bands, unrecognized keys preserved), and\n   remind that consumers re-read the file on their next zone decision. No restart needed.\n\n`apply` never touches `settings.json`, the snapshot directory (beyond the earlier-name\nmigration's marker move), or anything in `~\u002F.claude\u002Fcontext-usage\u002F` other than `zones.json` and\nthe earlier-name migration above.\n\n## `apply cache-line` (writes only `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, on explicit request)\n\nPlaces the optional prompt-cache status-line segment at a fixed path this plugin owns, so the\noperator's status line never depends on where the installed plugin's files live. Pointer: for\nwhere those files live, see\n\u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fmanifest-reference#where-each-variable-resolves>.\n\n1. **Copy** `${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs` to\n   `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, creating the directory if needed. When the target is\n   already byte-identical, write nothing and say so.\n2. **Find the `statusLine` in effect.** Read (read-only) every settings file that can set it and\n   take the one that wins by Claude Code's settings precedence; name that file to the operator. When\n   the winner is managed settings, stop: the operator cannot change it, so report that and print no\n   edit. When no file sets it, the target is the user `settings.json`. Pointer: for the precedence\n   order and the scopes a status line can live in, see\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsettings#settings-precedence> and\n   \u003Chttps:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fstatusline#manually-configure-a-status-line>.\n3. **Print the statusLine edit; never write it, and never compose it by hand.** Pipe that file\n   (`{}` when it is absent) into `node \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fcache-line.mjs\" --wire` and\n   print its output as the paste-ready `statusLine` object for that same file. With an existing\n   `command` it wraps that command as one quoted argument to `--after`, which runs it on the same\n   input before the segment, and keeps every other `statusLine` key; with none it prints the bare\n   segment. Relay its stderr note when it says the line is already wired, and show the exact\n   current `command` it wrapped. On native Windows without Git Bash, say the wrapper's quoting is\n   POSIX and stop rather than print an edit that would break the existing line.\n\n   Then point the operator at this plugin README's \"Prompt-cache status-line segment\" section for\n   what the segment needs and covers, rather than restating it here.\n4. **After a plugin update**, re-running `apply cache-line` refreshes the copy; step 6 of `check`\n   reports a stale one.\n\n## Uninstalling\n\nOnce the plugin is uninstalled the module stops and nothing writes new snapshots (what an uninstall\nremoves:\n[Plugins CLI reference, \"What an uninstall deletes and keeps\"](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fplugins\u002Fcli-reference#what-an-uninstall-deletes-and-keeps)).\nThe operator's directory `~\u002F.claude\u002Fcontext-usage\u002F` (`zones.json`, the snapshots, the\ncompaction markers and, after `apply cache-line`, `cache-line.mjs`) stays. Removing it is safe once\nthe operator's `statusLine` no longer runs `cache-line.mjs`: restore the command `--after` wrapped,\nor drop the bare segment, first. Readers then read `unknown` and take their conservative path.\n\n## What this skill does not do\n\n- Write the plugin cache, Claude Code user settings, or `pluginConfigs`, per the uniform setup\n  contract (`docs\u002Fplugin-philosophy.md` \"Setup is explicit and repeatable\" in the marketplace\n  repository). Nor `settings.json` (user or project), the operator's status line command, or any\n  other Claude Code settings file; `apply cache-line` prints the statusLine edit for the operator\n  to paste.\n- Install `jq`, `node` or any system package.\n- Write to the snapshot directory `~\u002F.claude\u002Fcontext-usage\u002Fcontext\u002F`, except moving `.compacted`\n  markers there in the earlier-name migration; the module owns those files.\n- Write anywhere outside `~\u002F.claude\u002Fcontext-usage\u002Fzones.json` and, on `apply cache-line` or the\n  earlier-name migration only, `~\u002F.claude\u002Fcontext-usage\u002Fcache-line.mjs`, including the sibling\n  `rate-limits` directory. The migration's one removal is the earlier-name directory.\n",{"shell":24,"description":7,"allowed-tools":25,"argument-hint":28,"user-invocable":29,"disable-model-invocation":29},"bash",[26,27],"Bash(command -v jq*)","Bash(command -v node*)","[check|apply] [defaults|cache-line]",true,"main","5aff8ba54896bc54fd0eb46e4a954099449cf67d","plugins\u002Fcontext-usage\u002Fskills\u002Fsetup",7,"https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins","https:\u002F\u002Fgithub.com\u002Fmelodic-software","https:\u002F\u002Fmelodicsoftware.com","Independent software studio building developer tools, automation, and application services, with roots in music.","2026-11-15 05:15:06",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":29},[41,44,47],{"tool":42,"command":43},"npx","npx skills add melodic-software\u002Fclaude-code-plugins --skill setup",{"tool":45,"command":46},"bunx","bunx skills add melodic-software\u002Fclaude-code-plugins --skill setup",{"tool":48,"command":49},"pnpm","pnpm dlx skills add melodic-software\u002Fclaude-code-plugins --skill setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcontext-usage\u002Fskills\u002Fsetup\u002FSKILL.md",[],[53,60,67,74,79,86],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7DYYDG31B9YX7N9MB9QW2GW","track","Backlog reads through the bound tracker: search open and closed items, view one item with its comments and state history. Use when another skill searches or reads tracker items.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fsession-flow\u002Fevals\u002Frecall-still-reports-reopened-bug\u002Fwork-items-stub\u002Fskills\u002Ftrack\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7DYXVBAVG3NV30PA7GKW9Q6","reviewer-media","Reviewer media for one pull request: decides whether it needs a narrated walkthrough, builds the storyboard from \u002Freview:explain-change's digest, has \u002Fexplainer-video:produce render it and hands the manifest to \u002Fsource-control:pull-request media. Use when asked for 'reviewer media', 'a walkthrough video for this PR', 'a produced video of this change', or when pull-request ready or monitor hands a PR over.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Freview\u002Fskills\u002Freviewer-media\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7DYRZ5YD44AMYH26YR25GZ8","route","Model and effort per agent role (orchestrator, worker, verifier, retrieval) for a multi-agent run, resolved through the bundled defaults and the user, team and personal override config layers into fenced JSON with single-agent and fan-out variants and the layer behind each value. Use when asked 'which model for the subagents', 'route the roles' or 'model routing', or before a skill passes a role's model on a spawn.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-pin-without-override\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":75,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7DYRTVT4FWTGDJY0HCCFJMZ","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fdiscovery\u002Fevals\u002Fex-model-override-from-route\u002Fmulti-agent-stub\u002Fskills\u002Froute\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7DYNZC8PNW3T27V2ADKECKJ","principles","Module-design vocabulary for architecture findings, and the checks built on it. Use when: 'what is a deep module', 'what is a seam', 'deep vs shallow module', 'what is the deletion test', 'leverage and locality', 'module design vocabulary', 'which word do we use for X in architecture findings'. Scanning a codebase for friction is \u002Farchitecture:improve.","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fskills\u002Fprinciples\u002FSKILL.md",[],[],{"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":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7DYNMCZNEWBFHV9KTSS6H60","write","Structured five-field bug report (title, steps to reproduce, expected vs actual, justified severity, suggested fix location) from an informal description, read-only. Use when the user names a defect they observed, or asks for one written up ('report a bug', 'file a bug', 'write this up as a bug').","https:\u002F\u002Fgithub.com\u002Fmelodic-software\u002Fclaude-code-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Farchitecture\u002Fevals\u002Fdeepening-defect-goes-to-bugs-write\u002Fbugs-stub\u002Fskills\u002Fwrite\u002FSKILL.md",[],[]]