CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-launch-readiness

Run every Convex audit (authz, reviewer, advisor, insights) into one scored, deduped readiness report with an ordered fix plan — Lighthouse for your backend.

Quality

77%

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

The canonical home for this skill is convex-launch-readiness in FacundoLucci/autonomous-buyer

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 a tight, well-sequenced orchestration spec with an auditable scoring formula, explicit skip/error handling, and a re-run feedback loop — genuinely strong workflow clarity and appropriate single-file structure. The main cost is redundancy: the Rules section duplicates most of workflow steps 3–7, which is the primary token-efficiency loss.

Suggestions

Cut the Rules items that verbatim restate workflow steps 3–7 (dedup rule, re-run delta, ran/skipped header, confirmed-only scoring) and keep only rules not already stated in the Workflow.

Trim rhetorical flourishes ("is theater", "not a vibe") in favor of the plain rule they restate.

Add one line on how each pass is invoked (tool/skill call) so the dispatch step is fully executable.

DimensionReasoningScore

Conciseness

The body assumes Convex expertise (no explaining authz, OCC, or what an audit is), but the Rules section restates workflow steps 3–7 nearly verbatim (dedup/keep-higher-confidence/drop-nothing-silently, re-run delta, ran/skipped header, confirmed-only scoring), and flourishes like "is theater" and "not a vibe" could be trimmed. This matches "mostly efficient but could be tightened" rather than the minor-trim level.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete: the exact scoring formula ("start at 100; subtract per CONFIRMED finding by severity (high −15, med −5, low −1), floor at 0"), a real identity-key example ("`messages:list`"), per-pass preconditions, and an ordered dispatch plan with named fixCapabilities. Not 5 because the mechanics of actually invoking each pass/capability are left unspecified.

4 / 5

Workflow Clarity

Seven clearly ordered steps with explicit preconditions and skip reporting ("a skipped pass is not a pass", "Drop nothing silently"), an explicit feedback loop ("After fixes, RE-RUN the affected passes and show the score delta"), and honest-coverage validation (step 7's ran/skipped header). This matches the anchor with explicit validation steps and error-recovery loops; fixes are gated in the fixer capabilities so no destructive cap applies.

5 / 5

Progressive Disclosure

The bundle contains only SKILL.md (no references/, scripts/, or assets/ directories exist), and the body is under 50 lines with well-organized Workflow and Rules sections, satisfying the simple-skill exception for progressive disclosure. The project paths it cites (specs/finding.schema.json, sibling capabilities) are signalled inline and are not skill-bundle references.

5 / 5

Total

17

/

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.

The description is specific and distinct, naming the four audits it composes and the concrete outputs (scored, deduped report with ordered fix plan). Its main weakness is the absence of any explicit "when to use this" trigger clause, leaving completeness capped. The "Lighthouse for your backend" tagline adds flavor but no trigger value.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks for a readiness check, audit summary, or fix plan for their Convex backend."

Include a few natural user phrasings ("is my Convex backend ready", "health check", "production readiness") to improve trigger term coverage.

Consider mentioning the post-fix re-run with score delta, which is a distinguishing capability of the skill.

DimensionReasoningScore

Specificity

"Run every Convex audit (authz, reviewer, advisor, insights) into one scored, deduped readiness report with an ordered fix plan" lists several concrete, named actions (aggregate, dedupe, score, produce a ranked fix plan). Not 5 because the dispatch/re-score loop and severity model are absent; clearly above 3 since multiple specific actions and the exact audit names are given.

4 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance — "Lighthouse for your backend" is a metaphor, not a usage trigger. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms a Convex user would say include "Convex", "audit", "readiness report", "fix plan", "backend", and "Lighthouse". A few common variations ("production readiness", "health check", "review") are missing, matching "good keyword coverage; a few natural terms missing" rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Run every Convex audit... into one scored, deduped readiness report" carves a clear aggregator niche distinct from single-purpose skills. Minor overlap risk remains with the four named sibling audit capabilities (convex-authz, convex-reviewer, convex-advisor, convex-insights), since a user asking for just an authz scan could match either.

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

FacundoLucci/autonomous-buyer

Path

.claude/skills/convex-launch-readiness/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.