# Skill Improver

Trigger: improve skills, audit skills, refactor skills, skill quality.

- Repository: https://github.com/Gentleman-Programming/gentle-ai (8170 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -a claude-code -y`
Codex: `npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -a codex -y`
Cursor: `npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -a cursor -y`
Gemini CLI: `npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -a gemini-cli -y`

## Description

Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Activation Contract

Use this skill when asked to audit, refactor, normalize, or improve existing `SKILL.md` files. Use `skill-creator` instead when creating a brand-new skill from a reusable pattern.

## Hard Rules

- Treat `docs/skill-style-guide.md` as the normative style contract when it exists.
- For installed global skills, use `references/skill-style-guide.md` as the bundled local copy when `docs/skill-style-guide.md` is unavailable.
- Treat `SKILL.md` as the source of truth; preserve author intent, critical rules, activation semantics, and output requirements.
- Use `.atl/skill-registry.md` as an index of skill names, triggers, scopes, and exact paths; do not expect generated summaries.
- Default to audit-only. Modify files only when the user explicitly asks to apply improvements.
- Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local `references/` or `assets/`.
- Do not invent triggers, policies, or domain rules. Mark ambiguous cases for human review.

## Decision Gates

| Situation | Action |
| --- | --- |
| Missing or invalid frontmatter | Fix `name`, quoted one-line `description`, `license`, and `metadata` |
| Skill reads like tutorial docs | Convert to runtime instructions and move background to `references/` |
| Body exceeds budget | Preserve rules, move examples/background to supporting files |
| Branching logic hidden in prose | Convert to a compact decision table |
| Rules conflict or intent is unclear | Report the issue; do not rewrite that rule automatically |

## Execution Steps

The rest: https://github.com/Gentleman-Programming/gentle-ai/blob/HEAD/internal/assets/skills/skill-improver/SKILL.md