CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-advisor

Read the Convex deployment's 72h insights (read limits, OCC contention), root-cause each event in code, report evidence-backed perf/cost findings with fixes.

72

Quality

87%

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

100%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 exemplar of a lean, actionable advisory skill: it names exact tools and code patterns, sequences a read-only workflow with explicit guard and re-verify checkpoints, and stays tightly scoped. It is well-organized for its size and requires no external bundle files.

DimensionReasoningScore

Conciseness

The body is dense and information-rich, assumes Claude's knowledge of Convex, and avoids explaining basic concepts; every section (Workflow, Rules) earns its tokens with no padding.

5 / 5

Actionability

Concrete guidance throughout: named MCP tools (status, insights, tables, functionSpec), specific code patterns (.collect()/.filter(), .withIndex, .take(n), .paginate, @convex-dev/sharded-counter), and explicit finding schema fields; as an instruction-only skill the absence of a code block is not penalized because the guidance is specific and executable.

5 / 5

Workflow Clarity

A clear numbered GUARD→GATHER→ROOT-CAUSE→EMIT→REPORT→Scope sequence with explicit validation checkpoints (deploy-guard gate, "if it returns nothing… fall back… do NOT invent findings") and a feedback loop ("re-run insights after traffic to verify the trend").

5 / 5

Progressive Disclosure

Under 50 lines, single-purpose, and well-organized into ## Workflow and ## Rules sections with no need for external bundle references; per the rubric's simple-skill exception this earns a 5 from clean sectioning alone, and the one-level reference to specs/finding.schema.json is clearly signaled.

5 / 5

Total

20

/

20

Passed

Description

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

The description is specific, action-oriented, and clearly niche-scoped to Convex deployment performance, but it omits any explicit "when to use" trigger guidance, which caps its completeness. Trigger-term coverage is good but could add more natural user phrasings.

Suggestions

Add an explicit "Use when…" clause, e.g. "Use when investigating a Convex deployment's runtime performance, read-limit hits, or OCC contention over the last 72h of traffic".

Include natural user-facing trigger phrases such as "my Convex app is slow" or "hitting read limits" alongside the technical terms to improve trigger-term coverage.

Optionally note the read-only/advisory framing in the description to further sharpen distinctiveness from mutating-deploy skills.

DimensionReasoningScore

Specificity

"Read the Convex deployment's 72h insights", "root-cause each event in code", and "report evidence-backed perf/cost findings with fixes" list multiple concrete, distinct actions with comprehensive coverage for the skill's scope; not a 4 because coverage is not merely several actions with minor gaps.

5 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when…" clause or equivalent explicit trigger guidance; per the rubric guideline a missing "when" caps completeness at 3, and not a 4 because the "when" is neither explicit nor specific.

3 / 5

Trigger Term Quality

Domain keywords like "Convex deployment", "read limits", "OCC contention", and "perf/cost findings" are natural for the target audience, but common user phrasings (e.g. "my Convex app is slow") and synonyms are missing; not a 5 because coverage is not comprehensive with synonyms, not a 3 because the present terms are genuinely natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

"Convex deployment's 72h insights", "OCC contention", and "read limits" define a narrow, specific niche with distinct triggers and minimal overlap with other skills.

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.

Validation16 / 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.