CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/convex-advisor/SKILL.md

The canonical home for this skill is convex-advisor in openclaw/clawhub

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 lean, highly actionable advisory workflow with excellent sequencing, explicit fallbacks, and a fix-verification feedback loop. The only notable gaps are the duplicated severity/scope content between Workflow and Rules and the dangling reference to specs/finding.schema.json, which is not shipped in the bundle.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanation of concepts Claude already knows ('Static review guesses; the deployment KNOWS'). Matches anchor 4 rather than 5 because the Rules section restates content already in the Workflow — the severity mapping ('limit-hit / permanent-OCC-failure = high; threshold / retried = med') duplicates step 4, and 'Stay in lane' duplicates step 6. Not 3 since the duplication is minor and everything else earns its tokens.

4 / 5

Actionability

Gives exact MCP tool names ('status', 'insights', 'tables', 'functionSpec'), concrete anti-patterns and fixes ('.collect() / unindexed .filter()', '.withIndex, .take(n), or .paginate', '@convex-dev/sharded-counter'), a sample evidence line, and an explicit fallback. Matches anchor 4 — mostly executable with minor gaps; not 5 because there is no copy-paste-ready example of an emitted finding against the referenced schema.

4 / 5

Workflow Clarity

Six clearly sequenced steps (GUARD → GATHER → ROOT-CAUSE → EMIT → REPORT → scope) with explicit validation and feedback loops: step 2's fallback ('if it returns nothing or is unavailable, say so and fall back... do NOT invent findings') and step 5's gate plus re-verification ('apply only on confirmation, then re-run `insights` after traffic to verify the trend'). Matches anchor 5; the per-event-kind root-cause mapping also functions as a checklist.

5 / 5

Progressive Disclosure

Under 50 lines with well-organized Workflow/Rules sections and appropriately inlined content, but the body twice directs emission 'per specs/finding.schema.json' and that file is not present in the bundle (no references/, scripts/, or assets/ exist), so the core output contract is unreadable. Anchor 4 (good structure, minor organization gap) rather than 5.

4 / 5

Total

17

/

20

Passed

Description

70%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 dense, highly specific description that clearly names the skill's concrete actions and owns a distinct niche. Its main weakness is the complete absence of 'when to use' trigger guidance, which both caps completeness and limits natural trigger-term coverage.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when a Convex deployment shows slow queries, read-limit errors, or write contention, or when preparing a launch-readiness check.'

Include user-facing synonyms such as 'slow queries', 'production performance', or 'health check' alongside the technical event names to improve trigger-term coverage.

Mention log-failure triage or deployment health reporting so the described capabilities fully cover what the body instructs.

DimensionReasoningScore

Specificity

Lists three concrete actions — 'Read the Convex deployment's 72h insights', 'root-cause each event in code', 'report evidence-backed perf/cost findings with fixes' — with parenthetical detail ('read limits, OCC contention'). Matches anchor 4 rather than 5 because coverage has minor gaps: log-failure triage and table-stat analysis from the body are not mentioned.

4 / 5

Completeness

The 'what' is clear (read insights → root-cause in code → report evidence-backed findings with fixes), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because 'when' is entirely absent rather than merely implicit-but-present.

3 / 5

Trigger Term Quality

Contains genuinely natural domain terms a Convex user would say — 'Convex', 'deployment', 'read limits', 'OCC contention', 'perf/cost' — but misses common variations like 'slow queries', 'production health', or 'database performance'. Good coverage with a few natural terms missing fits anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Phrases like 'the Convex deployment's 72h insights' and 'OCC contention' carve out a clear niche with distinct triggers; virtually no other skill would fire on these terms. Matches anchor 5 (clear niche, minimal conflict risk) rather than 4, which requires some overlap with closely related skills.

5 / 5

Total

16

/

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

FacundoLucci/autonomous-buyer

Path

.agents/skills/convex-advisor/SKILL.md

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.