skill-optimizer
Diagnose and optimize Agent Skills (SKILL.md) with real session data and research-backed static analysis. Works with Claude Code, Codex, and any Agent Skills-compatible agent.
Profile →npx skills add sickn33/agentic-awesome-skills --skill skill-optimizer --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
## When to Use This Skill - Use when skills are not triggering as expected or seem broken - Use when you want to audit and improve your skill library's quality - Use when you want to understand which skills are underperforming or wasting context tokens ## Rules - **Read-only**: never modify skill files. Only output report. - **All 8 dimensions**: do not skip any. If data is insufficient, report "N/A — insufficient session data" rather than omitting. - **Quantify**: "you had 12 research tasks last week but the skill never triggered" beats "you often do research". - **Suggest, don't prescribe**: give specific wording suggestions for description improvements, but frame as suggestions. - **Show evidence**: for undertrigger claims, quote the actual user message that should have triggered the skill. - **Evidence-based suggestions**: when suggesting description rewrites, cite the specific research finding that motivates the change (e.g., "front-load trigger keywords — MCP study shows 3.6x selection rate improvement"). ## Overview Analyze skills using **historical session data + static quality checks**, output a diagnostic report with P0/P1/P2 prioritized fixes. Scores each skill on a 5-po
- When to Use This Skill
- Rules
- Overview
- Usage
- Data Sources
- Workflow
- Step 1: Identify Target Skills
- Step 2: Collect Session Data
- Step 3: Run 8 Analysis Dimensions
- Step 4: Composite Score
- Report Format
- Research Background
- Limitations
What does the skill-optimizer skill do?
Diagnose and optimize Agent Skills (SKILL.md) with real session data and research-backed static analysis. Works with Claude Code, Codex, and any Agent Skills-compatible agent.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill skill-optimizer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.