Name: convex
Rating: 57.599999999999994 (1 reviews)
Author: administrakt0r

convex

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

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

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

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 highly actionable, code-rich reference that excels at executable guidance but is held back by a monolithic structure with no progressive disclosure and missing validation checkpoints in its deployment and database workflows.

Suggestions

Split large reference material (validator types table, per-framework client integration, full schema examples) into separate one-level-deep files under references/ and link to them from SKILL.md.

Add explicit validation checkpoints to risky workflows, e.g. after `npx convex deploy` run `npx convex logs` to confirm, and re-read documents inside mutations to handle optimistic-concurrency failures.

Trim concept explanations Claude already knows (ACID semantics, what serverless means) and remove redundant inline code comments to reduce token cost.

Dimension	Reasoning	Score
Conciseness	Mostly efficient code and tables, but ~790 lines include concept teaching Claude already knows (ACID transactions, serverless/zero-config explanations) and redundant inline code comments that could be trimmed.	3 / 5
Actionability	Abundant copy-paste-ready, executable examples spanning schema, queries, mutations, actions, HTTP webhooks, client hooks, scheduling/cron, file storage, and CLI commands covering the common cases.	5 / 5
Workflow Clarity	Project setup has a clear numbered sequence and CLI commands are grouped, but database-write and deploy workflows lack validation checkpoints/feedback loops, which caps workflow clarity at 3 for destructive/batch operations.	3 / 5
Progressive Disclosure	Strong section headers organize the content, but it is a monolithic ~790-line SKILL.md with no external reference files; the validator-type table and multi-framework client integrations clearly belong in separate, one-level-deep reference files.	3 / 5
	Total	14 / 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 specific, distinct description that clearly conveys the Convex domain and its capability surface, weakened only by the absence of an explicit 'when to use' trigger clause and a few missing natural function-type terms.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when building with the Convex backend, designing schemas, or writing queries, mutations, and actions.'

Include the natural function-type terms users say (queries, mutations, actions, cron jobs) alongside the capability areas.

Reframe a few noun areas as concrete actions (e.g. 'design schemas', 'write queries/mutations/actions', 'deploy projects').

Dimension	Reasoning	Score
Specificity	Lists seven concrete capability areas (schema design, TypeScript functions, real-time subscriptions, auth, file storage, scheduling, deployment) with comprehensive coverage, though they are framed as noun phrases rather than action verbs.	4 / 5
Completeness	Has a clear 'what' (Convex reactive backend expert plus capability areas) but no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric.	3 / 5
Trigger Term Quality	Covers natural Convex terms (Convex, reactive backend, schema, auth, subscriptions, deployment) that users would say, but omits common function-type triggers users mention (queries, mutations, actions) and cron.	4 / 5
Distinctiveness Conflict Risk	'Convex' is a distinct, named product niche with clear triggers and minimal risk of firing for an unrelated skill.	5 / 5
	Total	16 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 57c135b

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.