skill-template

tessl i github:muratcankoylan/Agent-Skills-for-Context-Engineering --skill skill-template

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

53%

Overall

Validation — 81%

Implementation — 28%

Activation — 67%

SKILL.md

Review

Evals

Validation

81%

Warnings & errors only

Criteria	Description	Result
description_trigger_hint	Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...')	Warning
metadata_version	'metadata' field is not a dictionary	Warning
license_field	'license' field is missing	Warning

	Total	13 / 16 Passed

Implementation

28%

This is a meta-template for creating skills rather than an actual skill with actionable content. While it demonstrates good structural principles for progressive disclosure and organization, it fails on conciseness (too much explanatory meta-commentary) and actionability (all placeholder content, no executable guidance). As a template, it serves its purpose but would score poorly as an actual skill.

Suggestions

If this is meant to be a skill about creating skills, replace placeholder sections with concrete examples of good vs bad skill content

Remove explanatory meta-commentary (e.g., 'Default assumption: Claude is already very smart') and instead demonstrate these principles through actual examples

Add executable code or commands showing how to create, validate, or test a skill file

Convert the abstract guidelines into a concrete checklist with specific, verifiable criteria

Dimension	Reasoning	Score
Conciseness	This is a meta-template with extensive explanatory text about how to write skills, not an actual skill. It explains concepts Claude already knows (like 'keep files under 500 lines', 'write in third person') and includes verbose instructional commentary that wouldn't be needed in a real skill.	1 / 3
Actionability	The content is entirely placeholder text with no concrete, executable guidance. Sections like 'Topic 1', 'Guideline one with specific, verifiable criteria' are abstract descriptions rather than actionable instructions. No real code or commands are provided.	1 / 3
Workflow Clarity	The template does provide a clear structure/sequence for organizing skill content (When to Activate → Core Concepts → Topics → Examples → Guidelines), but as a template it lacks actual workflow steps or validation checkpoints for any real task.	2 / 3
Progressive Disclosure	The template demonstrates good progressive disclosure principles: it shows how to structure an overview with references to external files (references/ directory), uses clear section organization, and explicitly guides toward splitting detailed content into separate files.	3 / 3
	Total	7 / 12 Passed

Activation

67%

The description adequately covers the what and when, earning full marks for completeness. However, it lacks specificity about what the template actually contains or produces, and uses somewhat technical language ('context engineering') that users may not naturally use. The description would benefit from more concrete actions and natural trigger terms.

Suggestions

Add specific actions the template enables, e.g., 'Provides YAML frontmatter structure, description guidelines, and content sections for creating new Agent Skills'

Include more natural trigger terms users would say, such as 'SKILL.md', 'skill file', 'new skill', 'write a skill', or 'skill format'

Dimension	Reasoning	Score
Specificity	Names the domain ('Agent Skills for context engineering') and one action ('creating new'), but lacks concrete details about what the template contains or what specific actions it enables.	2 / 3
Completeness	Explicitly answers both what ('Template for creating new Agent Skills') and when ('Use this template when adding new skills to the collection') with clear trigger guidance.	3 / 3
Trigger Term Quality	Includes some relevant terms ('template', 'new skills', 'adding new skills') but 'context engineering' is technical jargon and misses natural variations users might say like 'skill file', 'SKILL.md', or 'write a skill'.	2 / 3
Distinctiveness Conflict Risk	Somewhat specific to skill creation but could overlap with other template-related skills or documentation skills; 'Agent Skills' helps distinguish but the scope remains somewhat broad.	2 / 3
	Total	9 / 12 Passed

Reviewed

17 days ago

Table of Contents

Validation Implementation Activation

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.