CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

writing-great-skills

Reference for writing and editing skills well: the principles that make a skill predictable.

55

Quality

69%

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 ./ywai/skills/writing-great-skills/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 tight, well-crafted reference body: lean prose, concrete mechanics and decision rules, and correct use of a one-level-deep split to references/craft.md. Its one real defect is a dangling pointer — the glossary that the body instructs the reader to consult for every bold term is missing from the bundle.

Suggestions

Resolve the GLOSSARY.md dangling link: either ship the glossary file defining the bold terms, or retarget the bold-term pointer to references/craft.md (which already defines most of them) so the body's navigation promise holds.

If adding the glossary, keep it one level deep and co-located with the craft reference rather than nesting further, preserving the current clean disclosure structure.

DimensionReasoningScore

Conciseness

The body is dense with no padding and explains nothing Claude already knows — every section carries non-default guidance, tests, or cures. It falls short of 5 because of minor restatements, e.g. "Pick model-invocation only when the agent must reach the skill on its own, or another skill must" re-summarizes the two invocation bullets above it.

4 / 5

Actionability

Concrete, executable guidance throughout: exact frontmatter mechanics ("set `disable-model-invocation: true`"), decision rules, an ordered defense ladder ("sharpen the completion criterion first; only if it is irreducibly fuzzy... split"), and a runnable no-op test ("does it change behaviour versus the default?"). Minor gaps only — no worked example of a good description in the body.

4 / 5

Workflow Clarity

This is a reference skill (no multi-step process, no destructive or batch operations, so no validation cap applies), and its consult-on-demand structure is clear: each section's purpose is stated, and read-ordering is explicit ("Read it before restructuring a skill"). Below 5 because the skill serves several distinct uses (choose invocation, write description, edit body, diagnose) without ordering the diagnosis path across the five failure modes.

4 / 5

Progressive Disclosure

The structure is right — a compact overview with one-level-deep, clearly signaled pointers (references/craft.md exists and matches its billing) — but the body's primary lookup promise is broken: "**Bold terms** are defined in [GLOSSARY.md](GLOSSARY.md)" points to a file that does not exist in the bundle, so the advertised navigation path for the defined vocabulary fails.

3 / 5

Total

15

/

20

Passed

Description

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

The description states clearly what the skill is, in a distinct niche, but reads as a human-facing one-line summary rather than a triggering description: it has no "when to use" guidance and no natural trigger phrasing. (The skill sets disable-model-invocation: true, so this is by design — but judged against the rubric as written, the missing trigger content caps three of four dimensions.)

Suggestions

Add an explicit trigger clause naming natural terms users actually say, e.g. "Use when writing or editing a SKILL.md, its description, or its frontmatter" — this would lift both completeness and trigger_term_quality.

Name one or two concrete capabilities beyond the domain, e.g. "...including choosing invocation mode, writing trigger descriptions, and diagnosing failure modes like sprawl and duplication" to raise specificity.

If the skill stays user-invoked, note the leading terms (SKILL.md, skill description) so a router skill can still reach it reliably.

DimensionReasoningScore

Specificity

The description names a concrete domain ("writing and editing skills") and its content focus ("the principles that make a skill predictable"), but lists no enumerable actions. It fits anchor 3 (domain plus 1-2 actions, not comprehensive) rather than 4, which requires several specific actions; it is above 2 because the domain is specific rather than generic.

3 / 5

Completeness

The "what" is clear (a reference on principles for writing/editing skills predictably), but the "when" is entirely missing — there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. This is exactly anchor 3: clear what, missing when.

3 / 5

Trigger Term Quality

Some natural keywords users would say are present ("writing", "editing", "skills"), but there is no trigger phrasing at all and common variations are missing ("SKILL.md", "skill description", "frontmatter", "authoring"). This matches anchor 3: relevant keywords present, synonyms and variations absent.

3 / 5

Distinctiveness Conflict Risk

Skill authoring is a distinct niche ("writing and editing skills"), so conflict risk with unrelated skills is low — fitting anchor 4. It falls short of anchor 5 because there are no explicit distinct trigger phrases to seal the niche, and a closely related skill-editing skill could still overlap.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

YoizenSA/dev-ai-workflow

Path

ywai/skills/writing-great-skills/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.