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

78%

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 ./.claude/skills/convex-advisor/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 tight, well-structured advisory workflow with genuinely actionable mappings from runtime evidence to code-level fixes and strong guardrails (read-only discipline, no invented findings, explicit scope routing). The main improvement opportunities are de-duplicating rules restated in the workflow and adding a concrete fix snippet or example finding.

DimensionReasoningScore

Conciseness

Lean, dense prose that assumes competence ("Static review guesses; the deployment KNOWS") with no concept explanations. Not 5 because the severity mapping, read-only guard, and scope routing each appear twice (Workflow steps 4/1/6 and again in Rules) and could be consolidated.

4 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: named MCP tools (`status`, `insights`, `tables`, `functionSpec`), typed event kinds, and specific fixes (`.withIndex`, `.take(n)`, `.paginate`, `@convex-dev/sharded-counter`). Not 5 because fixes are named rather than shown — no copy-paste snippets for the common cases.

4 / 5

Workflow Clarity

A clear 6-step sequence with a guard step, an explicit fallback when insights are unavailable ("do NOT invent findings"), and a verify loop after applying fixes ("re-run `insights` after traffic to verify the trend"). Not 5 because the verification step is offered rather than mandated and there is no explicit error-recovery path if the flagged function's code cannot be read.

4 / 5

Progressive Disclosure

At ~28 lines with well-organized Workflow/Rules sections and no bundle files, the structure is good and appropriately sized. Not 5 because pointers like "specs/finding.schema.json" and "convex-expert patterns" reference paths outside the skill that are not resolvable from the bundle, a minor navigation gap.

4 / 5

Total

16

/

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 highly specific, distinctive description with concrete actions and strong domain keywords. Its only material weakness is the missing explicit "when to use" trigger clause, which caps completeness and leaves natural-language triggers implied rather than stated.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about Convex deployment performance, read-limit errors, write contention, or production cost."

Include one or two natural synonyms users would say ("slow queries", "production health check") alongside the technical terms like "OCC contention".

Briefly state what is excluded (authz, code style) to sharpen the boundary with sibling skills like convex-reviewer.

DimensionReasoningScore

Specificity

Lists several concrete actions — "root-cause each event in code", "report evidence-backed perf/cost findings with fixes" — tied to a specific domain. Not 5 because coverage of what the advisor handles is conveyed via only two example insight kinds in parentheses.

4 / 5

Completeness

The "what" is clear (read 72h insights, root-cause in code, report 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 2 because the "what" is specific and concrete rather than vague.

3 / 5

Trigger Term Quality

Good keyword coverage: "Convex", "deployment", "insights", "read limits", "OCC contention", "perf/cost" are terms a Convex user would say. A few natural variations ("slow queries", "production issues", "database health") are missing, so it falls short of the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

"The Convex deployment's 72h insights" pins a clear niche (runtime deployment health vs. static code review) with distinct triggers and minimal conflict risk with other skills. It clearly matches the top anchor and not the "minor overlap risk" anchor below it.

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

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