Repository navigation
Release 0.40.0: unused skills, skills an agent may confuse - #25
Merged
Merged
Conversation
unused reads Claude Code's session transcripts on this machine and lists the installed skills it has not used lately; --remove uninstalls them. overlaps compares the descriptions of the installed skills a same agent sees and lists the close pairs. Both are MCP tools too.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two commands about the skills already installed, and the 0.40.0 release.
What changes
skills-atlas unusedreads Claude Code's session transcripts on this machine and lists the installed skills it has not used in the last 30 days (--days). A use is a Skill tool call, a slash command, or a read of the skill'sSKILL.md, subagents included. Skills installed during the window are listed as too early to tell, skills not installed for Claude Code as unknown, and no transcript in the window is an error.--removeuninstalls the unused ones (--dry-runprints the commands). MCP tool:unused_skills.skills-atlas overlapscompares the descriptions of the installed skills a same agent sees (TF-IDF over the installed set, cosine) and lists the pairs at or above 0.5 (--threshold), with the words they share. MCP tool:overlapping_skills.Messages are translated in the nine languages.
Limits
Tried on a real setup
105 installed skills, 3,684 transcripts changed in 30 days:
unusedtook about 40 s and found 26 used skills, 14 too recent, none unused;overlapslisted 7 pairs at 0.5 (13 at 0.4, 3 at 0.6).unused --removewas not run for real.Tests
npm run typecheckandnpm run buildpass;npm test: 286 pass.