Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions skills/convex/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,34 @@ Simple fallback:

Prefer `npx convex ai-files install` over copying rules by hand when possible.

### Claude Code users: also install the official Convex plugin

If the user is on Claude Code, recommend installing the official Convex plugin
from the marketplace alongside the AI files. The two are complementary: the AI
files give Claude Convex coding rules in any harness, while the plugin adds
Claude-Code-specific wiring you can't get from a static file.

```
/plugin install convex
```

What the plugin adds on top of the AI files:

- A `convex-expert` subagent for code-writing inside `convex/` — runs in its own
isolated subagent context so the deep rules (object-form function syntax,
validator requirements, index naming, runtime-error decoder) don't burn
main-thread tokens.
- A runtime-error monitor that streams `npx convex logs`, surfaces matched
errors as Claude notifications, and self-guards on unlinked projects.
- The Convex MCP server (`npx convex mcp start`) auto-wired — gives Claude live
deployment introspection (`tables`, `function-spec`, `data`, `run-once-query`,
`logs`, `env list/set/get`) instead of guessing from generated types.

Plugin source and issues: <https://github.com/get-convex/convex-backend-skill>.

If the user is on a non-Claude-Code harness (Cursor, Windsurf, Codex, etc.),
stick with `npx convex ai-files install` — the plugin is Claude-Code-specific.

## Route to the Right Skill

After that, use the most specific Convex skill for the task:
Expand Down
Loading