convex-add

Adds backend capabilities to an existing Convex app using a served capability catalog.

1|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-add-rocktown-labs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-add
Source: https://github.com/Rocktown-Labs/rivercitymd/tree/main/.agents/skills/convex-add
Command: npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-add-rocktown-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding backend capabilities like billing, crons, auth, search, or hosting to an existing Convex app normally requires manually finding the right component and wiring it up, which is error-prone and quickly outdated. ## Core Features & Use Cases - Live Capability Catalog: Fetches the served Convex capability catalog first so procedures stay current without re-releasing the skill. - Automatic Fallback: Falls back to the legacy /add-hosting flow or the /add-component search script when the catalog is unreachable or has no match. - Component Installation: Reads the CANDIDATES list from the search script, installs the best-matching @convex-dev component, and wires it per its README. - Use Case: A developer types /add billing in their Convex project; the skill matches the billing entry in the catalog, fetches its procedure doc, and follows the steps to wire Stripe billing into the app. ## Quick Start Ask the assistant to add a capability such as hosting or billing to your current Convex app, for example by running /add hosting.

Frequently Asked Questions about convex-add

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a capability to an existing Convex app?▼

Run /add followed by the capability name, such as /add billing. The skill fetches the served Convex capability catalog, matches your request, and follows the procedure in the fetched capability document.

What capabilities can I add to a Convex backend?▼

The catalog covers capabilities like billing, crons, auth, agents, and search, plus static hosting. If no catalog entry matches, the skill searches @convex-dev components and installs the best match.

What happens if the Convex capability catalog is unreachable?▼

The skill never hard-fails on a catalog miss. It falls back to the legacy behavior: /add-hosting for hosting requests, or the /add-component search script for everything else.

Why does the add command fail in a sandboxed environment?▼

The workflow requires network access to fetch the catalog and run curl or bash commands. If the sandbox blocks these, re-run with network access enabled or auto-approve the commands.

Does the skill hardcode which component to install?▼

No. It never hardcodes a component mapping. It reads the live CANDIDATES output from the search script and installs the best-matching @convex-dev component, wiring it per its README.