CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

convex-agent

Add an AI agent / RAG backend (@convex-dev/agent) to the Convex app.

Quality

70%

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 ./.claude/skills/convex-agent/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplary token-efficient overview: lean, well-sectioned, and dense with non-obvious constraints (gateway-only default, embeddings gap, version/plan requirements). Its weakness is execution depth — the workflow lacks code for the core steps (agent definition, thread creation, vector index setup) and contains no validation checkpoints, leaving an otherwise clear sequence at 'some concrete guidance but incomplete'.

Suggestions

Add a minimal copy-paste example for the two central steps: defining the agent in convex.config.ts/agent file and creating a thread + streaming a message.

Make the RAG step executable by naming the vector-index component/schema setup (e.g., which package or table definition to use) instead of 'embed docs into a vector index'.

Add a validation checkpoint after setup (e.g., verify the agent component is registered in the Convex dashboard or that `npx convex dev` succeeds) so the workflow earns a feedback loop.

DimensionReasoningScore

Conciseness

The body is ~26 lines with zero padding: every line carries non-obvious information (e.g., 'needs convex 1.45+ on a Convex Cloud deployment, paid plan', 'The gateway does not serve embeddings yet'). It assumes Claude's competence — no explanation of what an agent or vector search is — matching anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place').

5 / 5

Actionability

Concrete specifics exist — package names (@convex-dev/agent, @convex-dev/ai-sdk-provider), the file to edit (convex.config.ts), the call shape `languageModel: convexGateway("provider/model")` — but key execution details are missing: no example of defining an agent or creating/streaming a thread, no vector-index setup for step 4, and the `env` micro power is named without any pointer to how it works. This matches anchor 3 ('Some concrete guidance but incomplete; ... missing key details') rather than anchor 4, which expects mostly executable guidance with only minor gaps.

3 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced and even includes a conditional branch ('Only if the gateway is unavailable (free plan, self-hosted, local backend)'), but no validation or verification checkpoints appear anywhere — nothing like confirming the component registered, checking the deployment, or testing the agent after setup. That matches anchor 3 ('Steps listed but validation gaps; sequence present but checkpoints missing or implicit'); it is above anchor 2 because the sequence is well defined, and below anchor 4 because 'most checkpoints present' is not met with zero checkpoints.

3 / 5

Progressive Disclosure

The skill is under 50 lines with no external bundle files (references/, scripts/, assets/ are absent) and the body references no files that don't exist, so there are no dangling references. Content is well organized into two clearly-labeled sections (## Workflow, ## Rules), which per the rubric's guideline for short skills without external-reference needs earns anchor 5.

5 / 5

Total

16

/

20

Passed

Description

53%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 concise, third-person, and clearly names its niche (Convex + @convex-dev/agent), giving it good distinctiveness. Its main weakness is the absence of any 'when to use' trigger guidance, which caps completeness and limits natural-keyword coverage to the two core terms without synonyms.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user wants an in-app AI agent, chatbot, RAG, or vector search in a Convex app.'

Include common user synonyms such as chatbot, LLM assistant, message history, or vector search to broaden natural trigger-term coverage.

Optionally enumerate 2-3 concrete capabilities (durable threads, tool calls, vector search/RAG) to lift specificity toward the higher anchor.

DimensionReasoningScore

Specificity

Quotes: "Add an AI agent / RAG backend (@convex-dev/agent) to the Convex app" — it names the domain and one concrete action (adding the agent backend) with the exact package, but does not list several actions like the score-4 anchor ('Extracts text from PDF files, fills forms, converts pages to images'). It is more concrete than the score-2 anchor ('Names the domain but actions are minimal or generic') since it names the specific package and target app, so 3 is the best fit.

3 / 5

Completeness

The 'what' is clear ('Add an AI agent / RAG backend (@convex-dev/agent) to the Convex app'), but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, so per the judging guidelines completeness is capped at 3 ('Has a clear what but when is missing or only weakly implied'). It is not a 4 because the 'when' is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Relevant terms present: "AI agent", "RAG", "backend", "Convex", "@convex-dev/agent" — the core phrases a user would say. However, common variations and synonyms are missing (e.g., "chatbot", "LLM", "vector search", "embeddings", "message history"), matching anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and tightly scoped: "(@convex-dev/agent) to the Convex app" — unlikely to trigger for non-Convex skills. It is not a 5 because the description lacks explicit trigger phrases (the score-5 anchor's example includes 'Use when working with...' phrasing), leaving minor overlap risk with generic AI-agent/backend skills.

4 / 5

Total

13

/

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

.claude/skills/convex-agent/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.