CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-template

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

53

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured template skeleton with strong progressive disclosure and a clear section flow, but as a skill body it is almost entirely unfilled placeholders, so it offers little actionable or executable guidance and no validation checkpoints. Its value is structural guidance rather than operational instruction.

Suggestions

Fill at least one section end-to-end with a concrete worked example (e.g., a complete sample 'When to Activate' block) so the template demonstrates actionability rather than only describing it.

Add a lightweight validation step for authors, such as a checklist to verify the description answers both 'what' and 'when' and that referenced files exist, to lift workflow clarity.

Trim editorial meta-commentary (e.g., 'Challenge each piece of information', repeated 'High/Medium/Low freedom' framing) to tighten conciseness without losing the structural guidance.

DimensionReasoningScore

Conciseness

The body is largely instruction-for-authors rather than filler about concepts Claude knows, but it carries repeated meta-commentary and placeholder guidance that a real skill would trim; several sections justify themselves editorially rather than earning every token.

2 / 3

Actionability

Almost every section is placeholder direction ('Provide a clear, concise description...', 'List specific guidelines...') with no concrete code, commands, or filled examples, so it describes rather than instructs and is not copy-paste ready.

1 / 3

Workflow Clarity

Sections are sequenced into a recognizable authoring flow, but there are no concrete validation checkpoints or feedback loops for the skill-building task itself; it tells the author what to include without verifying correctness.

2 / 3

Progressive Disclosure

The body is an overview that explicitly signals two real one-level-deep references (./references/topic-details.md and ./references/reference-file.md), both of which exist in the bundle, and keeps detail out of the main file.

3 / 3

Total

8

/

12

Passed

Description

75%

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 cleanly answers both what and when with an explicit 'Use...when' clause and a distinct niche, but its action list and natural trigger-term coverage are thinner than top-tier examples. Strengthening specificity and trigger breadth would raise it to the highest level.

Suggestions

Expand the action list beyond 'adding' to concrete authoring verbs, e.g. 'Template for creating, structuring, and reviewing new Agent Skills for context engineering.'

Add the natural trigger terms users would actually type, such as 'skill template', 'authoring skills', or 'context engineering skill', to broaden discovery.

DimensionReasoningScore

Specificity

It names the domain ('creating new Agent Skills for context engineering') and one concrete action ('adding new skills'), but does not list multiple specific actions like a template with section-by-section guidance would warrant.

2 / 3

Completeness

It answers 'what' ('Template for creating new Agent Skills') and 'when' explicitly ('Use this template when adding new skills to the collection'), satisfying both halves with an explicit trigger clause.

3 / 3

Trigger Term Quality

'adding new skills' is a relevant natural phrase, but coverage is thin — common variations like 'skill template', 'authoring skills', or 'context engineering skill' that a user would actually say are largely missing.

2 / 3

Distinctiveness Conflict Risk

The niche is clearly bounded to skill authoring for context engineering and unlikely to overlap with task-specific skills, which have their own concrete triggers.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.