Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@Claudest
Open on GitHub

What 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.md for missing features and UX friction
  • Audit my skill in ~/.claude/skills/db-migrate and find logic gaps

How to install improve-skill

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@Claudest

This installs the whole claude-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill improve-skill -a claude-code

3Manually: put the files in place

~/.claude/skills/improve-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/improve-skill/

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.

improve-skill official OpenAI Codex improve-skill converts plugin-eval test reports into a concrete rewrite brief for Codex skills. Useful when you need to trim token costs and clean up frontmatter. CX Codex GP ChatGPT +1 1installs improve shadcn improve surveys any codebase in read-only mode and writes self-contained implementation plans for other models to execute. Helps audit bugs, tech debt, and security without touching code. CX Codex +1 42,400installs improve-react millionco improve-react audits an entire React codebase with React Doctor and drafts self-contained implementation plans for other agents. Operates in read-only mode. CX Codex +1 2,900installs improve-code-quality wondelai improve-code-quality — a skill for Claude Code and Codex guides untested code toward production stability. It runs an interactive nine-phase workflow and records every milestone in local markdown files. CX Codex +1 2,700installs improve-architecture daveebbelaar The improve-architecture Claude Code skill reviews a macOS Swift codebase and plans refactors that preserve existing behavior. It activates before a major feature, at a milestone, or when bugs keep returning in one area. CX Codex +1 1,000installs improve-ui ibelick improve-ui — a Claude Code skill that checks an interface against its own design rules and reports verified mismatches. It never touches product code; it writes fix plans for another agent. CX Codex +1 10,400installs TDD Refactor Phase - Improve Quality & Security official github TDD Refactor Phase - Improve Quality & Security is a GitHub Copilot subagent that refines code after tests pass and checks it against a GitHub issue. It asks for plan approval before editing. CX Codex +1 ★ 41,430repo stars

From the same set47

The whole set →
brainstorm brainstorm — an interview skill that turns the tables: the agent asks, you answer, and the session ends with a written spec or decision doc. CX Codex +1 ★ 276repo stars get-token-insights get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows. CX Codex +1 ★ 276repo stars extract-frames extract-frames detects shot boundaries in a video and saves the first or last frame of each shot. Use it to review an edit or collect frames from selected shots. CX Codex +1 ★ 276repo stars search-youtube search-youtube finds YouTube videos, pulls transcripts and metadata, downloads audio and walks a channel's uploads through a single CLI the agent calls on its own. CX Codex +1 ★ 276repo stars performance-auditor The performance-auditor subagent inspects code for algorithmic, data-access, and resource bottlenecks. Use it after changes on hot paths or when you need to reason about how code scales. CX Codex ★ 276repo stars test-engineer test-engineer generates tests for critical business logic right after a feature or bug fix, skipping tests written purely to inflate coverage numbers. CX Codex ★ 276repo stars claude-memory-architecture claude-memory-architecture defines the technical architecture for the claude-memory plugin, detailing hook lifecycles, SQLite database operations, lock handling, and local vector indexing. CX Codex +1 ★ 276repo stars extract-learnings extract-learnings is a Claude Code skill that saves project knowledge and keeps memory notes organized. Record a finding or consolidate existing notes. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open