Prerequisites
- Node.js 22 or Bun;
- one supported agent CLI: Claude Code, Codex, OpenCode, or Pi; and
- at least one installed skill or a project containing a skill folder.
1
Install SelfTune
2
Discover the library
Ask your agent to initialize SelfTune, or inspect the machine directly:Review every detected location. A skill with no usage evidence is
unobserved, not unused.
3
Review what needs attention
In Desktop, open Skills and filter to items needing attention. In the
CLI audit, review duplicate installations, conflicting revisions, and
repair recommendations.Do not apply cleanup automatically. Start with a dry run:
4
Capture a Skill Set
From the project directory, capture the skills it already uses:In Desktop, open Skill Sets, then use Capture Project or build a set
from selected Library skills. SelfTune pins the exact revisions instead of
depending on mutable source folders.
5
Preview project scope
Preview every destination before applying the set:The plan separates new links, unchanged destinations, and conflicts. Apply
it only after the project and file changes are correct.
You are done when
- SelfTune shows the skills installed across your supported agent tools;
- duplicates and conflicts are visible without any package being deleted;
- one Skill Set pins the exact skills needed by the project;
- the project plan shows every destination before mutation; and
- the workflow required no cloud account or upload.