CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-docs

Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check node_modules types, freshness hierarchy — instead of writing a possibly-stale API from memory.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, single-purpose freshness skill with a clearly sequenced workflow, an explicit verification step, and a real error-recovery loop. Its weakness is redundancy — the freshness hierarchy and the no-memory rule are each stated multiple times across the intro, Workflow, and Rules sections, inflating token cost without adding information.

Suggestions

Remove the Rules bullets that restate the workflow verbatim — the freshness-hierarchy bullet and the "never write from memory" bullet duplicate step 2's (a)/(b)/(c) and its "Do NOT skip" line; keep each rule in exactly one place.

Trim the intro's narrative padding ("excellent for stable idioms, but it goes stale exactly where it hurts: ...") to one sentence stating the division of labor with convex-expert.

Make step 2(b) executable with one concrete fetch example (e.g., the exact WebFetch/curl form for a docs.convex.dev markdown page) so the primary path has a copy-paste-ready command.

DimensionReasoningScore

Conciseness

The body is mostly efficient and assumes competence, but there is noticeable repetition: the freshness hierarchy appears in full in step 2 ("(a) if a served docs tool... (b) else fetch the specific docs page... (c) only then fall back") and again as a Rules bullet ("Follow the freshness hierarchy: served docs tool → page-as-markdown / pinned README → general web"), and "never write from memory" is stated three times (intro, step 2's "Do NOT skip to writing the API from memory", and Rules bullet 1). The intro also pads with narrative ("excellent for stable idioms, but it goes stale exactly where it hurts"). This fits the 3 anchor — could be tightened — better than the 4 anchor's "minor instances".

3 / 5

Actionability

Concrete, executable guidance is present: a runnable version-pinning command ("node -p \"require('./node_modules/convex/package.json').version\""), a named MCP tool ("search_convex_docs"), a concrete URL pattern ("docs.convex.dev/<path>"), and a ground-truth check path ("node_modules/@convex-dev/<x>/" ... "its package.json exports, its .d.ts"). It is not a 5 because the actual fetch step (b) has no executable example — no curl/WebFetch command or worked URL — leaving a minor gap.

4 / 5

Workflow Clarity

The 5-step sequence is clearly ordered with an explicit verification checkpoint (step 3, "VERIFY against the installed package") and a genuine error-recovery feedback loop (step 5, "On a version-mismatch build error... treat it as a currentness question — pin the version, fetch the current API, and correct"). This matches the 5 anchor's "clear sequence with explicit validation steps; feedback loops for error recovery"; operations here are read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and has no bundle files (no references/, scripts/, or assets/ exist), and the body makes no dangling file references — every pointer is to an external site or a sibling skill, which keeps content one level deep. Per the simple-skill exception, the well-organized Workflow/Rules sectioning earns the 5 anchor.

5 / 5

Total

17

/

20

Passed

Description

78%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, third-person description that names concrete actions and an explicit use-when contrast. Its main weaknesses are that "freshness hierarchy" is undefined jargon and the trigger guidance is a negative framing rather than a positive 'Use when...' clause with more natural synonym coverage.

Suggestions

Convert the closing contrast into a positive trigger clause, e.g., "Use when writing Convex or @convex-dev APIs and unsure whether the version in this project still matches the docs."

Either drop the bare term "freshness hierarchy" or expand it inline (e.g., "docs MCP tool → page-as-markdown → web search") so the description's fourth capability is understandable on its own.

Add natural trigger variants like "Convex documentation", "API reference", or "@convex-dev components" to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "pin the installed version", "fetch page-as-markdown", "check node_modules types" — anchored to a named domain ("version-current Convex docs"). It falls short of the 5 anchor because "freshness hierarchy" is named as a capability but never unpacked, leaving a minor gap in coverage.

4 / 5

Completeness

The 'what' is explicit and multi-part ("pin the installed version, fetch page-as-markdown or check node_modules types"), and the 'when' is present as an explicit trigger contrast — "instead of writing a possibly-stale API from memory" — which clearly names the triggering situation. It is not a 5 because the trigger is phrased as a negative contrast rather than a direct 'Use when...' clause with concrete trigger phrases; not a 3 because the when-guidance is explicit, not merely implied.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present — "Pull version-current Convex docs", "pin the installed version", "stale API from memory" — plus the domain keyword "Convex". A few natural variants are missing (e.g., "Convex documentation", "up-to-date API reference", "@convex-dev"), so it does not reach the comprehensive synonym/extension coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is precise — version-pinned Convex documentation retrieval — with distinct triggers ("Convex docs", "pin the installed version") that would not naturally fire for other skills. This matches the 5 anchor's "clear niche with distinct triggers; minimal conflict risk"; the only adjacency is the sibling convex-expert skill, which the description does not overlap with.

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
openclaw/clawhub
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.