sharaf/migrate-to-tessl
Use when migrating, restructuring, publishing, or auditing an existing Claude skill into a Tessl tile; converting flat .md files or SKILL.md bundles; fixing Tessl Quality, Impact, Uplift, frontmatter, metadata, tile.json summary, README, markdown reference links, registry-vs-local Quality gaps, artifact anchors, auto-eval wait discipline, or pushing tile scores from 88-99% to 100%.
100
100%
Does it follow best practices?
Impact
100%
1.11xAverage score across 4 eval scenarios
Advisory
Suggest reviewing before use
prerequisite-skills.mdskills/migrate-to-tessl/references/
Prerequisite Skills
Before invoking migrate-to-tessl, the agent's environment must have the Tessl CLI and a specific set of Tessl skills available. Check each one; if missing, stop and give the user the install command.
CLI prerequisites
| Tool | Check | If missing |
|---|---|---|
tessl CLI | tessl --version | Direct user to https://tessl.io/docs/install and stop |
| Tessl login | tessl whoami (must return user + email) | Tell user to run tessl login and stop |
Network access to tessl.io | Implicit in CLI checks | Surface the underlying error |
Required Tessl skills
These show up in the agent's system reminder skill list. Cross-reference the names below against that list before starting. If any are missing, output the corresponding install command for the user and stop.
| Skill identifier | Source tile | Install command |
|---|---|---|
tessl__tile-creator | tessl-labs/tile-creator | tessl install tessl-labs/tile-creator |
tessl__setup-skill-performance | tessl/skill-optimizer | tessl install tessl/skill-optimizer |
tessl__optimize-skill-performance | tessl/skill-optimizer | (installed with above) |
tessl__optimize-skill-instructions | tessl/skill-optimizer | (installed with above) |
tessl__optimize-skill-performance-and-instructions | tessl/skill-optimizer | (installed with above) |
tessl__compare-skill-model-performance | tessl/skill-optimizer | (installed with above) |
tessl__skill-creator (optional, for greenfield skill work) | tessl/skill-optimizer | (installed with above) |
Most of these ship together inside tessl/skill-optimizer. So in practice, two installs cover the prerequisites:
tessl install tessl-labs/tile-creator
tessl install tessl/skill-optimizerStop pattern — exact wording to give the user
When a prerequisite is missing, output something like this verbatim (substitute the missing items):
I can't run the migration yet — the following prerequisites aren't installed:
tessl-labs/tile-creator(providestessl__tile-creator)tessl/skill-optimizer(providestessl__setup-skill-performance,tessl__optimize-skill-performance-and-instructions,tessl__compare-skill-model-performance)Install them with:
tessl install tessl-labs/tile-creator tessl install tessl/skill-optimizerThen restart the Claude session so the skills register, and re-invoke
migrate-to-tessl.
Wait for the user to confirm installation before proceeding. Do not attempt to migrate without the full set — each phase from 2 onward hands off to one of these skills, and partial coverage produces silent failures (e.g., scenarios generate but no optimization happens).