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

93%

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 well-built instructional skill: fully executable commands, a complete manifest schema, and an explicit lint-validate-fix feedback loop. The body is close to token-lean, with only a redundant intro line, a duplicated full-schema example, and a slightly confusing private-flag explanation keeping conciseness and progressive_disclosure at 4.

Suggestions

Trim the 'Multiple Skills' section to just the multi-entry skills map instead of reprinting the entire tile.json, or fold it into the main schema example — this is the main conciseness win.

Clarify the private flag guidance: 'Tiles cannot be made private after they are published, so this should be set to false until the user is ready to publish' is internally confusing (false means publicly discoverable); state plainly whether new tiles should default to private: true until publishing is intended.

Consider moving 'Using Tiles' (install/publish) and 'Next Steps' into a short reference file or trimming them, keeping SKILL.md focused on the conversion workflow itself.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of what skills or JSON are, and content is delivered as commands, schemas, and a table. It falls just short of anchor 5 because of minor padding: the opening line 'Wrap standalone skills into Tessl tiles to enable versioning, publishing, and evaluation' restates the description, and the 'Multiple Skills' section reprints an entire second full tile.json when showing only the multi-entry 'skills' map would suffice. It is above anchor 3 ('some unnecessary explanation') since nearly everything present is operational.

4 / 5

Actionability

Every step is copy-paste executable: 'tessl tile new <tile-name>', 'cp -r <skill-folder> <tile-name>/', 'tessl tile lint <tile-name>', a complete tile.json schema, and a lint-error table mapping each error to a concrete fix. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases') — the Common Lint Errors table explicitly covers the common failure cases.

5 / 5

Workflow Clarity

The Quick Start numbers the sequence (create → copy → update manifest → 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 anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery'). The operation is non-destructive, so no batch/destruction cap applies.

5 / 5

Progressive Disclosure

Sections are clear and well-ordered (Prerequisites → Quick Start → Structure → Schema → Troubleshooting → Usage), and nothing is buried or nested — there are no broken or chained references. It does not reach anchor 5, which expects a lean overview with detail split out: the ~110-line body inlines a second full schema example ('Multiple Skills') plus the 'Using Tiles'/'Next Steps' sections, content that could live in a reference file. It is comfortably above anchor 3, since no large block 'should be' elsewhere — the lint table and schema are essential inline content.

4 / 5

Total

18

/

20

Passed

Description

95%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: concrete third-person actions, an explicit and multi-phrase 'Use when' trigger clause, and a distinct niche with essentially no conflict risk. The only soft spot is that the action list is good but not exhaustive, keeping specificity at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists several concrete third-person actions — 'Creates tile manifest, validates directory structure, and ensures skill format compliance' — matching the anchor 'lists several specific actions; minor gaps in coverage'. It does not clearly reach anchor 5's 'comprehensive coverage': the action list omits parts of the workflow covered in the body (e.g., installing/publishing the tile), and 'ensures skill format compliance' is the vaguest of the three actions, so it sits above anchor 3 (only 1-2 actions) but below fully comprehensive.

4 / 5

Completeness

It explicitly answers both what ('Package a standalone skill into a Tessl tile for versioning, distribution, and evaluation' plus three concrete actions) and when ('Use when asked to... or before running evals on a skill not yet in a tile') with concrete trigger phrases, matching anchor 5 exactly. It is not anchor 4, where 'when' is present but less explicit or specific — here the 'when' clause enumerates five distinct trigger conditions.

5 / 5

Trigger Term Quality

The trigger list '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' provides comprehensive synonym coverage (convert/package/wrap/create) plus a proactive usage condition, matching anchor 5's 'comprehensive coverage of natural terms including synonyms'. Anchor 4 requires 'a few natural terms missing', but no common phrasing of this request is obviously absent.

5 / 5

Distinctiveness Conflict Risk

Tessl tile packaging is a clear niche with distinct, product-specific triggers ('tessl tile', 'convert to tile'), giving minimal conflict risk with other skills, matching anchor 5. Unlike anchor 4 ('minor overlap risk with closely related skills'), no plausible sibling skill would trigger on these phrases.

5 / 5

Total

19

/

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

tiles/sdx-commit/.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.