CtrlK
BlogDocsLog inGet started
Tessl Logo

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

1.11x
Quality

100%

Does it follow best practices?

Impact

100%

1.11x

Average score across 4 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong, well-crafted description that opens with an explicit 'Use when' clause and enumerates a comprehensive list of specific actions and trigger terms. The domain-specific terminology creates a clear niche with minimal conflict risk. The only minor weakness is that the description is quite dense and could benefit from slightly more structured formatting, but the content itself is excellent.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: migrating, restructuring, publishing, auditing skills into tiles; converting file formats; fixing Quality/Impact/Uplift scores, frontmatter, metadata, tile.json, README, markdown reference links; pushing scores from 88-99% to 100%. Very detailed and action-oriented.

3 / 3

Completeness

The description opens with an explicit 'Use when' clause covering multiple trigger scenarios (migrating, restructuring, publishing, auditing) and then details what the skill does (converting files, fixing various quality dimensions, pushing scores to 100%). Both 'what' and 'when' are clearly addressed.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms a user would say: 'Tessl tile', 'SKILL.md', 'tile.json', 'frontmatter', 'metadata', 'README', 'Quality', 'Impact', 'Uplift', 'registry-vs-local', 'auto-eval', 'markdown reference links', 'artifact anchors'. These are highly domain-specific terms that users working in this space would naturally use.

3 / 3

Distinctiveness Conflict Risk

This skill occupies a very clear niche around Tessl tile creation and quality optimization. The highly specific terminology (Tessl, tile.json, Quality/Impact/Uplift scores, registry-vs-local gaps, auto-eval wait discipline) makes it extremely unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an excellent skill that demonstrates strong craft across all dimensions. The workflow is comprehensive yet concise, with clear validation gates and feedback loops for a complex multi-step publishing process. The progressive disclosure is well-executed with a self-contained main workflow supplemented by phase-specific reference files, and the required shapes provide copy-paste-ready templates.

DimensionReasoningScore

Conciseness

The skill is lean and efficient throughout. It assumes Claude's competence with CLI tools, YAML, JSON, and publishing workflows. No unnecessary explanations of what tiles, frontmatter, or markdown are. Every section earns its place with specific, actionable content.

3 / 3

Actionability

Provides concrete YAML/JSON templates for required shapes, exact CLI commands in the command anchors section, specific gate criteria (3/3 on every dimension, scores at 1), and explicit decision logic (e.g., when to use --skip-evals vs eval-bearing publish). The workflow steps are specific enough to execute directly.

3 / 3

Workflow Clarity

The 10-step workflow is clearly sequenced with explicit validation checkpoints: lint/review gates at step 7, Quality gate at step 8 before eval work, eval inspection and retry loop at step 9, and final confirmation at step 10. Feedback loops are well-defined (patch lowest dimension → rerun, fix eval miss → repeat Quality gate). Stop conditions are explicitly enumerated.

3 / 3

Progressive Disclosure

The skill provides a complete inline workflow sufficient for most cases, then cleanly references 8 detailed reference files organized by phase. References are one level deep, clearly signaled with descriptive names, and explicitly scoped ('Use only when the inline workflow is not enough'). The structure supports both quick execution and deep dives.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents