skill-improver

Agent Skills › Gentleman-Programming/gentle-ai › skill-improver

skill-improver

GitHub

用于审计、重构和规范现有SKILL.md文件的技能，确保符合LLM-first风格指南。默认仅审查，仅在明确要求时修改，保留作者意图并优化结构。

internal/assets/skills/skill-improver/SKILL.md Gentleman-Programming/gentle-ai

Trigger Scenarios

审计现有技能文件重构技能格式规范化技能描述提升技能质量

Install

npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -y

More Options

Non-standard path

npx skills add https://github.com/Gentleman-Programming/gentle-ai/tree/main/internal/assets/skills/skill-improver -g -y

Use without installing

npx skills use Gentleman-Programming/gentle-ai@skill-improver

指定 Agent (Claude Code)

npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -a claude-code -g -y

安装 repo 全部 skill

npx skills add Gentleman-Programming/gentle-ai --all -g -y

预览 repo 内 skill

npx skills add Gentleman-Programming/gentle-ai --list

SKILL.md

Frontmatter

{
    "name": "skill-improver",
    "license": "Apache-2.0",
    "metadata": {
        "author": "gentleman-programming",
        "version": "1.0"
    },
    "description": "Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills."
}

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

Read docs/skill-style-guide.md; if unavailable, read references/skill-style-guide.md; if neither exists, enforce the core LLM-first structure: frontmatter, Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References.
Read .atl/skill-registry.md; use listed paths to select skills. If missing, scan known skill directories for */SKILL.md.
For each selected skill, audit metadata, trigger clarity, section order, body budget, actionability, decision gates, output contract, and local references.
Return an audit report grouped by skill with severity and exact proposed changes.
In apply mode, edit only safe issues, preserve content, create supporting files when needed, then rerun or request gentle-ai skill-registry refresh.

Output Contract

Return:

Skills audited and paths used.
Issues found, grouped by severity.
Files changed, if apply mode was requested.
Registry refresh recommendation when skill metadata or paths changed.
Ambiguities that need human review.

References

docs/skill-style-guide.md — normative LLM-first skill style guide for this repo.
references/skill-style-guide.md — bundled local copy for installed global skills when the repo doc is unavailable.