CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-improver

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

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary LLM-first skill body: compact tables for branching, a tight five-step workflow with fallbacks, a concrete output contract, and a verified one-level-deep local reference. The only real gap is that the apply-mode feedback loop (rerun/validate after edits) is mentioned but not spelled out.

Suggestions

Make the apply-mode validation loop explicit, e.g., 'After edits, rerun the audit on each changed skill and re-check issues until none remain' instead of 'then rerun or request gentle-ai skill-registry refresh'.

Clarify what 'rerun' refers to in step 5 (rerun this audit) so the checkpoint is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean runtime instructions throughout (e.g., 'Default to audit-only', 'Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local references/'), with zero tutorial background and every token earning its place, matching the anchor-5 example of assuming Claude's competence.

5 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact file paths with fallback chains ('Read docs/skill-style-guide.md; if unavailable, read references/skill-style-guide.md; if neither exists, enforce the core LLM-first structure'), enumerated audit criteria, and a concrete command ('gentle-ai skill-registry refresh'); the Decision Gates table and Output Contract give unambiguous instructions for every fork.

5 / 5

Workflow Clarity

The five Execution Steps are clearly sequenced with fallbacks and an output contract, and apply mode ends with a rerun/registry-refresh checkpoint; however, for a batch multi-file editing operation the post-apply validation is terse and partly implicit ('then rerun or request gentle-ai skill-registry refresh' does not specify re-running the audit or a fix-and-revalidate loop), fitting anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Scored against the actual bundle: references/skill-style-guide.md exists, is clearly signaled both in Execution Steps (as the documented fallback) and in the References section with per-file purpose annotations, and is exactly one level deep; the ~45-line body is well organized into the required section order with no content that belongs in a separate file inlined, and docs/skill-style-guide.md / .atl/skill-registry.md are repo-environment files with explicit fallback handling rather than nested references.

5 / 5

Total

19

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, trigger-first description that clearly states what the skill does and when to use it, with natural trigger phrasing. It could be stronger by naming more of the concrete audit/upgrade actions and adding common trigger synonyms to widen keyword coverage.

Suggestions

Expand the 'what' clause with 1-2 more concrete actions, e.g., 'Audit and upgrade existing SKILL.md files: fix frontmatter, tighten triggers, restructure sections to an LLM-first style.'

Add natural trigger synonyms such as 'review skills' or 'fix SKILL.md' to the trigger list to move trigger_term_quality toward comprehensive coverage.

Consider an explicit situational clause ('Use when asked to improve an existing skill') to make the 'when' unambiguous rather than keyword-implied.

DimensionReasoningScore

Specificity

"Audit and upgrade existing LLM-first skills" names the domain plus two concrete actions, matching the 1-2-actions anchor; it stays below anchor 4 because it gives no detail on what the audit or upgrade covers (e.g., frontmatter, triggers, structure).

3 / 5

Completeness

Both what ("Audit and upgrade existing LLM-first skills") and when (explicit "Trigger:" clause with concrete phrases) are present, so the missing-'Use when' cap does not apply; it is not anchor 5 because the when is a bare keyword list rather than an explicit situational clause like "Use when the user asks to improve an existing skill".

4 / 5

Trigger Term Quality

"improve skills, audit skills, refactor skills, skill quality" are natural phrases a user would say, giving good keyword coverage; it falls short of anchor 5 because common variants like "review skills", "fix skills", or the file name "SKILL.md" are absent.

4 / 5

Distinctiveness Conflict Risk

Auditing/upgrading existing skills is a distinct niche with clear triggers, but there is minor overlap risk with a skill-creation skill that the description itself does not disambiguate (only the body does via the skill-creator note), so it fits anchor 4 rather than anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Gentleman-Programming/gentle-ai

Path

internal/assets/skills/skill-improver/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.