CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-expert

Convex backend specialist. Use this agent for any code inside a `convex/` directory — function definitions, schemas, indexes, queries, mutations, actions, HTTP endpoints, cron jobs, file storage, auth wiring, and component installation. Knows the object-form function syntax, validator patterns, resource limits, and component ecosystem that generic Claude routinely gets wrong.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong, terse rule-set that front-loads exactly the non-obvious Convex failure modes (import sources, index discipline, "use node" constraints) and closes with an unusually thorough verify-and-fix loop. The main improvements are structural: deduplicate the intro against the frontmatter, fix the dangling DATA ACCESS + IMPORTS header bullet, and add one short object-form function example.

Suggestions

Delete or drastically shorten the opening paragraph, which repeats the frontmatter description almost word-for-word and adds no new guidance.

Add a 5-10 line example of an object-form function with args and returns validators, since the body mandates this syntax repeatedly but never shows it.

Convert the dangling "DATA ACCESS + IMPORTS —" bullet into a proper subsection header (e.g., "### Data access and imports") so the Rules list reads as organized sections rather than one flat wall.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, high-value rules (exact import table, "use node" placement, storage-id discipline) with no explanation of concepts Claude already knows, matching the efficient anchor. It falls short of lean/5 because the opening paragraph restates the frontmatter description nearly verbatim ("Knows the object-form function syntax, validator requirements, index naming rules...") and the SELF-VERIFY RULE bullet is a run-on sentence that could be tightened.

4 / 5

Actionability

Mostly executable: exact imports ("`query`/`mutation`/`action`... come from `./_generated/server`") and copy-paste commands ("npx tsc --noEmit", "npx convex dev --once", "CONVEX_AGENT_MODE=anonymous npx convex dev --once") appear with concrete API names. The gap keeping it at 4 rather than 5: the headline pattern — object-form functions with args and returns validators — is mandated repeatedly ("Object form only", "args and returns validators on every registered function, no exceptions") but never shown with a short example, leaving the most common case demonstrated only in prose.

4 / 5

Workflow Clarity

The 6-step Workflow is clearly sequenced (read schema first → write → verify push) and closes with an explicit validation checkpoint, while the SELF-VERIFY RULE adds the full feedback loop: run "npx tsc --noEmit" and push, "Fix every error it reports before finishing", with conditional branching on whether "npx convex whoami" succeeds. This matches the anchor with explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

The skill is a single well-organized file under 50 lines with no bundle files (no references/, scripts/, or assets/), and its two sections (Workflow, Rules) are clearly signaled — per the simple-skill guideline this could reach 5. It sits at 4 because the Rules list opens with a dangling pseudo-header bullet ("DATA ACCESS + IMPORTS — read before writing any convex/*.ts (front-loaded, not a post-hoc lint):" followed by flat siblings), a minor organization gap suggesting an intended subsection that was flattened.

4 / 5

Total

17

/

20

Passed

Description

100%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 model frontmatter description: third-person, dense with concrete capabilities, an explicit directory-scoped trigger clause, and framework-specific vocabulary that virtually eliminates conflict with other skills. Every token describes something checkable rather than aspirational.

DimensionReasoningScore

Specificity

The description enumerates concrete coverage areas — "function definitions, schemas, indexes, queries, mutations, actions, HTTP endpoints, cron jobs, file storage, auth wiring, and component installation" — plus specific knowledge items ("object-form function syntax, validator patterns, resource limits"). This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage'; there is no vagueness or buzzword padding to drop it below 5.

5 / 5

Completeness

It explicitly answers both questions: what ("Convex backend specialist. ... Knows the object-form function syntax, validator patterns, resource limits, and component ecosystem") and when ("Use this agent for any code inside a `convex/` directory"). This is the anchor-5 pattern of a clear what plus a concrete explicit trigger phrase, not merely implied timing.

5 / 5

Trigger Term Quality

It covers the natural vocabulary a Convex developer actually uses: "convex/" directory, "Convex backend", "queries, mutations, actions", "schemas, indexes", "cron jobs", "file storage, auth wiring". These are the exact terms and file-path triggers a user would say when needing this skill, matching the comprehensive-coverage anchor; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — Convex-specific artifacts ("convex/ directory", "@convex-dev"-style components, "convex dev" workflows) with a directory-scoped trigger. No other skill category would plausibly claim these triggers, so conflict risk is minimal, matching the clear-niche anchor.

5 / 5

Total

20

/

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.