improve-skill

Analyze and enhance Claude Code skills by applying ranked improvements to SKILL.md files.

270|16|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/gupsammy/Claudest --skill improve-skill-gupsammy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-skill
Source: https://github.com/gupsammy/Claudest/tree/main/plugins/claude-skills/skills/improve-skill
Command: npx skills add https://github.com/gupsammy/Claudest --skill improve-skill-gupsammy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users improve existing Claude Code skills by identifying weaknesses, suggesting enhancements, and applying those changes, making skills more effective and user-friendly.

Core Features & Use Cases

  • Effectiveness Audits: Analyzes skills for missing functionality, friction points, and factual drift.
  • Improvement Proposals: Generates ranked suggestions for new features, UX gains, accuracy fixes, and efficiency improvements.
  • Automated Application: Applies selected improvements directly to the skill's code and documentation.
  • Use Case: You have a skill that partially works but is clunky. Use improve-skill to analyze it, get concrete suggestions for making it smoother and more powerful, and have those suggestions automatically implemented.

Quick Start

Use the improve-skill skill to make the skill at plugins/claude-skills/skills/repair-skill better.

Frequently Asked Questions about improve-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit an existing Claude Code skill for effectiveness gaps?

To audit a Claude Code skill, you can use an effectiveness audit to identify missing functionality, factual drift, and UX friction points by running mental simulations and validating live documentation against the actual skill behavior.

What is the best way to improve code enhancement skills in Claude?

The best way to improve code enhancement skills in Claude is to scan feature adjacency, review UX flows, and test edge cases to generate ranked improvement proposals for new features, accuracy fixes, and efficiency gains.

How do I apply suggested improvements directly to a skill's SKILL.md?

You can apply suggested improvements directly to a skill's SKILL.md by selecting from ranked improvement proposals generated during the audit, which are then automatically implemented into the skill's code and associated resources.

Can I fix a clunky AI tool workflow by testing edge cases in Claude skills?

Yes, you can fix a clunky AI tool workflow by testing edge cases in Claude skills, which identifies friction points and missing functionality so you can automatically apply targeted UX and accuracy improvements.

What tools are required to run a skill improvement audit on Claude Code?

Running a skill improvement audit on Claude Code requires Read, Glob, Edit, Write, WebSearch, WebFetch, Task, and AskUserQuestion tools to analyze code, validate documentation, and apply ranked updates.