CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-optimize

Audit and optimize an existing Convex app: security, scale, upgrades, observability.

Quality

79%

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-optimize/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-sequenced orchestration workflow with explicit confirmation and re-assessment checkpoints and clean organization. The main gaps are a partially duplicated Rules section, the undefined "fixCapability" reference, and the absence of an error-recovery path if applied fixes fail or regress the score.

Suggestions

Define or link "fixCapability" and specify how `sentinel` is installed, so every workflow step is executable as written.

Add an error-recovery branch (e.g., what to do when a fix fails validation or the re-assessment score regresses after applying).

Deduplicate the Rules section against the Workflow steps to reclaim tokens while keeping the read-only-first and confirm rules.

DimensionReasoningScore

Conciseness

The body is lean and directive with no concept explanations or padding — every line instructs. Not 5 because the Rules section restates workflow content already covered ("Delegate the audit to launch-readiness... don't re-implement" duplicates step 2; "re-assess after applying" duplicates step 6; the confirm-before-change rule duplicates step 5).

4 / 5

Actionability

Steps name concrete delegate targets and conditions: "ASSESS via `launch-readiness`", "run `check-updates` against the pinned `@convex-dev/*` components", "if the readiness report flagged an observability gap (no prod error capture), offer to install `sentinel`". Not 5 because "dispatching each fix to its fixCapability" and the `sentinel` install have no invocation detail; not 3 because the guidance is mostly executable via named skills with only minor gaps.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit checkpoints: "apply only on explicit confirmation" and "After applying, re-run the launch-readiness assessment and show the score delta" provide a validation loop for risky prod changes. Not 5 because there is no error-recovery branch (what to do if a fix fails or the score regresses) and no rollback guidance for changes to someone's existing app.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist); "## Workflow" and "## Rules" are well-organized sections, nothing that belongs in a separate file is inlined, and cross-skill references (launch-readiness, check-updates, sentinel) are clearly signaled — fitting the short-skill exception for a score of 5.

5 / 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 concise, distinctive description with concrete action areas, but it lacks any explicit "Use when..." trigger guidance, which caps completeness and slightly limits natural trigger-term coverage.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to audit, review, or optimize an existing Convex app, improve its security or performance, or upgrade stale @convex-dev packages."

Include natural synonyms users would actually say (review, performance, production) to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Audit and optimize an existing Convex app" combined with the four named areas "security, scale, upgrades, observability" lists several specific actions with minor gaps. Not 5 because the focus areas are categories rather than fully concrete actions ("scale" does not state what is actually done), and not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The "what" is clear ("Audit and optimize an existing Convex app: security, scale, upgrades, observability") but there is no "Use when..." clause or equivalent explicit trigger guidance — "an existing Convex app" only weakly implies when, capping completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

"Convex", "audit", "security", "upgrades", and "observability" are terms a user would naturally say when needing this skill. Not 5 because common synonyms such as "review", "performance", and "production" are missing; not 3 because coverage is good and includes the distinctive niche term.

4 / 5

Distinctiveness Conflict Risk

"Convex app" names a clear niche with distinct triggers; minimal conflict risk with any non-Convex skill. Not 4 because even closely related skills (security review, dependency upgrades) are disambiguated by the Convex qualifier.

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