CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex

Convex reactive backend expert: schema design, TypeScript functions, real-time subscriptions, auth, file storage, scheduling, and deployment.

Quality

69%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/convex/SKILL.md

The canonical home for this skill is convex in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 highly actionable, accurate reference with excellent executable examples, but it is a monolithic ~790-line SKILL.md with no progressive disclosure — reference-grade material is inlined rather than split into one-level-deep files — and workflows involving database operations lack embedded validation feedback loops.

Suggestions

Split the auth-provider variants (Clerk, Better Auth), the Angular integration, and the validator/API reference tables into one-level-deep references/ files linked from SKILL.md so the main file stays a lean overview.

Add validation checkpoints to deployment and migration workflows (e.g., verify deploy output, confirm schema push succeeded before proceeding, re-validate after fixes) to build explicit feedback loops for database operations.

Consolidate the three auth client setups and the multi-framework client code into one canonical example plus a pointer — much of the duplication is pattern-level detail Claude can derive.

DimensionReasoningScore

Conciseness

The body is dense with accurate, non-padded material (executable code, validator table, CLI commands, anti-patterns, pitfalls), but at ~790 lines inlined in SKILL.md, whole topics that belong in reference files (the validator type table, three separate auth provider setups, the Angular integration section, vector/pagination examples) inflate the token cost. Not 2 because it never explains basics Claude already knows and is well organized; not 4 because the sheer volume of inlinable reference material goes beyond 'minor instances of over-explanation'.

3 / 5

Actionability

Mostly executable, copy-paste-ready guidance: complete setup commands ("npx convex dev"), full schema/query/mutation/action definitions, React hook components, cron definitions, and storage functions covering the common cases. Not 5 because of minor gaps — the Stripe webhook leaves a "// Verify webhook signature here..." stub, and examples call functions never defined (api.emails.recordSent, api.documents.saveEmbedding, api.notifications.send).

4 / 5

Workflow Clarity

Setup is clearly sequenced (numbered "npx convex dev" steps, ordered sections from schema to functions to client), and the Problem/Solution pitfalls section offers some error recovery. But workflows involving database operations lack explicit validation checkpoints — deploy/import carry no verify step and schema changes have no validate-before-proceed loop — and the rubric caps database-operation skills without feedback loops at 3. Not 4 because the checkpoints that do exist (pitfalls) are detached from the workflows rather than embedded in them.

3 / 5

Progressive Disclosure

Section structure is clear and logically ordered, but there are no bundle files at all: all 790 lines live in SKILL.md with zero one-level-deep references, and content that clearly belongs in separate files (auth provider variants, Angular integration, validator API reference) is inlined. Matches anchor 3 ('content that should be separate is inline' with some structure); not 2 because structure is well organized, not minimal; not 4 because there is no reference splitting whatsoever.

3 / 5

Total

13

/

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 strong, specific description that clearly communicates what the skill covers with good trigger keywords and minimal conflict risk. Its one structural weakness is the missing "Use when..." trigger clause, which caps completeness at 3 and leaves natural trigger variations (queries, mutations, cron jobs) unstated.

Suggestions

Add a 'Use when...' clause to the description, e.g. "Use when building or debugging a Convex backend, writing Convex queries/mutations/actions, or working with Convex schemas, auth, cron jobs, or deployments."

Include the natural trigger terms users actually say — "queries", "mutations", "actions", "cron jobs", "reactive database" — to lift trigger term quality from good to comprehensive.

DimensionReasoningScore

Specificity

Lists seven concrete capability areas — "schema design, TypeScript functions, real-time subscriptions, auth, file storage, scheduling, and deployment" — which is broad, comprehensive coverage of the Convex surface. Not 5 because capabilities are phrased as domain nouns rather than concrete actions (anchor 5 examples use verbs like "Extract", "fill", "merge") and minor gaps exist (indexing, pagination, cron jobs); not 3 because it lists far more than the 1-2 concrete actions that anchor requires.

4 / 5

Completeness

The "what" is clear and specific ("Convex reactive backend expert: schema design, TypeScript functions, real-time subscriptions, auth, file storage, scheduling, and deployment"), but there is no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Good keyword coverage: "Convex", "schema", "TypeScript", "real-time subscriptions", "auth", "file storage", "scheduling", "deployment" are terms users would naturally say. Not 5 because common natural variations are missing — "queries", "mutations", "actions", "cron jobs", "reactive database"/"BaaS" — which anchor 5 expects (synonyms and variations); not 3 because coverage goes well beyond a single relevant keyword.

4 / 5

Distinctiveness Conflict Risk

"Convex reactive backend expert" carves out a clear niche with a distinct, unambiguous trigger — a user needing this skill will say "Convex" — so conflict risk with other backend/BaaS skills is minimal. Stays at 5 because the domain noun anchors the description and none of the secondary terms would plausibly pull in the wrong skill.

5 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (798 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/convex/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.