CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

effective-shell-migration

This skill should be used when migrating book content to website, converting chapter formatting, or making any changes to migrated content. Use when the user mentions "migration", "book content", "chapter", or edits files in docs/ that correspond to book chapters.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

An exemplary content body: token-efficient tables, exact conversion patterns, concrete validation checklist with a build gate, and a clean one-level-deep reference structure pointing to real bundle files. The only minor gap is that the ordered migration workflow lives in an external reference rather than the body itself.

DimensionReasoningScore

Conciseness

The body is lean and table-driven with no explanation of concepts Claude already knows — every section (typography, conversions, checklist, source paths) carries skill-specific information only. It matches anchor 5 (lean, every token earns its place); not anchor 4 since there is no over-explanation to trim.

5 / 5

Actionability

Concrete, copy-paste-ready guidance throughout: exact character mappings ("`—` (U+2014)" vs "`---`"), exact format-conversion pairs ("`[key]{.smallcaps}`" → "`<kbd>Key</kbd>`"), a before/after code-block example, a specific build command ("npm run build"), and absolute source paths. This covers the common cases as anchor 5 requires; the few genuinely ambiguous rows (page-reference linking) are appropriately delegated to the reference files.

5 / 5

Workflow Clarity

A validation checkpoint is explicitly present ("Validation Checklist — Before committing migrated content" with checkboxes and "Build passes (`npm run build`)"), so the batch-operation cap of 3 does not apply. However, the step-by-step sequence itself is not in the body — it is delegated to references/workflow.md — so it fits anchor 4 (checkpoints present, minor gaps) rather than anchor 5's fully explicit sequenced workflow with feedback loops in the body.

4 / 5

Progressive Disclosure

Clear overview structure: quick-reference tables inline, with three well-signaled one-level-deep references ("[Typography Rules](./references/typography.md)", "[Formatting Guide](./references/formatting.md)", "[Workflow Checklist](./references/workflow.md)"), all of which exist in the bundle. This matches anchor 5; not anchor 4 since navigation and content split are clean with no organization gaps.

5 / 5

Total

19

/

20

Passed

Description

78%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 well-formed description with an explicit 'Use when' trigger clause covering natural terms, clearly answering both what and when. Its main weaknesses are limited specificity of the conversion actions and an unqualified "migration" trigger that risks overlap with unrelated migration tasks.

Suggestions

Enumerate the concrete conversion actions in the description (e.g., 'converts typography, note blocks to admonitions, keyboard shortcuts, code blocks, and figures') to raise specificity beyond two actions.

Qualify the 'migration' trigger with book context (e.g., 'book-to-website migration') to reduce overlap with database or code-migration requests.

Add natural synonyms such as 'convert chapters' or 'manuscript' to the trigger list for broader keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — "migrating book content to website, converting chapter formatting" — but "making any changes to migrated content" is a vague catch-all and there is no mention of the actual conversion work (typography, admonitions, code blocks, figures). It matches anchor 3 (1-2 concrete actions, not comprehensive) better than anchor 4, which expects several specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers what ("migrating book content to website, converting chapter formatting") and when, with a concrete trigger clause: "Use when the user mentions 'migration', 'book content', 'chapter', or edits files in docs/...". This mirrors the anchor-5 example pattern; anchor 4 applies only when the 'when' could be more explicit, which is not the case here.

5 / 5

Trigger Term Quality

Triggers like "migration", "book content", "chapter", and "edits files in docs/ that correspond to book chapters" are natural phrases a user would say. A few natural variants are missing (e.g., "convert chapters", "book-to-website", "manuscript"), so it fits anchor 4 (good coverage, a few terms missing) rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche (book-to-website chapter migration) is mostly distinct, grounded by terms like "book content" and "chapter". However, the bare trigger "migration" unqualified could also fire on database or code-migration requests, giving minor overlap risk — anchor 4 rather than anchor 5's minimal-conflict clear niche.

4 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

dwmkerr/effective-shell

Path

.claude/skills/effective-shell-migration/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.