improve-skill · gupsammy — Claude Code skill: what it does, how to install
improve-skill audits skill effectiveness, simulates user requests, and pinpoints missing capabilities in instructions.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@ClaudestWhat improve-skill does
The skill inspects existing instruction sets to see if they actually solve user tasks. It identifies divergence spots where multiple executions might produce conflicting results, pauses on missing requirements, and finds tasks left unfinished. If frontmatter fields or syntax formatting break, the author recommends routing those fixes to repair-skill instead.
The evaluation executes in sequential stages. First, it loads the target SKILL.md file alongside its helper directories, asking the user what falls short. Next, it runs a mental walkthrough of representative prompts, validates tool parameters against current docs using the claude-code-guide subagent, and evaluates edge-case failures. The review scores findings using a rubric from references/effectiveness-rubric.md.
This tool relies on search tools alongside local file edits. It only works on skill directories or SKILL.md documents, meaning agent configurations are unsupported.
What it helps with
- detect underspecified workflow steps and dead ends in
SKILL.md - verify CLI arguments and tool parameters against official docs
- identify complementary features to expand skill scope
- stress test prompt instructions with edge-case inputs
Example prompts for the agent
- Review and improve the skill located at
./skills/release-helper - Check
./my-skill/SKILL.mdfor missing features and UX friction - Audit my skill in
~/.claude/skills/db-migrateand find logic gaps
How to install improve-skill
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-skills@ClaudestThis installs the whole claude-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill improve-skill -a claude-code3Manually: put the files in place
~/.claude/skills/improve-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/improve-skill/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill improve-skill -a codex2Manually: put the files in place
.agents/skills/improve-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill improve-skill -a cursor2Manually: put the files in place
.cursor/skills/improve-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-skills/skills/improve-skill2Manually: put the files in place
.github/skills/improve-skill/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill improve-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/skills/improve-skillManually: put the files in place
.devin/skills/improve-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about improve-skill
How do I install improve-skill in Claude Code?
Add the marketplace source and install the package with /plugin marketplace add gupsammy/Claudest followed by /plugin install claude-skills@Claudest.
What is the difference between improve-skill and repair-skill?
repair-skill fixes malformed frontmatter, broken metadata, and formatting conventions. improve-skill focuses strictly on practical effectiveness, UX flow, and missing instructions.
Can improve-skill audit autonomous agent definitions?
No. The skill is designed strictly for SKILL.md files or skill folders, and the author explicitly notes it does not support agents.
Similar skills
All skills for Agent setup: memory, context, orchestration →improve-skill by other authors comes first.