CtrlK
BlogDocsLog inGet started
Tessl Logo

create-skill

Authoritative guide on how to architect, format, and structure new Anthropic Progressive Disclosure skills. Triggers: Use before creating OR modifying any `.agents/skills/**/*.md` files — Progressive Disclosure architecture (Map vs World Atlas), YAML frontmatter, skill structure. Complementary to `turn-memory-pre-flight` (load-runtime-effect dimension vs skill-shape dimension).

72

Quality

90%

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

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

An exemplary dispatcher SKILL.md: short, executable, and properly offloading detail to a single well-signaled reference. Only minor trim opportunity is the rationale sentence.

DimensionReasoningScore

Conciseness

A lean ~6-line dispatcher with no concept re-explanation; the single justification sentence ('This prevents system prompt bloat and ensures future agents can parse your skill correctly') is minor over-explanation that could be trimmed, holding it at 4 rather than 5.

4 / 5

Actionability

Gives a fully executable directive with a named tool and concrete path ('MUST immediately use the view_file tool to read .../skill-authoring-guide.md before creating any files'); nothing missing for the single action.

5 / 5

Workflow Clarity

Simple single-purpose skill whose one action (read the guide before creating files) is unambiguous; the simple-skill exception applies and no destructive/batch validation is needed.

5 / 5

Progressive Disclosure

Body is a clear overview pointing one level deep to a real, labeled reference (references/skill-authoring-guide.md, confirmed present) and a labeled ADR source; navigation is easy and content is appropriately split out of SKILL.md.

5 / 5

Total

19

/

20

Passed

Description

87%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 well-formed meta-skill description that clearly states purpose, gives explicit triggers, and actively disambiguates from a sibling skill. Slightly more action enumeration and natural synonyms would lift specificity and trigger_term_quality.

DimensionReasoningScore

Specificity

Names the domain ('new Anthropic Progressive Disclosure skills') and several concrete actions ('architect, format, and structure'); not a comprehensive list of authoring actions, so it sits at 4 rather than 5.

4 / 5

Completeness

Explicitly answers both 'what' ('Authoritative guide on how to architect, format, and structure...') and 'when' via a labeled 'Triggers: Use before creating OR modifying...' clause with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural trigger phrases a user would say ('creating OR modifying', 'YAML frontmatter', 'skill structure') plus the glob '.agents/skills/**/*.md'; some common synonyms are absent, capping it at 4.

4 / 5

Distinctiveness Conflict Risk

Narrow niche (authoring skill-shape for .agents/skills) plus an explicit 'Complementary to turn-memory-pre-flight' disambiguation minimizes conflict with the adjacent runtime-memory skill.

5 / 5

Total

18

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
neomjs/neo
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.