CtrlK
BlogDocsLog inGet started
Tessl Logo

grove-create

Create a new tested code example in the Grove platform. Use when the user asks to "create a code example", "add a new example", "scaffold a Grove example", "new tested example for docs", "create an example for [language]", or wants to add a tested, snippeted code example for MongoDB documentation. Covers Python (PyMongo), Go, Java (Sync Driver), JavaScript (Node.js Driver), C#, and Mongosh (MongoDB Shell).

78

0.99x
Quality

89%

Does it follow best practices?

Impact

99%

0.99x

Average score across 1 eval scenario

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an excellent operational playbook: fully concrete paths, commands, and a validated verify-retry workflow that respects destructive-operation constraints (teardown rules, sample-data protection). Its one real defect is that the entire conventions reference layer it points to is missing from the bundle, leaving the progressive-disclosure promise unfulfilled.

Suggestions

Ship the referenced bundle files: add references/conventions-{language}.md for each supported suite (javascript, python, go, java, csharp, csharp-ef-core, mongosh) and references/bluehawk-tags.md, or remove the references and inline the minimal essential patterns if the files are not intended to be bundled.

Deduplicate the mongosh and C#-EF-Core guidance: Step 1 already contains the routing rules, so the bolded 'Mongosh is fundamentally different' and 'C# EF Core is a separate suite' callouts in Step 2 can collapse into one-line pointers to their reference files.

Consider moving the Step 2 directory table plus the per-language template paths into a single references/suites.md table so the SKILL.md body stays a lean overview of the workflow.

DimensionReasoningScore

Conciseness

The body is dense with Grove-specific knowledge Claude cannot know (suite directory table, routing rules, template paths, snippet path format) and wastes almost nothing on general concepts. It falls short of anchor 5 due to redundant passages — the mongosh and C#-EF-Core distinctions are each explained twice (once in Step 1's routing rules, again as bolded callouts in Step 2), and parentheticals like '(they require build config, go.mod, package.json, etc.)' could be trimmed.

4 / 5

Actionability

Guidance is copy-paste ready throughout: an exact per-suite directory table, exact template file paths per language ('examples/example-stub.js', 'src/main/java/example/ExampleStub.java'), a fill-in-the-blank subagent prompt with concrete commands, a literal snippet path format, and an explicit retry budget ('max 3 attempts'). Placeholders like '{test-command}' are explicitly resolved by pointer to the suite CLAUDE.md and /grove-run Step 3, which is appropriate delegation rather than vagueness.

5 / 5

Workflow Clarity

Twelve clearly sequenced steps with explicit checkpoints: user confirmation of language before any work ('Wait for explicit confirmation'), a filesystem existence check with a hard stop, a verification subagent that runs the test twice for idempotency, runs the snip command to validate Bluehawk markup, and a bounded fix-retry loop ('max 3 attempts... After 3 failed attempts, stop and report'). This matches the anchor-5 pattern of explicit validation with feedback loops for error recovery.

5 / 5

Progressive Disclosure

The design is good — per-language conventions and Bluehawk tag details are split into clearly signaled, one-level-deep references ('Read references/conventions-go.md... for detailed file patterns', 'Read references/bluehawk-tags.md for the full set of tags') — but the bundle contains no references/ directory at all, so every referenced path (conventions-{language}.md for all seven languages, conventions-csharp-ef-core.md, bluehawk-tags.md) is dangling. Navigation is therefore broken at the exact layer the body depends on, which is worse than the 'minor organization gaps' of anchor 4.

3 / 5

Total

17

/

20

Passed

Description

95%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: it explicitly answers both what the skill does and when to use it, with an unusually rich set of natural trigger phrases and explicit language coverage. The only weakness is that the 'what' is a single action — the supporting artifacts it produces (test file, expected output) are left entirely to the body.

DimensionReasoningScore

Specificity

The description names the domain precisely ('Create a new tested code example in the Grove platform... for MongoDB documentation') and adds concrete qualifiers ('tested', 'snippeted') plus explicit language coverage ('Covers Python (PyMongo), Go, Java (Sync Driver), JavaScript (Node.js Driver), C#, and Mongosh'). It stops short of anchor 5 because it lists essentially one concrete action rather than several (no mention of the test file, expected output file, or verification steps that the skill actually performs), but it is well above the '1-2 concrete actions, not comprehensive' of anchor 3.

4 / 5

Completeness

Both 'what' ('Create a new tested code example in the Grove platform... tested, snippeted code example for MongoDB documentation') and 'when' ('Use when the user asks to...') are explicitly and concretely stated with trigger phrases, exactly matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Five quoted natural trigger phrases users would actually say — '"create a code example"', '"add a new example"', '"scaffold a Grove example"', '"new tested example for docs"', '"create an example for [language]"' — cover the synonym space comprehensively, alongside the explicit language names. It misses only trivial variations, matching the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

The Grove/MongoDB-documentation niche is unmistakable and the triggers all center on creating new examples, which is clearly distinct from sibling skills (fix, run, migrate, audit, setup are all different verbs). The only mild overlap risk is that 'create an example for [language]' could fire in a non-Grove context, but the surrounding MongoDB-documentation scoping keeps conflict minimal.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 9 missing

Warning

Total

14

/

16

Passed

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.