CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

converting-skill-to-tessl-tile

Package a standalone skill into a Tessl tile for versioning, distribution, and evaluation. Creates tile manifest, validates directory structure, and ensures skill format compliance. Use when asked to "convert to tile", "package this skill", "create a tessl tile", "wrap skill in tile", or before running evals on a skill not yet in a tile.

Quality

92%

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

88%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 strong, highly actionable body: copy-paste CLI commands, a complete tile.json schema with two examples, and a validation feedback loop in the main workflow. Deductions are minor — a redundant intro line, a convoluted private-field note, and all content inlined with no progressive-disclosure layering.

DimensionReasoningScore

Conciseness

Mostly lean (commands, schema, tables) with no over-explanation of concepts Claude already knows, but the intro 'Wrap standalone skills into Tessl tiles to enable versioning, publishing, and evaluation' duplicates the frontmatter description and the 'private' field note ('Tiles cannot be made private after they are published, so this should be set to false until the user is ready to publish') is convoluted and could be trimmed. Not a 5 because these tokens don't earn their place; not a 3 because there is no real padding or unnecessary explanation.

4 / 5

Actionability

Fully executable guidance throughout: 'tessl tile new <tile-name>', 'cp -r <skill-folder> <tile-name>/', 'tessl tile lint <tile-name>', a complete tile.json schema with both a minimal and a multi-skill example, and a lint error table mapping each error to a specific fix. Copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

The Quick Start is a numbered 4-step sequence (create tile, copy skill, update tile.json, validate) with an explicit validation checkpoint ('tessl tile lint') and a feedback loop: 'If lint fails, see Common Lint Errors below, fix issues, then re-run lint.' This matches the anchor for clear sequence with explicit validation and error-recovery loops; validation is present so no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Good structure: well-organized sections with headers, a directory-structure diagram, and a working internal anchor link ('[Common Lint Errors](#common-lint-errors)'). However, the body is ~110 lines with everything inlined and no bundle files — the lint error table and the Multiple Skills example are borderline reference material — and the under-50-line simple-skill exception does not apply. Not a 3 because no section clearly demands a separate file at this size.

4 / 5

Total

18

/

20

Passed

Description

91%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 strong description that explicitly states both what the skill does and when to use it, backed by five concrete quoted trigger phrases. Only minor blemishes: the generic action phrase 'ensures skill format compliance' and the one ambiguous trigger 'package this skill'.

DimensionReasoningScore

Specificity

Lists several specific actions — 'Creates tile manifest, validates directory structure, and ensures skill format compliance' — but 'ensures skill format compliance' is generic compared to the other concrete verbs, leaving a minor coverage gap. Not a 5 because coverage isn't fully comprehensive; not a 3 because it names multiple concrete actions, not just 1-2.

4 / 5

Completeness

Clearly answers both what ('Package a standalone skill into a Tessl tile... Creates tile manifest, validates directory structure') and when ('Use when asked to...') with concrete quoted trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases with synonyms: 'convert to tile', 'package this skill', 'create a tessl tile', 'wrap skill in tile', plus the proactive condition 'before running evals on a skill not yet in a tile.' These are exactly the phrasings a user would naturally say for this task.

5 / 5

Distinctiveness Conflict Risk

A clear niche (Tessl tiles) with distinct triggers like 'create a tessl tile' and 'wrap skill in tile', but 'package this skill' is generic enough to fire on non-Tessl packaging requests — minor overlap risk. Not a 5 because that one trigger isn't niche-specific; not a 3 because the domain and remaining triggers are highly specific.

4 / 5

Total

18

/

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

xomyakus/spec-native-skills

Path

.tessl/tiles/tessl-labs/tessl-skill-eval-scenarios/converting-skill-to-tessl-tile/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.