CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-auth

Add authentication (passkeys/OAuth) to the current Convex app, including the auth.config.ts wiring.

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong, dense skill body: every step carries a concrete command plus the specific real-world failure mode it prevents (headless wizard hang, flag-parsing on the private key, silent always-signed-out bug, missing shadcn primitives). The only real gaps are mild duplication between the Workflow and Rules sections and the absence of an error-recovery loop around the final sign-in verification.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence, but the intro paragraph ("Install and wire @convex-dev/auth... correctly, including the auth.config.ts that's the #1 real-world auth footgun") echoes the frontmatter description, and the Rules section restates workflow steps 1, 3, 5, and 6 nearly verbatim. These are minor instances of over-explanation that could be trimmed, fitting anchor 4 rather than 3, since nothing explains concepts Claude already knows.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: the exact jose key-generation one-liner, the `npx convex env set "JWT_PRIVATE_KEY=$JWT"` NAME=VALUE form with the leading-dash flag-parsing gotcha called out, `pnpm add jose` for the pnpm hoisting issue, and `npx shadcn@latest add <name>` for UI primitives. Specific commands cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

A clear six-step numbered sequence with an explicit validation checkpoint ("Verify a sign-in round-trips before declaring done") and critical gotchas inline at each step. It falls short of anchor 5 because there is no error-recovery feedback loop (no "if sign-in fails, check X") — the validation step says what to do but not what to do on failure.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references; the body is well-organized into Workflow and Rules sections with no inlined content that belongs in a separate file. Per the rubric's simple-skill guideline this earns anchor 5.

5 / 5

Total

18

/

20

Passed

Description

61%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 concrete and well-scoped to a clear niche (Convex authentication with the auth.config.ts footgun called out), but it is missing an explicit "when to use" trigger clause and common synonyms like login/sign-in. Adding a "Use when..." sentence would lift both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to add login, sign-in, or authentication to a Convex app."

Include natural synonyms such as "login" and "sign-in" alongside "passkeys/OAuth" to broaden trigger-term coverage.

Optionally name one or two more concrete actions (e.g. client hooks or the sign-in UI) to make capability coverage more comprehensive.

DimensionReasoningScore

Specificity

"Add authentication (passkeys/OAuth)" and "including the auth.config.ts wiring" name the domain and two concrete actions, but coverage is not comprehensive — client hooks, sign-in UI, and key generation from the body are absent. It is above anchor 2 because the actions are concrete, not generic.

3 / 5

Completeness

The "what" is clear (add authentication plus auth.config.ts wiring to a Convex app), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. "to the current Convex app" only weakly implies the "when", so this is not anchor 4.

3 / 5

Trigger Term Quality

Natural terms like "authentication", "passkeys", "OAuth", and "Convex" are present and would be said by users needing this skill. It falls short of anchor 5 because common variations such as "login", "sign-in", or "sign in" are missing.

4 / 5

Distinctiveness Conflict Risk

"current Convex app" and "auth.config.ts" carve a distinct niche with minimal conflict risk against non-Convex skills. Not anchor 5 because the generic "authentication/passkeys/OAuth" phrasing could still overlap with other auth-related skills.

4 / 5

Total

14

/

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