skillvitals 0.1.0__tar.gz

skillvitals-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# skillvitals
+.skillvitals/
+*.sqlite
+dashboard.html
+.coverage
+htmlcov/

skillvitals-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

skillvitals-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skillvitals-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: skillvitals
+Version: 0.1.0
+Summary: Skill observability for Claude Code — see which skills fire, which are dormant, what they cost in context, and what's broken.
+Project-URL: Homepage, https://github.com/PraveenKumarSridhar/skillvitals
+Project-URL: Repository, https://github.com/PraveenKumarSridhar/skillvitals
+Project-URL: Issues, https://github.com/PraveenKumarSridhar/skillvitals/issues
+Author: Pk
+License: MIT
+License-File: LICENSE
+Keywords: anthropic,claude,claude-code,mcp,observability,skills
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# skillvitals
+
+**Skill observability for Claude Code.** See which of your skills fire, which are
+dormant, what they cost in context, and what's broken.
+
+Claude Code skills are supposed to auto-activate. In practice many never fire —
+they just sit in every session burning context tokens. The ecosystem has plenty
+of tools to *generate* skill-activation hooks. `skillvitals` is the missing
+diagnostic layer: it treats every installed skill as a monitored service and
+tells you *did it fire? when? at what context cost? is it dead weight?*
+
+```text
+$ skillvitals scan
+
+                                  skillvitals
+┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
+┃ skill              ┃ fires ┃ engaged ┃  ctx ┃ last seen ┃ status         ┃
+┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
+│ frontend-design    │    31 │     140 │ 6.4k │ today     │ ✅ healthy     │
+│ docx               │    47 │     120 │ 2.1k │ today     │ ✅ healthy     │
+│ pdf                │    23 │      60 │ 1.8k │ 1d ago    │ ✅ healthy     │
+│ sql-tuner          │     4 │       9 │ 2.6k │ 9d ago    │ ✅ healthy     │
+│ ab-test-coach      │     2 │       2 │ 5.7k │ 3d ago    │ ⚠️  misfiring  │
+│ leakcheck          │     1 │       3 │ 3.1k │ 40d ago   │ ⚠️  dormant    │
+│ data-analysis      │     0 │       0 │ 4.2k │ never     │ 💤 never-fired │
+│ changelog-writer   │     0 │       0 │ 1.4k │ never     │ 💤 never-fired │
+└────────────────────┴───────┴─────────┴──────┴───────────┴────────────────┘
+
+3 dormant/never-fired skills are costing you 8.7k tokens per session.
+Run `skillvitals prescribe` for fixes.
+```
+
+That last line is the point: **most people have thousands of tokens of dead
+weight in every single session and no way to see it.**
+
+## Install
+
+```bash
+uvx skillvitals scan          # run without installing
+# or
+pip install skillvitals
+```
+
+Requires Python 3.11+. Reads your existing Claude Code data under `~/.claude` —
+nothing is sent anywhere (see [Privacy](#privacy)).
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `skillvitals scan` | Headline table: fires, engagement, context cost, health, per skill. |
+| `skillvitals report` | Markdown report (`-o report.md` to save / share). |
+| `skillvitals history` | Per-skill activation history across sessions. |
+| `skillvitals dormancy` | Skills inactive for N days and the tokens they cost (`--days 14`). |
+| `skillvitals prescribe` | Concrete fixes for weak/dormant/redundant skills (`--rewrite` for LLM rewrites). |
+| `skillvitals test --skill X` | Synthetic activation-test prompts (`--live` runs them through headless Claude Code). |
+| `skillvitals dashboard --open` | Self-contained HTML dashboard at `~/.skillvitals/dashboard.html`. |
+| `skillvitals serve` | Run as an MCP server. |
+
+## Use it as an MCP server
+
+`skillvitals` is also an MCP server, so you can ask Claude Code about your skills
+in plain language ("which of my skills are dormant?").
+
+```bash
+claude mcp add skillvitals -- uvx skillvitals serve
+```
+
+Or add it to your MCP config manually:
+
+```json
+{
+  "mcpServers": {
+    "skillvitals": { "command": "uvx", "args": ["skillvitals", "serve"] }
+  }
+}
+```
+
+Exposed tools: `vitals_scan`, `vitals_history`, `vitals_dormancy`,
+`vitals_report`, `vitals_prescribe`, `vitals_test`, `vitals_dashboard`.
+
+## How it works
+
+skillvitals reads two things, entirely locally:
+
+1. **Your installed skills** — every `SKILL.md` under `~/.claude/skills`, the
+   plugin cache, and the current project's `.claude/skills`. It parses the
+   frontmatter, estimates the context cost (tokens of the loaded `SKILL.md`),
+   and scores description quality.
+
+2. **Your session logs** — the JSONL transcripts under `~/.claude/projects`. It
+   extracts two activation signals per skill:
+   - **fires** — explicit `Skill()` invocations (the skill was activated).
+   - **engaged** — assistant messages tagged with that skill's `attributionSkill`
+     (how much the skill was actually leaned on afterward).
+
+Joining the two gives each skill a health status:
+
+| status | meaning |
+|--------|---------|
+| ✅ **healthy** | activated recently with real follow-through |
+| ⚠️ **misfiring** | invoked but barely used afterward — may be matching the wrong prompts |
+| ⚠️ **dormant** | activated before, but not within the window |
+| 💤 **never-fired** | installed, costs tokens, has never activated |
+| ❓ **orphan** | appears in logs but is no longer installed |
+
+These are honest heuristics, not ground truth — the thresholds are documented in
+`analysis.py` and `prescribe.py`.
+
+## Privacy
+
+100% local. skillvitals only reads files already on your machine under
+`~/.claude`, writes a local SQLite cache to `~/.skillvitals/db.sqlite`, and a
+local HTML file. **No network calls, no telemetry, nothing leaves your machine** —
+with two explicit, opt-in exceptions:
+
+- `skillvitals test --live` spawns headless Claude Code to measure real activation.
+- `skillvitals prescribe --rewrite` calls the Anthropic API to rewrite weak
+  descriptions. Requires `pip install 'skillvitals[llm]'` and `ANTHROPIC_API_KEY`.
+
+Both are off by default.
+
+## What it deliberately doesn't do
+
+- **Generate activation hooks.** That space is well covered (`skills-hook`,
+  `claude-skills-supercharged`, …). Pair skillvitals with one of those — it
+  *reports* whether a `UserPromptSubmit` hook exists, it doesn't write one.
+- **Auto-apply fixes.** v1 shows prescriptions; it doesn't edit your skills.
+- **Phone home.** No cloud, no accounts, no team aggregation.
+
+## Configuration
+
+Environment variables (all optional):
+
+- `SKILLVITALS_CLAUDE_HOME` — the `.claude` dir (default `~/.claude`).
+- `SKILLVITALS_HOME` — where the db + dashboard live (default `~/.skillvitals`).
+- `ANTHROPIC_API_KEY` — only needed for the opt-in LLM features.
+
+## Development
+
+```bash
+uv sync --extra llm
+uv run pytest        # 47 tests
+uv run ruff check src tests
+```
+
+## License
+
+MIT © 2026 Pk

skillvitals-0.1.0/PUBLISHING.md

@@ -0,0 +1,71 @@
+# Publishing skillvitals
+
+Everything here is **left for you to run** — I built and validated the package
+locally but deliberately did not publish to PyPI or push to a public GitHub
+repo, because those are irreversible, outward-facing, and tied to your identity
+and credentials. Do these when you're awake and ready to launch.
+
+## 0. Pre-flight (already done / verify)
+
+```bash
+uv run pytest                 # 47 passing
+uv run ruff check src tests   # clean
+uv build                      # builds dist/*.whl and dist/*.tar.gz
+```
+
+A clean-room install of the built wheel has been verified to expose the
+`skillvitals` console script and run `skillvitals scan` (see
+`docs/superpowers/plans/` notes).
+
+## 1. Set the real homepage URLs
+
+`pyproject.toml` currently points `Homepage`/`Repository`/`Issues` at
+`github.com/pk/skillvitals`. Update those to your actual GitHub username/org
+before publishing.
+
+## 2. Create the GitHub repo
+
+```bash
+gh repo create skillvitals --public --source=. --remote=origin \
+  --description "Skill observability for Claude Code"
+git push -u origin main
+```
+
+(Record a demo GIF of `skillvitals scan` and drop it in the README — the
+dormant-token line is the viral asset.)
+
+## 3. Publish to PyPI
+
+Test on TestPyPI first:
+
+```bash
+uv publish --publish-url https://test.pypi.org/legacy/ --token <test-token>
+uvx --index-url https://test.pypi.org/simple/ skillvitals scan   # smoke test
+```
+
+Then the real thing:
+
+```bash
+uv publish --token <pypi-token>      # uses dist/ from `uv build`
+```
+
+Verify:
+
+```bash
+uvx skillvitals scan
+```
+
+## 4. Register with MCP directories
+
+- Glama, mcpmarket.com (per the PRD launch plan).
+
+## 5. Launch posts
+
+Drafts/checklist live in the PRD (Show HN, r/ClaudeAI, LinkedIn, X thread, the
+DM tour). The headline is always the dead-token number from your own machine.
+
+## Name availability (from the PRD, last checked 2026-05-25)
+
+`skillvitals` was reported available on PyPI / npm / GitHub and `skillvitals.dev`
+was free. **Re-check immediately before publishing** — these can change.
+Fallbacks: `skillscope`, `skillmon`, `skill-doctor`.

skillvitals-0.1.0/README.md

@@ -0,0 +1,149 @@
+# skillvitals
+
+**Skill observability for Claude Code.** See which of your skills fire, which are
+dormant, what they cost in context, and what's broken.
+
+Claude Code skills are supposed to auto-activate. In practice many never fire —
+they just sit in every session burning context tokens. The ecosystem has plenty
+of tools to *generate* skill-activation hooks. `skillvitals` is the missing
+diagnostic layer: it treats every installed skill as a monitored service and
+tells you *did it fire? when? at what context cost? is it dead weight?*
+
+```text
+$ skillvitals scan
+
+                                  skillvitals
+┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
+┃ skill              ┃ fires ┃ engaged ┃  ctx ┃ last seen ┃ status         ┃
+┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
+│ frontend-design    │    31 │     140 │ 6.4k │ today     │ ✅ healthy     │
+│ docx               │    47 │     120 │ 2.1k │ today     │ ✅ healthy     │
+│ pdf                │    23 │      60 │ 1.8k │ 1d ago    │ ✅ healthy     │
+│ sql-tuner          │     4 │       9 │ 2.6k │ 9d ago    │ ✅ healthy     │
+│ ab-test-coach      │     2 │       2 │ 5.7k │ 3d ago    │ ⚠️  misfiring  │
+│ leakcheck          │     1 │       3 │ 3.1k │ 40d ago   │ ⚠️  dormant    │
+│ data-analysis      │     0 │       0 │ 4.2k │ never     │ 💤 never-fired │
+│ changelog-writer   │     0 │       0 │ 1.4k │ never     │ 💤 never-fired │
+└────────────────────┴───────┴─────────┴──────┴───────────┴────────────────┘
+
+3 dormant/never-fired skills are costing you 8.7k tokens per session.
+Run `skillvitals prescribe` for fixes.
+```
+
+That last line is the point: **most people have thousands of tokens of dead
+weight in every single session and no way to see it.**
+
+## Install
+
+```bash
+uvx skillvitals scan          # run without installing
+# or
+pip install skillvitals
+```
+
+Requires Python 3.11+. Reads your existing Claude Code data under `~/.claude` —
+nothing is sent anywhere (see [Privacy](#privacy)).
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `skillvitals scan` | Headline table: fires, engagement, context cost, health, per skill. |
+| `skillvitals report` | Markdown report (`-o report.md` to save / share). |
+| `skillvitals history` | Per-skill activation history across sessions. |
+| `skillvitals dormancy` | Skills inactive for N days and the tokens they cost (`--days 14`). |
+| `skillvitals prescribe` | Concrete fixes for weak/dormant/redundant skills (`--rewrite` for LLM rewrites). |
+| `skillvitals test --skill X` | Synthetic activation-test prompts (`--live` runs them through headless Claude Code). |
+| `skillvitals dashboard --open` | Self-contained HTML dashboard at `~/.skillvitals/dashboard.html`. |
+| `skillvitals serve` | Run as an MCP server. |
+
+## Use it as an MCP server
+
+`skillvitals` is also an MCP server, so you can ask Claude Code about your skills
+in plain language ("which of my skills are dormant?").
+
+```bash
+claude mcp add skillvitals -- uvx skillvitals serve
+```
+
+Or add it to your MCP config manually:
+
+```json
+{
+  "mcpServers": {
+    "skillvitals": { "command": "uvx", "args": ["skillvitals", "serve"] }
+  }
+}
+```
+
+Exposed tools: `vitals_scan`, `vitals_history`, `vitals_dormancy`,
+`vitals_report`, `vitals_prescribe`, `vitals_test`, `vitals_dashboard`.
+
+## How it works
+
+skillvitals reads two things, entirely locally:
+
+1. **Your installed skills** — every `SKILL.md` under `~/.claude/skills`, the
+   plugin cache, and the current project's `.claude/skills`. It parses the
+   frontmatter, estimates the context cost (tokens of the loaded `SKILL.md`),
+   and scores description quality.
+
+2. **Your session logs** — the JSONL transcripts under `~/.claude/projects`. It
+   extracts two activation signals per skill:
+   - **fires** — explicit `Skill()` invocations (the skill was activated).
+   - **engaged** — assistant messages tagged with that skill's `attributionSkill`
+     (how much the skill was actually leaned on afterward).
+
+Joining the two gives each skill a health status:
+
+| status | meaning |
+|--------|---------|
+| ✅ **healthy** | activated recently with real follow-through |
+| ⚠️ **misfiring** | invoked but barely used afterward — may be matching the wrong prompts |
+| ⚠️ **dormant** | activated before, but not within the window |
+| 💤 **never-fired** | installed, costs tokens, has never activated |
+| ❓ **orphan** | appears in logs but is no longer installed |
+
+These are honest heuristics, not ground truth — the thresholds are documented in
+`analysis.py` and `prescribe.py`.
+
+## Privacy
+
+100% local. skillvitals only reads files already on your machine under
+`~/.claude`, writes a local SQLite cache to `~/.skillvitals/db.sqlite`, and a
+local HTML file. **No network calls, no telemetry, nothing leaves your machine** —
+with two explicit, opt-in exceptions:
+
+- `skillvitals test --live` spawns headless Claude Code to measure real activation.
+- `skillvitals prescribe --rewrite` calls the Anthropic API to rewrite weak
+  descriptions. Requires `pip install 'skillvitals[llm]'` and `ANTHROPIC_API_KEY`.
+
+Both are off by default.
+
+## What it deliberately doesn't do
+
+- **Generate activation hooks.** That space is well covered (`skills-hook`,
+  `claude-skills-supercharged`, …). Pair skillvitals with one of those — it
+  *reports* whether a `UserPromptSubmit` hook exists, it doesn't write one.
+- **Auto-apply fixes.** v1 shows prescriptions; it doesn't edit your skills.
+- **Phone home.** No cloud, no accounts, no team aggregation.
+
+## Configuration
+
+Environment variables (all optional):
+
+- `SKILLVITALS_CLAUDE_HOME` — the `.claude` dir (default `~/.claude`).
+- `SKILLVITALS_HOME` — where the db + dashboard live (default `~/.skillvitals`).
+- `ANTHROPIC_API_KEY` — only needed for the opt-in LLM features.
+
+## Development
+
+```bash
+uv sync --extra llm
+uv run pytest        # 47 tests
+uv run ruff check src tests
+```
+
+## License
+
+MIT © 2026 Pk

skillvitals-0.1.0/docs/sample-dashboard.html

@@ -0,0 +1,205 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>skillvitals dashboard</title>
+<style>
+  :root { --bg:#0d1117; --card:#161b22; --line:#30363d; --fg:#e6edf3; --dim:#8b949e;
+          --green:#3fb950; --yellow:#d29922; --red:#f85149; --accent:#58a6ff; }
+  * { box-sizing: border-box; }
+  body { margin:0; background:var(--bg); color:var(--fg);
+         font:14px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif; }
+  .wrap { max-width: 1100px; margin: 0 auto; padding: 32px 20px 64px; }
+  h1 { font-size: 22px; margin: 0 0 4px; }
+  .sub { color: var(--dim); margin: 0 0 24px; }
+  .cards { display:flex; gap:14px; flex-wrap:wrap; margin-bottom:28px; }
+  .card { background:var(--card); border:1px solid var(--line); border-radius:10px;
+          padding:16px 18px; min-width:150px; flex:1; }
+  .card .n { font-size:26px; font-weight:700; }
+  .card .l { color:var(--dim); font-size:12px; text-transform:uppercase; letter-spacing:.04em; }
+  .card.alert .n { color: var(--yellow); }
+  table { width:100%; border-collapse:collapse; background:var(--card);
+          border:1px solid var(--line); border-radius:10px; overflow:hidden; }
+  th,td { text-align:left; padding:10px 14px; border-bottom:1px solid var(--line); }
+  th { cursor:pointer; user-select:none; color:var(--dim); font-weight:600;
+       font-size:12px; text-transform:uppercase; letter-spacing:.03em; }
+  th:hover { color: var(--fg); }
+  tbody tr:last-child td { border-bottom:none; }
+  tbody tr:hover { background: #1c2330; }
+  td.num { text-align:right; font-variant-numeric: tabular-nums; }
+  .pill { display:inline-block; padding:2px 8px; border-radius:999px; font-size:12px; font-weight:600; }
+  .healthy { color:var(--green); } .dormant,.misfiring { color:var(--yellow); }
+  .never-fired { color:var(--dim); } .orphan { color:var(--red); }
+  .bar { height:6px; background:#21262d; border-radius:4px; overflow:hidden; min-width:60px; }
+  .bar > i { display:block; height:100%; background:var(--accent); }
+  .rx { margin-top:28px; }
+  .rx h2 { font-size:16px; }
+  .rx li { margin:6px 0; color:var(--dim); }
+  .rx b { color:var(--fg); }
+  footer { margin-top:30px; color:var(--dim); font-size:12px; }
+  code { background:#21262d; padding:1px 6px; border-radius:5px; }
+</style>
+</head>
+<body>
+<div class="wrap">
+  <h1>skillvitals</h1>
+  <p class="sub">8 skills scanned · generated 2026-05-25 (demo data)</p>
+
+  <div class="cards">
+    <div class="card"><div class="n">8</div><div class="l">skills</div></div>
+    <div class="card"><div class="n">4</div><div class="l">healthy</div></div>
+    <div class="card alert"><div class="n">3</div><div class="l">dormant / never-fired</div></div>
+    <div class="card alert"><div class="n">8.7k</div><div class="l">dead tokens / session</div></div>
+  </div>
+
+  <table id="vitals">
+    <thead><tr>
+      <th onclick="sortTable(0,'s')">skill</th>
+      <th onclick="sortTable(1,'n')">fires</th>
+      <th onclick="sortTable(2,'n')">engaged</th>
+      <th onclick="sortTable(3,'n')">ctx tokens</th>
+      <th onclick="sortTable(4,'n')">quality</th>
+      <th onclick="sortTable(5,'n')">last seen</th>
+      <th onclick="sortTable(6,'s')">status</th>
+    </tr></thead>
+    <tbody>
+    
+      <tr class="skill-row">
+        <td>frontend-design</td>
+        <td class="num" data-v="31">31</td>
+        <td class="num" data-v="140">140</td>
+        <td class="num" data-v="6400">6.4k</td>
+        <td class="num" data-v="88">
+          <div class="bar" title="88/100"><i style="width:88%"></i></div>
+        </td>
+        <td class="num" data-v="0">today</td>
+        <td><span class="pill healthy">healthy</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>docx</td>
+        <td class="num" data-v="47">47</td>
+        <td class="num" data-v="120">120</td>
+        <td class="num" data-v="2100">2.1k</td>
+        <td class="num" data-v="82">
+          <div class="bar" title="82/100"><i style="width:82%"></i></div>
+        </td>
+        <td class="num" data-v="0">today</td>
+        <td><span class="pill healthy">healthy</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>pdf</td>
+        <td class="num" data-v="23">23</td>
+        <td class="num" data-v="60">60</td>
+        <td class="num" data-v="1800">1.8k</td>
+        <td class="num" data-v="80">
+          <div class="bar" title="80/100"><i style="width:80%"></i></div>
+        </td>
+        <td class="num" data-v="1">1d ago</td>
+        <td><span class="pill healthy">healthy</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>sql-tuner</td>
+        <td class="num" data-v="4">4</td>
+        <td class="num" data-v="9">9</td>
+        <td class="num" data-v="2600">2.6k</td>
+        <td class="num" data-v="72">
+          <div class="bar" title="72/100"><i style="width:72%"></i></div>
+        </td>
+        <td class="num" data-v="9">9d ago</td>
+        <td><span class="pill healthy">healthy</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>ab-test-coach</td>
+        <td class="num" data-v="2">2</td>
+        <td class="num" data-v="2">2</td>
+        <td class="num" data-v="5700">5.7k</td>
+        <td class="num" data-v="70">
+          <div class="bar" title="70/100"><i style="width:70%"></i></div>
+        </td>
+        <td class="num" data-v="3">3d ago</td>
+        <td><span class="pill misfiring">misfiring</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>leakcheck</td>
+        <td class="num" data-v="1">1</td>
+        <td class="num" data-v="3">3</td>
+        <td class="num" data-v="3100">3.1k</td>
+        <td class="num" data-v="76">
+          <div class="bar" title="76/100"><i style="width:76%"></i></div>
+        </td>
+        <td class="num" data-v="40">40d ago</td>
+        <td><span class="pill dormant">dormant</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>data-analysis</td>
+        <td class="num" data-v="0">0</td>
+        <td class="num" data-v="0">0</td>
+        <td class="num" data-v="4200">4.2k</td>
+        <td class="num" data-v="34">
+          <div class="bar" title="34/100"><i style="width:34%"></i></div>
+        </td>
+        <td class="num" data-v="-1">never</td>
+        <td><span class="pill never-fired">never-fired</span></td>
+      </tr>
+    
+      <tr class="skill-row">
+        <td>changelog-writer</td>
+        <td class="num" data-v="0">0</td>
+        <td class="num" data-v="0">0</td>
+        <td class="num" data-v="1400">1.4k</td>
+        <td class="num" data-v="64">
+          <div class="bar" title="64/100"><i style="width:64%"></i></div>
+        </td>
+        <td class="num" data-v="-1">never</td>
+        <td><span class="pill never-fired">never-fired</span></td>
+      </tr>
+    
+    </tbody>
+  </table>
+
+  
+  <div class="rx">
+    <h2>Prescriptions (5)</h2>
+    <ul>
+      
+        <li>[warn] <b>ab-test-coach</b> — Invoked 2× but barely used afterward (engagement 1.0). The description may match prompts it shouldn&#39;t — tighten it to the cases it actually handles.</li>
+      
+        <li>[warn] <b>data-analysis</b> — Description has no trigger phrasing (&#39;Use when…&#39;, &#39;when the user…&#39;). Activation relies on the model matching intent — make it explicit.</li>
+      
+        <li>[info] <b>data-analysis</b> — Description quality score is 34/100. Add specifics: concrete nouns, examples, the triggering situation.</li>
+      
+        <li>[warn] <b>data-analysis</b> — Never fired but costs ~4200 ctx tokens every session. Improve its description so it activates, or remove it to reclaim the budget.</li>
+      
+        <li>[warn] <b>leakcheck</b> — Dormant 40d but costs ~3100 ctx tokens every session. Improve its description so it activates, or remove it to reclaim the budget.</li>
+      
+    </ul>
+  </div>
+  
+
+  <footer>
+    skillvitals · local-only · reads <code>~/.claude</code> · no data leaves your machine
+  </footer>
+</div>
+<script>
+function sortTable(col, type){
+  var tb=document.querySelector('#vitals tbody');
+  var rows=Array.prototype.slice.call(tb.querySelectorAll('tr'));
+  var asc = tb.getAttribute('data-col')==col && tb.getAttribute('data-dir')!='asc';
+  rows.sort(function(a,b){
+    var x=a.children[col], y=b.children[col];
+    if(type=='n'){ x=parseFloat(x.getAttribute('data-v')||0); y=parseFloat(y.getAttribute('data-v')||0); return asc?x-y:y-x; }
+    x=x.textContent.trim(); y=y.textContent.trim(); return asc?x.localeCompare(y):y.localeCompare(x);
+  });
+  rows.forEach(function(r){ tb.appendChild(r); });
+  tb.setAttribute('data-col',col); tb.setAttribute('data-dir',asc?'asc':'desc');
+}
+</script>
+</body>
+</html>