CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Creates new AI agent skills following the Agent Skills spec. Trigger: When user asks to create a new skill, add agent instructions, or document patterns for AI.

60

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./curated/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured, genuinely actionable instruction skill whose main flaw is duplication: the entire SKILL.md template is inlined in the body even though it exists as a bundle file in assets/. Removing that duplication would simultaneously improve conciseness and progressive disclosure.

Suggestions

Replace the inlined SKILL.md Template section (lines 44-78) with a short pointer to assets/SKILL-TEMPLATE.md, since the asset already contains a fuller version.

Add an explicit numbered creation workflow with commands (e.g. mkdir -p skills/{skill-name}, write SKILL.md, register in AGENTS.md) ending in a verification step.

Provide at least one real copy-paste command instead of placeholder-only Commands guidance ({Common commands}).

DimensionReasoningScore

Conciseness

The body is mostly efficient — tables, decision trees, and a checklist with no explanations of concepts Claude already knows — but the full SKILL.md template (lines 44-78) is inlined while a near-identical copy exists in assets/SKILL-TEMPLATE.md, a clear tightening opportunity. This fits "mostly efficient but could be tightened" rather than the minor-trim level of 4.

3 / 5

Actionability

Concrete guidance throughout: a naming-conventions table, a frontmatter fields table, copy-paste registration snippet for AGENTS.md, and an explicit decision tree for assets/ vs references/. It falls short of 5 because the skill gives no actual creation commands (e.g. mkdir/scaffold commands) and its own Commands guidance is placeholder-only ({Common commands}).

4 / 5

Workflow Clarity

Sections are logically sequenced (when to create → structure → template → naming → decisions → registration) and the closing "Checklist Before Creating" plus the registration step act as validation checkpoints. Sequence is implied by ordering rather than explicitly enumerated, and no run-validation step exists, so it fits anchor 4 rather than 5; the skill is non-destructive so the workflow cap of 3 does not apply.

4 / 5

Progressive Disclosure

The assets/ link at the end is a real, one-level-deep bundle file (assets/SKILL-TEMPLATE.md exists), but the body inlines the full template that already lives in that separate file — content that should be separate is inline. This matches anchor 3 ("content that should be separate is inline") despite otherwise good structure and signaling.

3 / 5

Total

14

/

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 strong description with explicit what and when clauses in third person and natural trigger phrasing. Its main weakness is specificity — it states a single action rather than enumerating the concrete capabilities involved in skill creation.

Suggestions

Enumerate 2-3 concrete actions, e.g. "Creates new AI agent skills following the Agent Skills spec: scaffolds the skill directory, writes frontmatter and body, and registers the skill in AGENTS.md."

Add natural trigger synonyms such as "build", "make", or "scaffold a skill" to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Creates new AI agent skills following the Agent Skills spec" names the domain and one concrete action, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is above a score of 2 because the domain is precisely named, and below 4 because no further specific actions (scaffolding, frontmatter authoring, registration) are enumerated.

3 / 5

Completeness

The description explicitly answers what ("Creates new AI agent skills following the Agent Skills spec") and when ("Trigger: When user asks to create a new skill, add agent instructions, or document patterns for AI") with concrete trigger phrases. This matches the top anchor; neither what nor when is vague or implied.

5 / 5

Trigger Term Quality

Trigger phrases "create a new skill, add agent instructions, or document patterns" are natural things a user would say, giving good keyword coverage. It falls short of 5 because common variations and synonyms like "build a skill", "scaffold", "make a skill", or "SKILL.md" are missing.

4 / 5

Distinctiveness Conflict Risk

Skill authoring per the Agent Skills spec is a clear niche with distinct triggers, but "document patterns for AI" is broad enough to risk overlap with general documentation-writing skills. Mostly distinct with minor overlap risk fits anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

relative_links

Relative link issues: 2 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

Gentleman-Programming/Gentleman-Skills

Path

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