CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-ship

Publish the current Convex app to a live *.convex.app URL (deploy backend + upload web build).

Quality

72%

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-ship/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 body for a simple deployment skill: sections are clean, rules are meaningful, and nothing is padded. Weaknesses center on execution detail — only one of four steps carries a concrete command — and the absence of validation checkpoints around the privileged publish step.

Suggestions

Give the executable command(s) for the publish step (and the claiming step), e.g. the actual CLI invocation for the moderated publish gateway, instead of describing it in prose.

Add validation checkpoints: verify `convex deploy` succeeds (check deployment output) and confirm the web build completed before uploading.

Specify what "Build the web app (static export)" means concretely (which command/flags), since this is currently the vaguest step.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (no explanation of what Convex is, no padding), but the intro paragraph ("deploy the Convex backend to the cloud (claiming the anonymous deployment if needed), build the web app, and publish it to *.convex.app") substantially restates the Workflow list, a minor redundancy that could be trimmed. This sits between anchors 4 and 5, at anchor 4: efficient with a little slack.

4 / 5

Actionability

One step is executable ("`convex deploy` the backend"), but the other steps are high-level hints without the specific commands: "claim/persist it to the cloud (Tier-2 sign-in)", "Build the web app (static export) and upload via the moderated publish gateway". This matches anchor 3 (some concrete guidance but incomplete; missing key details) rather than anchor 2, since the mechanism and one real command are given.

3 / 5

Workflow Clarity

The four workflow steps are clearly numbered and sequenced, and "Confirm before publishing (it produces a public URL)" is an explicit pre-flight checkpoint. However, there are no validation/verification steps (e.g. confirm deploy succeeded, verify the build before upload) and no error-recovery loop for a privileged, outward-facing operation, which matches anchor 3 (sequence present but checkpoints missing) and is capped there by the destructive/outward-facing validation rule.

3 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, with well-organized sections (Workflow, Rules) and no bundle files exist, so no external references are needed. Per the simple-skill scoring note, this earns anchor 5: clear structure with nothing that belongs in separate files, and cross-references to other skills (`domains`, `labs-acquire-domain`) are clearly signaled.

5 / 5

Total

15

/

20

Passed

Description

65%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 concise, concrete, and unambiguous about what it does, with a highly distinctive niche. Its main weakness is the complete absence of explicit "when to use" trigger guidance, plus a couple of missing natural synonyms ("ship", "go live").

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to ship, deploy, or publish their Convex app or get a live URL."

Include natural synonyms such as "ship", "go live", and "share" alongside "publish" and "deploy" to broaden trigger-term coverage.

Consider naming the anonymous-deployment claiming step in the description so the what-coverage is more comprehensive.

DimensionReasoningScore

Specificity

Names the domain ("Convex app") and 1-2 concrete actions ("deploy backend + upload web build") with a concrete outcome ("live *.convex.app URL"), but coverage has gaps (claiming anonymous deployments, custom-domain handling are absent). This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; anchor 4 requires several listed actions, which this does not have.

3 / 5

Completeness

The "what" is clear (publish the Convex app to a live URL by deploying the backend and uploading the web build), but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "the current Convex app". Per the judging guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Includes good natural trigger terms — "Publish", "deploy", "live", "Convex app", "*.convex.app" — that users would plausibly say. A few natural variations like "ship" and "go live" are missing, so it falls between anchors 3 and 4, noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The combination of "Convex app", "*.convex.app URL", and the deploy/publish workflow carves out a clear niche with distinct triggers and minimal conflict risk with any other skill; it matches the anchor 'clear niche with distinct triggers; minimal conflict risk'.

5 / 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

Path

.agents/skills/convex-ship/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.