CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-skill

Use when creating a new skill, writing a skill from scratch, or converting a process into a reusable skill — enforces TDD, empirical validation, and quality monitoring

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 dense, highly actionable process skill: an explicit flowchart with mandatory gates, feedback loops for every failure path, and copy-paste-ready commands for each validation step. Its only real cost is redundancy — the same enforcement rules (eval mandatory, frontmatter hazard) are restated in multiple sections, though largely as deliberate anti-rationalization reinforcement.

DimensionReasoningScore

Conciseness

Dense and imperative throughout — no explaining of concepts Claude already knows, every section instructs rather than describes. Not 5: the eval-never-deferred rule and the unquoted-colon frontmatter hazard are each restated across Process, Step Details, Quality Gates, and the Rationalizations table, and the dated anecdote ("real case 2026-07-14") adds tokens that could be trimmed; not 3: the duplication is minor in volume and mostly deliberate anti-bypass reinforcement rather than padding.

4 / 5

Actionability

Fully executable guidance: copy-paste commands including the ruby YAML validation one-liner, `tessl review run --threshold 85`, `tessl workspace list`, and the complete devflow feeder bash block; exact search locations (~/.claude/skills/, superpowers:*, devflow:*), verbatim interview questions, and a concrete SKILL.md structure checklist. Not 4: the common cases are covered with commands ready to run as-is; gaps are negligible.

5 / 5

Workflow Clarity

The mermaid flowchart gives an explicit end-to-end sequence with decision branches and feedback loops — REFACTOR loops back to GREEN verify, optimize-skill loops back to eval, and the frontmatter is validated before scoring; Step 10 enforces "re-run until passing" and Quality Gates tabulate every checkpoint. Not 4: checkpoints are explicit validation steps with error-recovery paths, not merely present.

5 / 5

Progressive Disclosure

Section headers mirror the flowchart and external references are clearly signaled (superpowers:writing-skills for structure, lib/determinism/CONTRACT.md and the determinism-fix lib index for the determinism pass). Not 5: no one-level-deep bundle structure exists (references/, scripts/, assets/ are absent) and operational scripts — the step-12 feeder bash block and the YAML validation one-liner — are inlined where scripts/ files would fit; not 3: organization is strong and navigation is easy.

4 / 5

Total

18

/

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 with an explicit 'Use when' clause covering three distinct invocation phrasings plus a stated capability set. Its weakest point is that the 'what' half describes process qualities (TDD, validation, monitoring) rather than the concrete workflow or deliverable the skill produces.

Suggestions

Make the 'what' concrete: replace or augment "enforces TDD, empirical validation, and quality monitoring" with what the skill actually does, e.g. "Runs an interview, duplicate-discovery, baseline-failure testing, minimal SKILL.md writing, and a Tessl-scored validation loop".

Add natural trigger synonyms users might say: "build a skill", "make a skill", "turn this process into a skill".

DimensionReasoningScore

Specificity

Names several specific actions and domain anchors — "creating a new skill", "writing a skill from scratch", "converting a process into a reusable skill", "enforces TDD, empirical validation, and quality monitoring" — with only minor gaps. Not 3: coverage clearly exceeds 1-2 generic actions; not 5: the capability half stays process-level ("quality monitoring" is generic) and never surfaces the actual workflow (interview, baseline testing, eval gate).

4 / 5

Completeness

Explicitly answers both halves: the 'what' ("enforces TDD, empirical validation, and quality monitoring") and a fully explicit 'when' with three concrete trigger phrases ("Use when creating a new skill, writing a skill from scratch, or converting a process into a reusable skill"). Not 4: the anchor-4 caveat ('when' could be more explicit or specific) does not apply — the trigger clause is already maximally explicit.

5 / 5

Trigger Term Quality

Contains natural phrases users would actually say — "creating a new skill", "writing a skill from scratch", "converting a process into a reusable skill". Not 5: common variations like "build a skill", "make a skill", or "turn this process into a skill" are only partially covered; not 3: keyword coverage is well beyond 'some relevant keywords with missing synonyms'.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (authoring new skills) with distinct creation-oriented triggers, so it would not fire for ordinary skill usage. Not 5: minor overlap risk with closely related meta-skills (the body itself references superpowers:writing-skills, determinize-skill, optimize-skill), which share the 'skill' keyword space; not 3: triggers are far more specific than 'somewhat specific'.

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

AndreJorgeLopes/proof-of-skill

Path

skills/create-skill/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.