Skip to content
Docs: Usage tracking

Managing skills

Usage tracking

How often agents load each skill, per repo and day, from an opt-in hook. What is sent, and how to turn it off.

On this page

How it works

The installer adds a small hook to .claude/settings.json. When Claude Code uses a skill, the hook runs node .skillify/cli.mjs hook, which sends one event to Skillify and exits. Usage appears on the overview, on each skill and on each repo's Usage tab.

What is sent

Exactly three things: the repo (owner/name), the skill's name and the time. The request carries the repo's ingest key. Nothing from the session is sent: no prompts, no code, no file names, no user names.

The ingest key is in .skillify/config.json and is committed with the repo. It can only report usage and sync status; it cannot read skills or change anything. Rotate it from the repo's Settings if you want older clones to stop reporting.

Turn it off

Set "usage": false in .skillify/config.json and run sync. The hook is removed and nothing is sent. Other agents have no hook, so their use is not counted; drift reports still work.

Reading it

A skill nobody uses still costs context in every session. Each repo's page shows its context cost next to usage: skills with a high cost and no uses are the first to drop.

Usage
How often agents loaded each skill, per repo and day. Counts only: repo, skill name and time, nothing from the session.An optional Claude Code hook reports each Skill tool call with the repo’s ingest key. Turn it off with "usage": false in .skillify/config.json.Also: uses, usage hook
Ingest key
A write-only key in .skillify/config.json. It can only report status and usage, so it is safe to commit.It cannot read skills or change anything. Rotate it in the repo’s settings if you want to cut off old clones.Also: ik_, ingestKey
Context cost
Roughly how many tokens a repo’s skill descriptions add to every agent session, used or not.Estimated as characters ÷ 4. Skills nobody uses still cost this on every session: the usage page shows which ones to drop.