CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-domains

Point a domain you already own at your Convex app (DNS records, custom-domain attach, auth-origin rebind).

68

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exemplary compact skill body: a precisely sequenced workflow with built-in safety rails (never handle credentials, confirm before user-visible DNS changes, verify afterwards) and provider-specific commands. The only notable gap is the missing exact command for the Convex custom-domain attach step.

Suggestions

Give the exact attach command (e.g., the npx convex CLI invocation or the dashboard path) instead of '(dashboard or CLI)' in step 4.

Add one line on what to do when verification fails or DNS doesn't propagate (e.g., re-check records with dig, common CNAME flattening pitfalls).

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: it never explains what DNS or a CNAME record is, and packs each line with actionable specifics like 'flarectl dns create (note: wrangler itself doesn't manage DNS records)'. Every token earns its place, matching the 'lean and efficient' anchor; it is not lower because no padded or explanatory passages exist.

5 / 5

Actionability

Mostly executable guidance with copy-paste commands for five provider CLIs, read-only auth checks, and 'dig +short' verification — but step 4 says 'Attach the domain as a Convex custom domain (dashboard or CLI)' without the exact command, and record values are described as to-be-derived ('with concrete host/value strings, not placeholders'). Minor gaps keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints: read-only auth check first, user confirmation before running, 'Verify records landed with dig +short', 'wait for verification', and a final HTTPS check including the apex→www redirect. Because this workflow touches a live domain, validation presence is decisive — it is fully covered, matching the 'clear sequence with explicit validation steps' anchor; not 4 because no checkpoint is missing.

5 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, has no bundle files, and is cleanly organized into a Workflow section and a Rules section with no content that belongs in a separate file. Per the rubric's simple-skill note, well-organized sections alone warrant a 5 here.

5 / 5

Total

19

/

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 terse, highly specific description that clearly states what the skill does with concrete domain-specific actions. Its main weakness is the complete absence of a 'Use when...' trigger clause, which caps completeness and limits discoverability when a user asks about hooking up their domain.

Suggestions

Append an explicit trigger clause, e.g., 'Use when the user wants to point a domain they own at their Convex deployment, set up DNS records, or move auth to a custom domain.'

Add natural trigger synonyms users would say — 'custom domain', 'hostname', 'subdomain', 'apex domain' — to improve matching.

Mention the verification/propagation-check aspect of the task so the 'what' covers the full workflow, not just record creation.

DimensionReasoningScore

Specificity

The description names the domain (Convex) and three concrete actions — 'DNS records, custom-domain attach, auth-origin rebind' — with only minor gaps in coverage (e.g., verification steps and target identification are not mentioned), matching the 'lists several specific actions' anchor rather than the narrower 1-2 action anchor.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only weakly implied by 'a domain you already own'. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3 — it is not 4 because 'when' guidance is entirely absent, and not 2 because the 'what' is fully explicit.

3 / 5

Trigger Term Quality

Natural phrases users would say are present — 'domain', 'DNS records', 'custom-domain', 'Convex app' — but common variations such as 'hostname', 'subdomain', 'apex', or 'URL' are missing, fitting the 'good keyword coverage; a few natural terms missing' anchor.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (attaching an owned domain to a Convex app) with distinct triggers like 'auth-origin rebind', making it highly unlikely to fire for the wrong skill. It matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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