CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-insights

Query a running Convex app's logs + health in natural language (official MCP): failures, slow/expensive functions, deploy causality — scoped, evidence-backed, with a dashboard deep link.

60

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/convex-insights/SKILL.md
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 disciplined, information-dense body that documents genuine tool constraints and gives a clear multi-step query workflow with three well-defined views. Its weaknesses are redundancy between the Workflow and Rules sections, a missing concrete URL pattern for the mandated dashboard deep link, and cross-references to files and sibling skills that are not present in this skill's bundle.

Suggestions

Deduplicate the Rules section — most rules restate workflow steps verbatim; keep only the rules that add new constraints.

Give a concrete deep-link pattern (e.g. 'https://dashboard.convex.dev/d/<deployment>/logs?function=<name>') so the mandated link is copy-paste constructible.

Resolve or ship the referenced artifacts ('specs/finding.schema.json', deploy-guard, convex-advisor, monitor/sentinel) — either bundle them as references/ files or describe their interfaces inline so the hand-off step is self-contained.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it explains no general concepts and documents real tool limitations ('logs takes only a --history COUNT... there is NO server-side status/function/requestId/time filter'). It stops short of a 5 because the Rules section substantially restates workflow steps (no-server-filter, dashboard link, discover-first, and hand-off each appear twice), which could be trimmed.

4 / 5

Actionability

Concrete, executable guidance throughout: named tools with flags ('logs --history <n> --jsonl', 'insights', 'functionSpec', 'status'), a defined answer format (one-line finding + counts + first stack per group + deep link), and explicit client-side filtering steps. It misses a 5 because the dashboard deep link — a required part of every answer — is described only as 'build it from the deployment name + function' with no URL pattern to copy.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with real checkpoints: a guard step (identify the deployment), discover-before-query discipline, three named views with when-to-use-each, a bounded-window rule, and a correlate-don't-assert cross-check. The skill is read-only so the destructive-cap does not apply, but there is no explicit feedback loop for error recovery (e.g., what to do when the window contains no failures or the function name isn't found), keeping it below the 5 anchor.

4 / 5

Progressive Disclosure

Under 50 lines, single-purpose, and well organized with a Workflow section and a Rules section, which per the simple-skill note would support a 5. However, the body references paths and sibling skills outside this skill's bundle ('specs/finding.schema.json', 'deploy-guard step 0-1', 'convex-advisor', 'monitor/sentinel') with no references/ or scripts/ files present, leaving dangling navigation — a minor organization gap matching the 4 anchor.

4 / 5

Total

16

/

20

Passed

Description

66%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 specific, well-scoped description with strong natural keywords and a distinct Convex niche, written in appropriately imperative third-person style. Its main weakness is the missing 'Use when...' trigger clause, which caps completeness, plus some jargon ('deploy causality', 'evidence-backed') that users would not naturally say.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks about Convex errors, slow or failing functions, what broke after a deploy, or why a specific call failed.'

Include natural synonyms users would actually say — 'errors', 'debug', 'production', 'what broke after deploy' — alongside the current keyword set.

Trim jargon like 'deploy causality' and 'evidence-backed' in favor of the plain-English questions this skill answers.

DimensionReasoningScore

Specificity

The description names the domain ('a running Convex app's logs + health') and lists several concrete capabilities — 'failures, slow/expensive functions, deploy causality' — which matches the anchor for several specific actions with minor gaps in coverage. It falls short of the 5 anchor because the actions are compressed into fragments rather than a comprehensive, plainly stated list.

4 / 5

Completeness

The 'what' is clear (query a running Convex app's logs and health in natural language), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only weakly implied by 'a running Convex app'. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'logs', 'failures', 'slow', 'health', 'deploy' are phrases users would say when they need this. It stays at 4 rather than 5 because common variations like 'errors', 'debug', 'production', or 'why did my deploy break this' are absent, and phrases like 'deploy causality' and 'evidence-backed' are jargon users would not naturally say.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Convex log/health querying via the official MCP) with distinct Convex-specific triggers, but 'slow/expensive functions' overlaps the territory of a closely related perf/advisor skill, creating minor overlap risk — matching the 'mostly distinct' anchor rather than the minimal-conflict anchor at 5.

4 / 5

Total

15

/

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.