CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-template

Template for creating new Agent Skills for context engineering. Use this template when adding new skills to the collection.

Quality

72%

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 ./template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 is a well-structured, token-efficient authoring template with concrete rules, formats, and real one-level-deep reference files. Its main weakness is the absence of explicit validation checkpoints for the authoring workflow it implicitly sequences, plus placeholder scaffolding in the Examples and Guidelines sections.

Suggestions

Add an explicit validation checklist at the end of the authoring sequence: description in third person, body under 500 lines, all referenced files exist, claims backed by registry IDs.

Replace placeholder scaffolding in Examples and Guidelines ("Guideline one with specific, verifiable criteria", "[describe input]") with one complete filled-in exemplar so authors have a concrete model.

Make the reference map explicit — label the references/ links as this skill's own supporting files rather than showing them only as template placeholders.

DimensionReasoningScore

Conciseness

The ~110-line body is efficient for its purpose: each section carries a rule or format ("Keep the total SKILL.md body under 500 lines", "Write in third person", numbered gotcha format), with a concrete good/avoid example pair rather than generic explanation. Minor over-explanation remains (ownership-boundary guidance repeated in the intro and When to Activate; the placeholder prose in Detailed Topics adds little), so it fits anchor 4 ('efficient; minor instances that could be trimmed') rather than the fully lean anchor 5, and is well above the padded anchor 3.

4 / 5

Actionability

The body gives mostly executable guidance for a skill author: a 500-line budget, third-person rule with a good/avoid example ("Processes Excel files" vs "I can help you"), a three-level freedom framework for matching specificity to fragility, required gotcha format, plain-text related-skill lists, and a rule that claims need inline `claim-*` IDs backed by `researcher/claims/index.jsonl`. The gaps are placeholder scaffolding ("Guideline one with specific, verifiable criteria", the `[describe input]` example block), so it fits anchor 4 ('mostly executable guidance with minor gaps') — not 5 because no example is complete and copy-paste ready, not 3 because the concrete rules dominate over pseudocode.

4 / 5

Workflow Clarity

The section order (When to Activate → Core Concepts → Detailed Topics → Practical Guidance → Examples → Guidelines → Gotchas → Integration → References → Metadata) provides an implicit authoring sequence, but there are no validation checkpoints (e.g., 'verify description is third person', 'confirm body is under 500 lines', 'check all referenced files exist') — matching anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit'). Not a 4 because no checkpoint is made explicit anywhere, and not a 2 because the structural sequence is coherent rather than gapped. The skill is not destructive/batch, so the cap-at-3 rule for missing validation is not additionally triggered.

3 / 5

Progressive Disclosure

The body is well structured at ~110 lines, points to real one-level-deep bundle files ("See [detailed reference](./references/topic-details.md)" and "[Reference Name](./references/reference-file.md)" — both exist in references/), and instructs moving long material out of SKILL.md. It fits anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps') rather than 5 because reference links are shown as template placeholders within section examples rather than clearly signaled as this skill's own reference map, leaving navigation slightly ambiguous.

4 / 5

Total

15

/

20

Passed

Description

62%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 answers both what and when in third person with a clear niche, but is thin: one trigger situation, no synonyms or natural phrasing variations, and only a single concrete action. It is serviceable but would benefit from broader trigger coverage.

Suggestions

Add concrete actions beyond 'creating' — e.g., scaffolding SKILL.md structure, writing descriptions and frontmatter, organizing references/ files — to lift specificity.

Broaden trigger terms with natural user phrasings and synonyms: 'write a new skill', 'author a skill', 'SKILL.md template', 'skill structure'.

Extend the 'when' clause beyond 'adding new skills to the collection' to cover related situations such as updating or restructuring an existing skill.

DimensionReasoningScore

Specificity

"Template for creating new Agent Skills for context engineering" names the domain and one concrete action (creating new Agent Skills), but lists no further specific actions (scaffolding, frontmatter, description writing), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. Not a 4 because there are not 'several specific actions', and not a 2 because the action named is concrete rather than generic.

3 / 5

Completeness

Both parts are present: what — "Template for creating new Agent Skills for context engineering"; when — "Use this template when adding new skills to the collection". This matches anchor 4 ('has both what and when; when could be more explicit or specific') because the trigger clause covers only one situation and lacks concrete trigger phrases, so it is not a 5; it is clearly above anchor 3 where 'when' is missing or only weakly implied.

4 / 5

Trigger Term Quality

Relevant keywords like "creating new Agent Skills", "adding new skills to the collection", and "context engineering" are present, but common natural variations users would say — "write a skill", "SKILL.md", "skill authoring", "new skill" — are missing. Fits anchor 3 ('some relevant keywords but missing common variations or synonyms'), not 4 since coverage is thin rather than merely missing 'a few natural terms'.

3 / 5

Distinctiveness Conflict Risk

The niche is distinct — a template for authoring Agent Skills, with terms like "template" and "adding new skills to the collection" unlikely to fire for unrelated skills. Minor overlap risk remains with adjacent skill-authoring/reviewing skills that share terms like "Agent Skills" and "context engineering", so it fits 'mostly distinct; minor overlap risk with closely related skills' rather than the fully-distinct anchor 5.

4 / 5

Total

14

/

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

muratcankoylan/Agent-Skills-for-Context-Engineering

Path

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