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

85%

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

81%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-structured, highly actionable single-file skill with an exemplary validate→fix→re-lint workflow and error-recovery table. Its one real defect is correctness rather than structure: the `private` field guidance inverts its own logic and could lead a user to publish a tile publicly before they intended, which slightly lowers actionability.

Suggestions

Fix the inverted logic in the `private` field explanation — since tiles cannot be made private after publishing, it should read 'set to `true` until the user is ready to publish' (the current text says `false`).

Trim the opening line 'Wrap standalone skills into Tessl tiles to enable versioning, publishing, and evaluation.' — it duplicates the frontmatter description and adds nothing for the model reading the body.

Consider moving the multiple-skills example and the lint-error fix table into a short reference file as the skill grows, keeping SKILL.md focused on the single-skill quick-start path.

DimensionReasoningScore

Conciseness

The body is lean and dominated by executable code blocks, a schema, and a fix-table — no padding explaining concepts Claude already knows. Minor trimmable instances remain: the opening line ('Wrap standalone skills into Tessl tiles to enable versioning, publishing, and evaluation.') restates the frontmatter description, and the `private` field explanation is wordier than needed. Not 5 due to those minor over-explanations; not 3 because there is no noticeable verbosity or unnecessary explanation.

4 / 5

Actionability

Guidance is mostly copy-paste ready: `tessl tile new`, `cp -r`, `tessl tile lint`, a complete tile.json schema with field definitions, a worked multi-skill example, and an error→cause→fix table. Not 5 because the `private` field guidance is self-contradictory ('Tiles cannot be made private after they are published, so this should be set to `false` until the user is ready to publish' — the logic is inverted: it should stay `true` until the user is ready to publish), a minor gap that could cause a wrong, irreversible action. Not 3 because everything is concrete and executable, not pseudocode or high-level hints.

4 / 5

Workflow Clarity

Quick Start gives a numbered 4-step sequence with an explicit validation checkpoint (`tessl tile lint`) and an explicit feedback loop: 'If lint fails, see [Common Lint Errors](#common-lint-errors) below, fix issues, then re-run lint', backed by a full lint-error fix table. This matches the score-5 anchor (clear sequence, explicit validation, error-recovery loop); the operation is not destructive, so no cap applies.

5 / 5

Progressive Disclosure

A single-file skill (no references/, scripts/, or assets/ exist) that is well organized with clear sections, a working internal anchor link to Common Lint Errors, and appropriately inline schema/examples for its size. Not 5 because at ~110 lines the body exceeds the compact (<50-line) range where one file with no external references is automatically ideal — the multi-skills example and lint-error table are secondary detail that would belong in reference files as the skill grows. Not 3 because nothing is buried and structure is good.

4 / 5

Total

17

/

20

Passed

Description

83%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 capability statements paired with an explicit 'Use when' clause containing natural quoted trigger phrases. The only weaknesses are minor — a slightly generic final capability claim ('ensures skill format compliance') and trigger coverage that misses a few plausible phrasings.

DimensionReasoningScore

Specificity

Names the domain ('Package a standalone skill into a Tessl tile') and lists several concrete actions: 'Creates tile manifest', 'validates directory structure', 'ensures skill format compliance'. Not 5 because 'ensures skill format compliance' is generic and coverage is not comprehensive; not 3 because more than 1-2 concrete actions are named. Third-person voice ('Package', 'Creates') — no voice penalty.

4 / 5

Completeness

Explicitly answers both 'what' (package a skill into a Tessl tile; create manifest; validate structure; ensure format compliance) and 'when' ('Use when asked to "convert to tile", "package this skill", ... or before running evals on a skill not yet in a tile') with concrete trigger phrases — matching the score-5 anchor exactly.

5 / 5

Trigger Term Quality

Good keyword coverage with natural quoted phrases users would say: 'convert to tile', 'package this skill', 'create a tessl tile', 'wrap skill in tile', plus 'before running evals on a skill'. Not 5 because comprehensive synonym coverage is absent (e.g., no 'tessl packaging', 'tile-ify', or similar variations a user might phrase differently).

4 / 5

Distinctiveness Conflict Risk

'Tessl tile' and its triggers occupy a clear niche distinct from other skills. Not 5 because 'package this skill' and the versioning/distribution framing are broadly phrased with minor overlap risk against generic packaging or publishing skills; not 3 since the tessl-specific triggers are unlikely to fire for unrelated skills.

4 / 5

Total

17

/

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

ericjohnolson/tessl-test

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.