Skip to content
Get packs

Skill Improver

Audits existing agent skill files and proposes or applies structural quality fixes.

Source Download skill
Repository
Gentleman-Programming/gentle-ai
Stars
8,181
Licence
MIT
Files
2 files

What it does

When installed, the agent can review other SKILL.md instruction files (the setup docs that teach an AI agent a capability) and check them against a style guide: correct metadata, clear triggers, logical sections, and clean decision tables. By default it only reports issues with proposed changes. It edits files only if you explicitly ask it to apply improvements, and it is designed to keep existing content rather than delete it.

Great for

  • Developers maintaining a library of custom agent skills who want consistent structure
  • Teams standardizing skills across a repository before sharing them
  • People who want a second opinion on why a skill does not trigger reliably

Skip it if

  • Creating a brand-new skill from scratch, since the file says to use skill-creator for that instead
  • Non-technical users with no existing skill files to review, because there is nothing for it to act on
  • Auto-applying changes to important skills without reviewing the audit first, since rewrites can alter author intent even though the rules try to prevent it

Try asking

  • “Audit all my skills in this repo and report issues grouped by severity”
  • “Check whether my deploy-helper SKILL.md has valid frontmatter and a clear trigger description”
  • “Apply the safe fixes from your audit to the skills in the registry, then recommend a registry refresh”
  • “Review my skill's body for content that should move into a references folder”
Step-by-step guide: how to use Skill ImproverInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    skill-improver.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip skill-improver.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip skill-improver.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run it in audit-only mode first and read the report before asking for apply mode
  • Keep a version control commit before applying changes so you can review or revert the edits
  • Point it at a specific skill path rather than the whole library when you only need one result checked

What's inside

  • references/skill-style-guide.md
  • SKILL.md

Redistributed unmodified from Gentleman-Programming/gentle-ai under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.