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

Content

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, complex migration skill with excellent workflow clarity — the 12-step process has clear branching, validation checkpoints, and error recovery. 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, which would significantly improve actionability. The progressive disclosure design references appropriate external files but the main body could be trimmed by offloading some detailed subsections.

Suggestions

Add 1-2 concrete before/after code examples in Step 8 showing an actual migration transformation (e.g., raw code → Bluehawk-tagged Grove example) to improve actionability.

Remove the redundant partial file inclusion explanation from Edge Cases since it's already covered in Step 7, and consolidate other repeated guidance to improve conciseness.

Consider moving the detailed report template (Step 12) and the full discrepancy tracking rules (Step 7) into reference files to keep the main SKILL.md focused on the workflow sequence.

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 snippets. The reviewer subagent prompt in Step 11 is concrete and copy-paste ready, which is good, 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 feedback loop for test failures. Step 0's handoff validation includes error recovery paths. The workflow handles the complexity well with clear decision points at Steps 1, 5, 6, and 10.

3 / 3

Progressive Disclosure

The skill references several external files (references/page-scanning.md, references/data-adaptation.md, references/extension-handoff.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 SKILL.md itself is quite long — some sections like the detailed discrepancy tracking rules in Step 7 or the full report template in Step 12 could potentially be moved to reference files to keep the main skill leaner.

2 / 3

Total

9

/

12

Passed

Description

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 explicitly states both what it does and when to use it. The distinction between page-level and snippet-level migration adds useful specificity. The description uses proper third-person voice throughout and is well-structured without unnecessary verbosity.

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 scenarios and user phrases).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger phrases: '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 phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Grove test suite migration specifically for documentation code examples in RST pages. The combination of 'Grove', 'RST', 'snippet', and 'test suite migration' makes it very unlikely to conflict with other skills.

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.

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.