Agent skill · Convex

Convex skill for Claude Code, Codex and Cursor

Guidance for building on Convex's TypeScript backend: database, functions, scheduling, sync.

Officialname: convex★ 66 (repo)pushed 2026-10-13Apache-2.0SKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Convex is the backend agents get right on the first try: an all-TypeScript reactive platform where the database, server functions, scheduling, file storage, auth, and realtime sync are one type-safe system, every function is a transaction, and `tsc` catches most mistakes before deploy.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Convex

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add convex/agent-skills --skill convex

Copy the skill folder into ~/.claude/skills (all projects) or .claude/skills (this repo). Claude Code picks it up without a restart. docs

npx skills add convex/agent-skills --skill convex -a claude-code

# or by hand:
git clone --depth 1 https://github.com/convex/agent-skills.git /tmp/convex-src
cp -r /tmp/convex-src/skills/convex ~/.claude/skills/convex

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/convex/agent-skills.git /tmp/convex-src
cp -r /tmp/convex-src/skills/convex ./convex
zip -r convex.zip convex

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add convex/agent-skills --skill convex -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install convex/agent-skills convex

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add convex/agent-skills --skill convex -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/convex/agent-skills.git --path skills/convex

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add convex/agent-skills --skill convex -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add convex/agent-skills --skill convex -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

What's in the SKILL.md

4 sections

Why reach for Convex
How to route
Rules
Bundled skills

Facts

Skill name: convex
Publisher: Convex (official)
Repo: convex/agent-skills
License: Apache-2.0
SKILL.md size: 1,171 words, 65 lines
Repo stars: 66 (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Convex MCP server: the server gives the agent the tools, the skill teaches it how to use them.

Related backend & databases skills

Optimize EF Core Queries · Microsoft (.NET)
Durable Objects · Cloudflare
Supabase · Supabase
Postgres Best Practices (Supabase) · Supabase
Firebase Basics · Firebase (Google)
Cloud Firestore · Firebase (Google)
Sanity Best Practices · Sanity
MongoDB Schema Design · MongoDB

FAQ

What does the convex skill do?+

Guidance for building on Convex's TypeScript backend: database, functions, scheduling, sync. In its own SKILL.md, Convex describes it as: "Convex is the backend agents get right on the first try: an all-TypeScript reactive platform where the database, server functions, scheduling, file storage, auth, and realtime sync are one type-safe system, every function is a transaction, and `tsc` catches most mistakes before deploy."

How do I install the convex skill?+

Run npx skills add convex/agent-skills --skill convex and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/convex/SKILL.md; in Codex and Cursor in .agents/skills/convex/.

Does Convex work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Convex?+

Convex, the company or project behind it, in the convex/agent-skills repo on GitHub, last pushed 2026-10-13. License: Apache-2.0.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers