skill-auditlisted
Install: claude install-skill magnusrodseth/dotfiles
# Skill Audit
Every installed skill's name + description is loaded into context in every
session. This skill finds which ones earn that cost.
## Workflow
1. Run the analyzer:
```bash
bash ~/dotfiles/.claude/skills/skill-audit/scripts/skill-audit.sh
```
Add a project's skills to the inventory with `--root` (repeatable):
```bash
bash ~/dotfiles/.claude/skills/skill-audit/scripts/skill-audit.sh \
--root ~/dev/personal/vault/.claude/skills
```
2. Read the report:
- Header: total skills and the always-loaded token cost per session.
- Main table: used skills, most-used first, with last-used date and source.
- `UNUSED IN WINDOW`: removal candidates, most expensive first.
3. Suggest removals; delete only when the user confirms. Removal mechanics
depend on the `SOURCE` column:
| Source | Managed by | Remove with |
|---|---|---|
| `skills-cli` | skills.sh lock file | `npx skills remove <name>`, then `bash ~/dotfiles/scripts/skills/packages.sh export` and commit the lock file |
| `dotfiles` | authored in dotfiles | delete `~/dotfiles/.claude/skills/<name>/`, run `bash ~/dotfiles/scripts/skills/link-dotfiles-skills.sh` (prunes the global link), remove a leftover `~/.agents/skills/<name>` symlink if present, commit |
| `local` | nothing (untracked real dir in `~/.claude/skills`) | delete the dir; or move keepers into `~/dotfiles/.claude/skills/` so they become tracked and validated |
## Caveats
- Usage evidence is heuristic: Skill tool calls, slash commands, and
SKILL.md re