{"slug":"kst-ai-assets-usage","title":"kst-ai-assets-usage","summary":"Report which kasetto-installed skills and MCP servers are actually being used across the AI agents on this machine, and render a branded HTML dashboard of the result. Use whenever the user asks what agent assets they actually use, which skills or MCPs are dead weight, what to pru","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-14T20:33:46.866451Z","repo":{"url":"https://github.com/pivoshenko/kasetto","stars":205,"forks":8,"license":null,"updatedAt":"2026-09-21T19:56:27Z"},"bodyHtml":"<hr>\n<h2>name: kst-ai-assets-usage\ndescription: Report which kasetto-installed skills and MCP servers are actually being used across the AI agents on this machine, and render a branded HTML dashboard of the result. Use whenever the user asks what agent assets they actually use, which skills or MCPs are dead weight, what to prune or clean up from kasetto.yaml, why their context is bloated with unused MCP servers, whether a skill has ever been invoked, or wants a usage report, audit, or dashboard of their agent setup. Also trigger on \"kst ai assets usage\", \"ai asset usage\", \"what skills do I actually use\", \"which MCPs are worth keeping\", \"audit my agent assets\", \"am I using all these skills\", or any request to review, trim, or justify an installed agent toolkit.</h2>\n<h1>kst-ai-assets-usage</h1>\n<p>Kasetto knows what you installed. Each agent knows what it ran. Nothing on the\nmachine joins the two, so installed-and-forgotten assets accumulate silently -\nskills nobody has ever invoked, MCP servers loading tool definitions into every\nrequest for a server the user stopped using months ago.</p>\n<p>This skill closes that loop: read the lock, read each agent's local session\nstore, join them, and say plainly what is alive and what is dead.</p>\n<h2>Run It</h2>\n<p>Two scripts, both standard-library Python 3, both offline.</p>\n<pre><code>python3 scripts/collect.py --out usage.json        # scan + join\npython3 scripts/render.py usage.json --out usage.html\n</code></pre>\n<p><code>collect.py</code> is the slow one on a cold cache (a few seconds for a large history)\nand near-instant afterwards - it caches per-file results in\n<code>$XDG_CACHE_HOME/kasetto/usage-scan.json</code> keyed on size and mtime, so a rerun\nonly touches files the agent appended to. Delete that file to force a full\nrescan.</p>\n<p>Open the dashboard when it is written, then give the user the short version in\nthe terminal: how many assets are idle, the biggest surprises, and what you would\ncut. The HTML is the artifact; your reading of it is the value.</p>\n<h2>The Rule That Matters: Never Overstate Coverage</h2>\n<p><code>collect.py</code> reports a <code>coverage</code> block listing every agent it knows about and\nwhether it found a readable session store. Honour it.</p>\n<p>An asset the user drives daily from an agent that has no provider <strong>looks\ncompletely dead in this report</strong>. If you present \"55 skills never used\" without\nsaying which agents that claim covers, and they act on it, they delete something\nthey rely on. That is the one way this skill can actively hurt someone.</p>\n<p>So:</p>\n<ul>\n<li>State the coverage before any count that depends on it. The dashboard carries\nthis as a Review insight naming the unread agents rather than a banner, so it\nis easy to scroll past - say it out loud in your summary</li>\n<li>Phrase the finding as \"never invoked in <em>the agents kasetto can read</em>\", not\n\"never invoked\"</li>\n<li>When a <code>status: absent</code> agent is one the user actually uses, say so directly\nand treat the idle list as a shortlist to review rather than a cut list</li>\n<li>A <code>verified_format: false</code> provider parsed a store whose layout has not been\nconfirmed against a real sample. A zero from it is weak evidence, not proof</li>\n</ul>\n<h2>Reading the Output</h2>\n<p>Start with <code>insights</code> - <code>collect.py</code> computes the findings worth acting on\nrather than leaving them to be read off a chart. Each carries a <code>severity</code>, a\n<code>title</code> already phrased as a claim, a <code>detail</code> explaining why it matters, and\nthe <code>items</code> it refers to. Lead your summary with these, in order; they are\nalready sorted by severity. Then use the rest of the JSON to answer follow-ups.</p>\n<p>Severity is a deliberately narrow vocabulary, and it drives colour in the\ndashboard:</p>\n<ul>\n<li><code>bad</code> (red) - Concrete waste, meaning a source repo with nothing in use. This\nis the only thing red is spent on, because an unused skill is dormant, not\nbroken, and colouring it red would burn the strongest signal on the least\nurgent finding</li>\n<li><code>warn</code> (amber) - Act on it: idle MCP packs, coverage gaps, unverified formats</li>\n<li><code>info</code> (cyan) - Context: concentration, freshly installed assets, unmanaged\nfinds</li>\n<li><code>good</code> (green) - Nothing idle</li>\n</ul>\n<p>Idle skills are grey throughout. Keep that distinction when you talk about them:\n\"dormant\" and \"worth a look\", not \"bad\".</p>\n<p><code>usage.json</code> carries more than the dashboard shows. Worth reading directly when\nthe user asks something specific:</p>\n<ul>\n<li><code>skills</code> / <code>mcps</code> - Per asset: <code>total</code>, <code>last_used</code>, <code>by_agent</code>, <code>days</code> (a\ndate-keyed histogram), plus <code>source</code> and <code>scope</code> from the lock. Skills carry\n<code>age</code> and a <code>fresh</code> flag; MCP packs carry <code>by_server</code> and <code>by_tool</code></li>\n<li><code>by_source</code> - Per source repo, how many of its assets are live, fresh and idle.\n<strong>Usually the most useful view.</strong> Assets go idle in clusters, because a repo\ngets added for one skill and brings twelve. A wholly idle source is a single\n<code>source:</code> block to delete rather than N rows to prune, so lead with this when\nrecommending cuts</li>\n<li><code>activity</code> - Daily invocation totals for skills and MCPs, which is what\nseparates \"used heavily last year\" from \"used steadily this week\"</li>\n<li><code>unmanaged</code> - Names called locally that are not in the lock: installed by hand\nor shipped by the agent. A heavily used one is worth bringing under\n<code>kasetto.yaml</code> so it syncs everywhere</li>\n<li><code>counts</code> - Headline numbers, with <code>skills_idle</code> and <code>skills_fresh</code> already\nseparated</li>\n</ul>\n<p>An MCP pack can merge several servers, so usage is counted per server and rolled\nup. A pack alive on one server and idle on another is worth calling out; that\ndetail is invisible in the pack-level total.</p>\n<h2>Recommending Removals</h2>\n<p>The idle list is a starting point, not a verdict. Before suggesting a cut:</p>\n<ul>\n<li>Skills cost almost nothing when idle - only their description is loaded until\ninvoked. An unused skill is clutter, not a real tax</li>\n<li><strong>MCP servers are different.</strong> Their tool definitions load into context on\nevery single request whether or not you call them. An idle MCP pack is a\nstanding cost, so it is the far stronger cut candidate and worth leading with</li>\n<li>An asset installed last week that has not been used yet is not dead, it is new.\n<code>collect.py</code> already separates these into <code>skills_fresh</code> using a 7-day\nthreshold, and the dashboard holds them in their own section. Never move one\ninto a cut list because its count is zero</li>\n<li>Some assets exist for rare high-stakes moments (an incident runbook, a release\nprocedure). Low count is the design, not a defect</li>\n</ul>\n<p>To act on a decision, the existing CLI does it - <code>kst remove</code> edits\n<code>kasetto.yaml</code> in place and preserves comments and key order, then <code>kst sync</code>\nuninstalls the asset. Do not hand-edit the lock.</p>\n<h2>Adding an Agent</h2>\n<p>The provider list is a table at the top of <code>scripts/collect.py</code>. Adding one is a\nnew entry plus, sometimes, a reader. <code>references/providers.md</code> documents each\nknown agent's store, which are verified against real data, and which are\ninferred from documentation.</p>\n<p>Two things to hold onto when you extend it:</p>\n<p><strong>Match patterns, not schemas.</strong> Session formats churn - Goose moved JSONL to\nSQLite, OpenCode JSON to SQLite, Copilot CLI flat files to per-session\ndirectories. What did <em>not</em> move through any of those migrations is the tool-name\nstring. Matching <code>mcp__&lt;server&gt;__&lt;tool&gt;</code> survives a schema rewrite that would\nbreak a field-by-field parser. Resist the urge to \"properly\" parse these files.</p>\n<p><strong>Anchor on an invocation position.</strong> Session logs also record the tools\n<em>offered</em> each turn, as arrays of names repeated on every request. An early\nversion matched the bare <code>mcp__x__y</code> string anywhere and reported 38,743 calls\nfor a server with zero real invocations. Every pattern must require a key\nposition (<code>\"name\": \"mcp__...\"</code>), and any new provider needs a sanity check\nagainst an independent count before its numbers are trusted.</p>\n<h2>Scope</h2>\n<p>Skills and MCP servers only. Commands and instructions are deliberately out:\nslash commands in the logs are mostly agent built-ins rather than kasetto assets,\nand instructions are injected as context and never \"invoked\", so usage is\nundefined for them. If asked about those, explain why rather than guessing.</p>\n<p>Everything stays local. The scripts read files and run <code>kst list --json</code>; nothing\nis uploaded, and the dashboard makes no network requests so it stays readable\noffline and safe to share.</p>\n","files":[{"path":"references/providers.md","sizeBytes":3931,"isText":true},{"path":"scripts/collect.py","sizeBytes":33885,"isText":true},{"path":"scripts/render.py","sizeBytes":26723,"isText":true},{"path":"SKILL.md","sizeBytes":8205,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-14T20:34:10.829344Z","sha256":"175CA3D2C6C555CC68E297194119E607626DE5A9EDB463207AEBC6FAD88FD224","sizeBytes":25811},"review":null,"source":{"repositoryUrl":"https://github.com/pivoshenko/kasetto","path":"skills/kst-ai-assets-usage","license":null,"commit":"845402750261de84c138d96f01706a8406178166","subtreeSha":"84BFC9C6DC9400D24A139CD0E1A0A4C7998164C9172AC60005029C3689ADBCC9","lastSyncedAt":"2026-09-27T19:45:57.960453Z"},"reviewedAt":"2026-09-14T20:35:14.801905Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/pivoshenko/kasetto/tree/main/skills/kst-ai-assets-usage"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install pivoshenko-kasetto@llmmart"},{"target":"git","command":"git clone https://github.com/pivoshenko/kasetto.git"}]}