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
81%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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).
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
5985af5
Table of Contents
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.