CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Trigger: new skills, agent instructions, documenting AI usage patterns. Create LLM-first skills with valid frontmatter.

Quality

84%

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

82%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.

A lean, highly actionable skill body with a clear section contract, decision gates, and a properly structured bundle: the single bundled reference exists, is one level deep, and is well signaled. The main improvements are removing duplication between Hard Rules, Execution Steps, and the fallback rules, and adding an explicit post-creation validation step.

Suggestions

Consolidate the style-guide precedence rule so it appears once (e.g., only in Execution Steps) instead of repeating in both Hard Rules and steps 1-2.

Add a final validation step to the workflow (e.g., verify the generated frontmatter parses as YAML and the body fits the token budget) before reporting output.

Trim the Inline Fallback Rules to only what is not already in references/skill-style-guide.md to reduce duplication with the bundled guide.

DimensionReasoningScore

Conciseness

The body is imperative with no explanations of concepts Claude already knows, but there is noticeable duplication: the style-guide precedence rule appears in both Hard Rules and Execution Steps 1-2, and frontmatter rules repeat between the template and the Inline Fallback Rules. This sits between the 3 anchor ('could be tightened') and 4 anchor ('minor trimming'), landing at 4 since the layering is a deliberate fallback design.

4 / 5

Actionability

Concrete, executable guidance throughout: exact directory template, copy-ready frontmatter shape, required section order, a decision table for content placement, and good/bad description examples. For an instruction-only skill this is fully actionable — the 5 anchor.

5 / 5

Workflow Clarity

Execution Steps 1-7 are clearly sequenced with checkpoints (check guide precedence first; 'Confirm the skill does not already exist and the pattern is reusable'). Not 5 because there is no post-creation validation step such as verifying the generated frontmatter parses or the token budget is met.

4 / 5

Progressive Disclosure

Verified against the actual bundle: references/skill-style-guide.md exists, is one level deep (no nested references inside it), and is clearly signaled with purpose annotations in the References section; the body stays an overview. Not 5 because the Inline Fallback Rules partially duplicate content that lives in the referenced style guide.

4 / 5

Total

17

/

20

Passed

Description

78%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 compact, third-person description that clearly answers both what it does and when to use it, with natural trigger phrases up front. It is thin on specific capabilities and could add synonyms like 'SKILL.md' or 'skill creation' to broaden triggering.

Suggestions

Add one or two more concrete capabilities to the description (e.g., 'with required sections, frontmatter, and references structure') to raise specificity.

Include common trigger synonyms such as 'skill creation', 'SKILL.md', or 'agent guidelines' to improve trigger term coverage.

DimensionReasoningScore

Specificity

"Create LLM-first skills with valid frontmatter" names the domain plus 1-2 concrete actions, but coverage is not comprehensive — no mention of structuring sections, registering skills, or validating the result. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than the 4 anchor, which requires several specific listed actions.

3 / 5

Completeness

Both what ("Create LLM-first skills with valid frontmatter") and when (the explicit "Trigger:" clause with concrete trigger phrases) are clearly answered. The explicit trigger guidance satisfies the 'Use when...' requirement, so this is not capped at 3, and it exceeds the 4 anchor because the when-guidance is explicit rather than merely present.

5 / 5

Trigger Term Quality

"new skills, agent instructions, documenting AI usage patterns" are natural phrases a user would say, giving good keyword coverage. Not 5 because common variations and synonyms are missing (e.g., 'create skill', 'SKILL.md', 'skill template', 'agent guidelines').

4 / 5

Distinctiveness Conflict Risk

"LLM-first skills" is a fairly distinct authoring niche, but "agent instructions" and "documenting AI usage patterns" overlap mildly with general documentation-writing skills. Mostly distinct with minor overlap risk — the 4 anchor.

4 / 5

Total

16

/

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-creator/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.