CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

83

1.90x
Quality

81%

Does it follow best practices?

Impact

95%

1.90x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body excels at workflow sequencing and actionability — the eval/iterate loop is concrete, well-checkpointed, and adaptable across environments (Claude Code, Claude.ai, Cowork). Its weaknesses are token efficiency (chatty asides and triple-stated core loop) and bundle integrity: several referenced files (agents/*.md, eval-viewer/generate_review.py) don't exist, and the body is at the edge of its own length guideline.

Suggestions

Trim conversational asides ('Cool? Cool.', the non-coder-user anecdote, 'billions a year in economic value') and consolidate the core loop, which is currently stated three times (intro, closing summary, Cowork reiteration), into one authoritative statement plus one cross-reference.

Fix the dead references: either ship agents/grader.md, agents/comparator.md, agents/analyzer.md, and eval-viewer/generate_review.py in the bundle, or rewrite those steps to be self-contained — as written, the grading and viewer commands fail with file-not-found.

Move the Description Optimization section (trigger eval generation, review flow, run_loop details) into a references/ file with a short pointer from the main body, bringing SKILL.md comfortably under the 500-line guidance it itself prescribes.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful operational detail, but includes unnecessary padding: conversational asides ('Cool? Cool.', the plumber/grandparent anecdote, 'we are trying to create billions a year in economic value here!') and the core loop being repeated three times (intro, closing 'Repeating one more time' summary, and the Cowork all-caps reiteration). This fits 'mostly efficient but includes some unnecessary explanation' rather than the noticeably padded anchor 2.

3 / 5

Actionability

Guidance is highly concrete — full command lines ('python -m scripts.aggregate_benchmark', 'python -m scripts.run_loop' with flags, the nohup viewer launch), JSON templates, subagent prompt templates, and exact directory layouts. However, commands reference '<skill-creator-path>/eval-viewer/generate_review.py' and 'agents/grader.md' which are not present in the bundle, so those steps would fail as written — a minor gap that keeps it below fully executable anchor 5.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: the 5-step eval sequence ('don't stop partway through'), grade → aggregate → analyst pass → viewer → user feedback, timing capture per notification, explicit termination criteria, and the numbered iteration loop with recovery guidance. This matches the anchor for clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

References are clearly signaled with when-to-read guidance ('See `references/schemas.md` for the full schema', the Reference files section), and references/schemas.md and assets/eval_review.html do exist. But agents/grader.md, agents/comparator.md, agents/analyzer.md, and eval-viewer/generate_review.py are referenced yet absent from the bundle (dead pointers), and the ~479-line body sits at its own 500-line cap with the Description Optimization workflow being a clear candidate for a reference file. Some structure, but organization gaps and broken references hold it below anchor 4.

3 / 5

Total

15

/

20

Passed

Description

83%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 that follows best practice: concrete action verbs, an explicit 'Use when' trigger clause with multiple realistic user phrasings, and a well-delineated niche. Only minor polish is needed — one generic capability phrase and a few missing natural synonyms keep it from full marks.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('Create new skills, modify and improve existing skills, and measure skill performance', 'run evals', 'benchmark skill performance with variance analysis', 'optimize a skill's description for better triggering accuracy') with only minor gaps — 'measure skill performance' is somewhat generic, keeping it below the comprehensive anchor 5.

4 / 5

Completeness

It explicitly answers both 'what' (first sentence enumerates concrete capabilities) and 'when' via a concrete 'Use when users want to...' clause listing multiple trigger conditions, matching the anchor-5 pattern of clear what-and-when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user phrasings are present ('create a skill from scratch', 'update or optimize an existing skill', 'run evals', 'benchmark skill performance'), giving good keyword coverage; a few natural synonyms are missing ('make a skill', 'test my skill'), so it is not the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Skill creation is a clear niche with distinct triggers, but generic phrases like 'measure skill performance' and 'run evals' create minor overlap risk with testing/evaluation skills, placing it just below the minimal-conflict anchor 5.

4 / 5

Total

17

/

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

SnowingFox/macos-island

Path

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