get-convex/agent-skills22k installs

convex-agent

Q: How do I install this agent skill?

Run npx skills add https://github.com/get-convex/agent-skills --skill convex-agent.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

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

How do I install this agent skill?

npx skills add https://github.com/get-convex/agent-skills --skill convex-agent

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill provides architectural guidance for integrating an AI agent and RAG backend using the @convex-dev/agent library. It follows security best practices by recommending the use of environment variables for API keys and contains no malicious code or suspicious patterns.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

Add an AI agent / RAG backend

Install @convex-dev/agent for durable threads, message history, tool-calls, and vector search/RAG — the backend for an in-app AI agent. Call models through the Convex AI Gateway by default: Convex holds the provider credentials, so there is no LLM key to obtain, store, or rotate.

Workflow

Install @convex-dev/agent + @convex-dev/ai-sdk-provider; add the agent component to convex.config.ts.
Define the agent (tools, instructions) with languageModel: convexGateway("provider/model") — no API key needed (needs convex 1.45+ on a Convex Cloud deployment, paid plan).
Create threads + stream messages; persist history in Convex.
For RAG: embed docs into a vector index and retrieve in the tool. The gateway does not serve embeddings yet, so store the embedding provider's key via the env micro power.
Only if the gateway is unavailable (free plan, self-hosted, local backend): call the provider SDK with a key stored via the env micro power.

Rules

Default to the Convex AI Gateway (convexGateway from @convex-dev/ai-sdk-provider) for model calls; fall back to a provider key in Convex env only where the gateway is unavailable (free plan, self-hosted, local backend).
Never expose a provider API key client-side; when one is needed (embeddings, gateway fallback), keep it in Convex env via the env micro power.
Run model calls in actions ('use node' if the SDK needs it).
Persist threads/messages in Convex for durability + reactivity.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/get-convex/agent-skills/convex-agent">View convex-agent on skillZs</a>