CtrlK
BlogDocsLog inGet started
Tessl Logo

grove-migrate

Migrate existing untested code into the Grove test suite. Use when the user asks to "migrate this code", "convert to Grove", "make this testable", "move this example to the test suite", "add tests for this existing code", "migrate the code on this page", or wants to convert documentation code examples that currently live outside of Grove into properly tested, snippeted examples. Supports both page-level migration (scan an RST page for all code) and snippet-level migration (convert a single code block).

68

Quality

81%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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 an excellent skill description that clearly defines its purpose, provides abundant natural trigger terms, and carves out a distinct niche. It uses proper third-person voice, explicitly states both what the skill does and when to use it, and even distinguishes between two modes of operation (page-level vs snippet-level migration).

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: migrate untested code, convert to Grove, scan RST pages for code, convert single code blocks, create properly tested snippeted examples. Also distinguishes between page-level and snippet-level migration.

3 / 3

Completeness

Clearly answers both 'what' (migrate existing untested code into the Grove test suite, supporting page-level and snippet-level migration) and 'when' (explicit 'Use when...' clause with multiple trigger phrases and contextual scenarios).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'migrate this code', 'convert to Grove', 'make this testable', 'move this example to the test suite', 'add tests for this existing code', 'migrate the code on this page'. These are realistic phrases a user would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Grove test suite migration specifically. The combination of 'Grove', 'RST page', 'snippet-level migration', and 'documentation code examples' creates a very specific domain unlikely to conflict with general testing or code migration skills.

3 / 3

Total

12

/

12

Passed

Implementation

62%

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

This is a well-structured, comprehensive migration skill with an excellent 12-step workflow that includes proper branching, validation, retry limits, and detailed reporting. Its main weaknesses are moderate verbosity (some redundancy across steps and edge cases) and a lack of concrete before/after code examples showing actual migration transformations — the skill tells Claude what to do but relies heavily on external convention files for the how. The progressive disclosure design is sound in principle but the main file could be trimmed by moving some detailed formats to reference files.

Suggestions

Add a concrete before/after code example in Step 8 showing a real migration transformation (e.g., raw JS code → Grove example with Bluehawk tags, :replace-start:, :remove: lines) to make the core migration step more actionable.

Consolidate the duplicate explanation of partial file includes (appears in both Step 7 bullet list and Edge Cases) into a single location to reduce redundancy.

Move the detailed report format templates (Step 12 discrepancy table, page-level summary table, literalinclude directive example) into a references/report-format.md file to slim down the main workflow.

DimensionReasoningScore

Conciseness

The skill is lengthy (~400 lines) but most content is genuinely necessary for a complex multi-step migration workflow. However, there's some redundancy — partial file inclusion is explained in both Step 7 and Edge Cases, and some explanations could be tightened (e.g., the data strategy table in Step 6 restates what's already clear from context). It mostly respects Claude's intelligence but could trim 15-20% without losing clarity.

2 / 3

Actionability

The skill provides detailed procedural guidance with specific file paths, table formats, and RST directive examples. However, it lacks executable code examples for the actual migration transformations — Steps 7-8 describe what to do conceptually but don't show concrete before/after code. The reviewer subagent prompt in Step 11 is a good concrete template, but the core migration logic relies on reading external convention files rather than providing inline examples.

2 / 3

Workflow Clarity

The 12-step workflow is clearly sequenced with explicit branching (page-level vs snippet-level), validation checkpoints (Step 11 reviewer with max 3 retry attempts), and a comprehensive final report structure. The handoff file check in Step 0 includes error handling. The feedback loop in Step 11 (fix → re-launch → max 3 attempts → stop and report) is well-defined for a destructive/complex operation.

3 / 3

Progressive Disclosure

The skill references several external files (references/extension-handoff.md, references/page-scanning.md, references/data-adaptation.md, conventions files, CLAUDE.md files) which is good progressive disclosure design. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself is quite long — some sections like the detailed discrepancy table format in Step 12 and the Edge Cases section could potentially be split into reference files to keep the main workflow leaner.

2 / 3

Total

9

/

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.

Repository
mongodb/docs
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.