CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

migrate-oxfmt

Guide for migrating a project from Prettier or Biome to Oxfmt. Use when asked to migrate, convert, or switch a project's formatter from Prettier or Biome to Oxfmt.

Quality

89%

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

90%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 excellent migration guide: fully executable commands, exact option-mapping tables, documented failure modes, and a clear five-step workflow — all delivered without a wasted token on concepts Claude already knows. The only meaningful gap is that the post-reformat feedback loop in Step 5 is implicit rather than an explicit validate/fix/retry instruction.

DimensionReasoningScore

Conciseness

The body teaches no background concepts and consists almost entirely of Oxfmt-specific facts Claude cannot know (option mappings, defaults, failure conditions, plugin handling). The only redundancy is nested-config guidance appearing in both Step 1 and Step 2, which is minor and cross-referenced, so it stays at anchor 5 rather than dropping to anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Commands are copy-paste ready ("npx oxfmt@latest --migrate prettier"), the Biome-to-Oxfmt option mapping is an exact per-option table, JSON snippets are complete, and the Before/After CI table covers the common cases for both sources. This matches anchor 5's 'fully executable; copy-paste ready; covers the common cases'.

5 / 5

Workflow Clarity

A clear five-step sequence (migrate, review config, configure extensions, update CI, review diff) with documented failure conditions ("Fails if no Prettier config is found", "Fails if an Oxfmt config ... already exists") and a Step 5 review checkpoint that classifies divergences as intentional vs. bug. It is below anchor 5 because the feedback loop after the batch reformat is implicit — there is no explicit 'if the diff looks wrong, revert or report and retry' instruction — but validation checkpoints are present, so the batch-operation cap at 3 does not apply.

4 / 5

Progressive Disclosure

A single well-organized SKILL.md with numbered step sections, consistent tables, clearly labeled notes, and an external References list. The inlined option mappings are working instructions needed during the migration itself, not misplaced reference material, giving good structure per anchor 4. It is not anchor 5 because the skill is well over 50 lines with no internal reference split (e.g., the plugin/option tables could live in reference files), and not anchor 3 because navigation and signaling are clear.

4 / 5

Total

18

/

20

Passed

Description

82%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 with an explicit 'Use when' trigger clause, good synonym coverage (migrate, convert, switch), and clearly named tools that make it highly distinct. Its only weakness is specificity: it states one general action rather than enumerating the concrete migration capabilities the skill actually covers.

Suggestions

Enumerate 2-3 concrete capabilities in the 'what' clause, e.g., 'Migrates Prettier or Biome config files (options, overrides, ignore patterns) to Oxfmt, and updates CI formatter commands' — this would raise specificity from anchor 3 to anchor 4-5.

Add config-file-level trigger terms users naturally mention, such as '.prettierrc', 'biome.json', or 'prettier-plugin-tailwindcss', to push trigger-term coverage toward comprehensive.

Optionally note the automated migration tool in the description ('includes an automated --migrate tool') since that is the skill's headline capability and a natural user search term.

DimensionReasoningScore

Specificity

"Guide for migrating a project from Prettier or Biome to Oxfmt" names the domain and both concrete source tools, but describes a single action rather than enumerating several capabilities (e.g., config migration, ignore-file migration, CI updates). It is above anchor 2 because the named tools make it concrete, but below anchor 4 because only one action is listed.

3 / 5

Completeness

It explicitly answers both 'what' ("Guide for migrating a project from Prettier or Biome to Oxfmt") and 'when' ("Use when asked to migrate, convert, or switch a project's formatter..."), with concrete trigger phrases. This matches the anchor-5 example structure, not anchor 4 where the 'when' is only weakly specified.

5 / 5

Trigger Term Quality

"Use when asked to migrate, convert, or switch a project's formatter from Prettier or Biome to Oxfmt" covers three natural verb synonyms and all three tool names. It falls short of anchor 5, which expects synonyms plus file extensions or config-file names (e.g., .prettierrc, biome.json), but exceeds anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

"from Prettier or Biome to Oxfmt" carves out a clear niche with named tools and distinct triggers; there is minimal risk this description fires for an unrelated skill.

5 / 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

oxc-project/oxc

Path

.agents/skills/migrate-oxfmt/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.