Skip to content

Release 0.40.0: unused skills, skills an agent may confuse - #25

Merged
devohmycode merged 2 commits into
mainfrom
feat/unused-and-overlaps
Nov 10, 2026
Merged

devohmycode merged 2 commits into
mainfrom
feat/unused-and-overlaps

Conversation

@devohmycode

Copy link
Copy Markdown
Owner

Two commands about the skills already installed, and the 0.40.0 release.

What changes

  • skills-atlas unused reads 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's SKILL.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. --remove uninstalls the unused ones (--dry-run prints the commands). MCP tool: unused_skills.
  • skills-atlas overlaps compares 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.
  • 0.40.0: version, changelog. It also ships what was merged since 0.30.0: the new warning signs of the audit, the whole-folder update diff, and the crawl keeping the skills of a failing source.

Messages are translated in the nine languages.

Limits

  • Only Claude Code's transcripts are read; the usage of other agents is not measured.
  • An update reinstalls a skill, so it restarts its "too early to tell" period.
  • The overlap score is a word comparison with English and French stop words: skills of one family match by design.

Tried on a real setup

105 installed skills, 3,684 transcripts changed in 30 days: unused took about 40 s and found 26 used skills, 14 too recent, none unused; overlaps listed 7 pairs at 0.5 (13 at 0.4, 3 at 0.6). unused --remove was not run for real.

Tests

npm run typecheck and npm run build pass; npm test: 286 pass.

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.
@github-project-automation github-project-automation Bot moved this to Backlog in Skills-Atlas Nov 10, 2026
@devohmycode
devohmycode marked this pull request as ready for review November 10, 2026 15:27
@devohmycode
devohmycode merged commit 1e06f7f into main Nov 10, 2026
2 checks passed
@devohmycode
devohmycode deleted the feat/unused-and-overlaps branch November 10, 2026 15:27
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Skills-Atlas Nov 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant