CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-suggest

Suggest the matching Convex component when the user hand-rolls a pattern it already solves (crons, sharded-counter, rate-limiter, storage, search, presence, workflow, RAG, prosemirror-sync). Passive — suggest after the task, never interrupt. Never install without consent.

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

88%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 concise, well-structured, highly actionable instruction skill with a clear passive-suggestion workflow and explicit user-response handling. The only real defects are the dangling references to a detector file absent from the bundle and install hints that are named but never supplied.

Suggestions

Remove or inline the reference to 'generators/suggest-detector.mjs' — the file is not part of this bundle, so the mapping list in step 2 should be presented as the authoritative source.

Provide the actual install hints (or at least one example installHint) in the body instead of deferring to the missing detector file, so step 4 is fully executable.

Consider moving the full pattern-to-component mapping into a references/ file if it grows, keeping SKILL.md as a lean overview with a clearly signaled one-level-deep link.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: a dense one-line detector mapping ('email/SMTP → resend; push notifications → expo-push; setInterval/cron → @convex-dev/crons; ...'), terse rules, and one earned example quote. No padding and no explanation of concepts Claude already knows, matching anchor 5 ('every token earns its place').

5 / 5

Actionability

Guidance is mostly executable for an instruction-only skill: exact pattern-to-component mappings, a concrete command ('run `/add <component>`'), a model citation example, and rules for decline/ignore. The gap versus anchor 5 is that step 4 defers to 'follow the installHint from the detector', whose contents are not provided anywhere in the skill, leaving a missing detail for execution.

4 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit branch handling for both outcomes ('If the user says yes: run /add...' / 'If the user says no or ignores it: drop it. Do not repeat.') and a strict passive-timing rule (suggest only after the current task). This is a simple single-purpose skill with an unambiguous sequence and no destructive/batch operations, so it meets the simple-skill exception for a 5.

5 / 5

Progressive Disclosure

The ~24-line body is well organized into Workflow and Rules sections, which alone would merit a 5 under the under-50-line simple-skill exception (no external references needed). However, it points to 'generators/suggest-detector.mjs' and its 'installHint' — a file that does not exist in this bundle — a dangling reference that is a minor organization/navigation gap, fitting anchor 4.

4 / 5

Total

18

/

20

Passed

Description

75%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 clear, compact description that answers both what and when with explicit trigger enumeration and well-delineated behavior boundaries. Its weakness is that the trigger keywords are mostly Convex component names (solution jargon) rather than the natural user-side phrases that would fire the skill.

Suggestions

Add user-side trigger language to the 'when' clause, e.g. 'when the user writes setInterval/cron jobs, counter increments, rate-limit logic, file/S3 uploads, or vector search integration'.

Name the concrete action set more fully (suggest one component, cite the triggering code, offer the install command) so the 'what' goes beyond the single verb 'Suggest'.

Include common synonyms alongside component names (e.g. 'push notifications', 'full-text search', 'collaborative editing') to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description gives one concrete action ('Suggest the matching Convex component') plus an enumerated trigger list ('crons, sharded-counter, rate-limiter, storage, search, presence, workflow, RAG, prosemirror-sync'), matching the anchor 'names domain and 1-2 concrete actions, but not comprehensive'. It does not list several distinct actions (suggest, install, configure), so anchor 4's 'several specific actions' is not met.

3 / 5

Completeness

Both parts are explicit: what — 'Suggest the matching Convex component'; when — 'when the user hand-rolls a pattern it already solves (crons, sharded-counter, rate-limiter, storage, search, presence, workflow, RAG, prosemirror-sync)'. This matches anchor 5: clearly answers both what AND when with concrete trigger phrases, so anchor 4 ('when could be more explicit') does not fit.

5 / 5

Trigger Term Quality

Keywords present ('crons', 'rate-limiter', 'storage', 'search', 'presence', 'workflow', 'RAG') are solution-side component names rather than the natural phrases a user hand-rolling these patterns would say ('cron job', 'setInterval', 'push notifications', 'file uploads'). This fits anchor 3's 'some relevant keywords but missing common variations or synonyms' rather than anchor 4's good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — passively suggesting Convex components for hand-rolled duplicate patterns — with behavior boundaries stated ('Passive — suggest after the task, never interrupt', 'Never install without consent'), giving minimal conflict risk with other skills as in anchor 5.

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

Path

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