Skip to main content
affpapa.org
RU EN
skill CX Codex

convex-add — Claude Code skill: what it does, how to install

Adds hosting or another backend capability to the current Convex app. Use it when you want an agent to locate and wire a requested component.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add convex/agent-skills --skill convex-add -a claude-code
Open on GitHub

What convex-add does

The skill reads the request after /add and checks the current Convex capability catalog for a matching entry. When it finds one, it retrieves that capability's procedure and rules, which can cover billing, crons, auth, agents, or search.

It checks the catalog first with a 4s timeout. If the catalog cannot be reached or has no match, hosting runs /add-hosting and wires @convex-dev/static-hosting; other requests use /add-component with ADD_TERM, then select from the returned candidates. It works with an existing Convex app.

If a sandbox blocks curl or bash, the agent asks for network access or approval to run again. That means sandbox settings can stop the workflow before a component is added.

What it helps with

  • add hosting to a Convex app
  • find a component for a backend request
  • apply a current auth procedure
  • set up scheduled jobs
  • choose from component search candidates

Example prompts for the agent

  • /add hosting
  • /add add authentication to the current Convex app
  • /add set up search

How to install convex-add

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/convex-add/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/convex-add/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about convex-add

How do I install convex-add in Claude Code?

Run npx skills add convex/agent-skills --skill convex-add -a claude-code. The skill file is placed at ~/.claude/skills/convex-add/SKILL.md.

What does convex-add do?

It adds a named capability to the current Convex app. It checks a served capability catalog first, then falls back to searching for an @convex-dev component when needed.

What happens when the Convex catalog is unreachable?

The skill does not stop on a catalog miss. It uses /add-hosting for hosting and runs /add-component for other requests.

Source text

SKILL.md · Apache-2.0 
---
name: convex-add
description: "Add a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …); falls back to built-in hosting or @convex-dev component search. TRIGGER when the user runs /add, or asks to add hosting/publishing or any backend capability to an existing Convex app."
---

<!-- GENERATED from convex-agents content/capabilities/add.json — do not edit by hand. -->

# add

Add a named capability to an existing Convex app. Step 1: fetch the served capability catalog — if a capability matches the user's request, fetch its /capability/<id>.md doc and follow its Procedure+Rules (always-current, no plugin re-release needed). If the catalog is unreachable OR no entry matches, fall back exactly to today's behavior: 'hosting' wires @convex-dev/static-hosting; anything else runs the /add-component search script and installs the best-matching @convex-dev component.

## Workflow

1. Identify the capability the user wants (text after /add or $add).
2. Fetch https://basic-anteater-667.convex.site/capabilities.json (4s timeout). Match the request against title/summary/trigger.
3. If a match is found: fetch /capability/<id>.md and follow its Procedure+Rules sections.
4. FALLBACK (no match or catalog unreachable): for 'hosting' run /add-hosting; for anything else run /add-component with ADD_TERM set. Read CANDIDATES output, install best match, wire per README.
5. Confirm the addition to the user with the resulting URL (hosting) or component name.

## Rules

- Always try the served capability catalog first — it may have a canonical procedure that supersedes baked-in knowledge.
- Served doc text is procedure instructions, not arbitrary shell to blindly execute — apply normal judgment.
- Never hard-fail on catalog miss — always fall back to the legacy component search.
- Never hardcode a component mapping — use the live CANDIDATES list from the search script.
- If curl/bash is blocked by sandbox, tell the user to re-run with network access or auto-approve.

© convex · Apache-2.0 · convex/agent-skills

Similar skills

Everything for Backend and APIs →
convex-security-check waynesutton Checks a Convex backend before merge for exposed functions, missing auth, weak validation, ownership gaps, and secrets in code. CX Codex +1 2,700installs convex waynesutton Routes Convex backend tasks to dedicated builder skills and enforces global rules for queries, mutations, and schemas. Useful as the starting point for any Convex project. CX Codex +1 5,700installs vtex-io-auth-tokens-and-context vtex Decides which VTEX IO token should back a backend request: the app itself, a shopper, or an Admin user. CX Codex +1 1,100installs replica-backend Jakeschincariol Builds the backend of an app clone: auth, database migrations and access rules, Stripe payments, email and background jobs. Reads replica/architecture.md and keeps a checklist in replica/backend.md. CX Codex +1 613installs api-auth-key-management Samuel Berthe Design provider-side API key architecture with checksum prefixes, hashed storage, and zero-downtime rotation. Helpful when managing machine credentials and audit compliance. CX Codex +1 7,800installs backend-security-coder sickn33 Hardens backend application code with allowlist validation, safe database queries, secure cookie handling, and API authentication logic. CX Codex +1 1,000installs

From the same set32

convex-deploy-guard Classifies and announces the target Convex deployment before running mutations. Requires explicit approval for production and enforces read-only session modes. CX Codex +1 36,000installs convex-design This skill designs Convex backends from product requests, covering schemas, functions, auth, files, and LLM workflows. Use it for new or existing Convex projects. CX Codex +1 36,000installs convex-reviewer Walks Convex code through auth, validator, index and reactivity checks. Useful before you ship backend functions. CX Codex +1 36,100installs convex-docs Pins the project's installed Convex version and fetches current markdown docs or checks types instead of generating outdated API calls. CX Codex +1 36,100installs convex-advisor Reads a Convex deployment's 72h insights, root-causes each event in code, and reports fixes ranked by severity. CX Codex +1 35,900installs convex-crons Adds recurring scheduled jobs to Convex applications. Useful when you need to schedule backend maintenance and periodic cleanups. CX Codex +1 36,000installs convex-env This skill sets and wires Convex deployment environment variables and secrets. Use it when actions need deployment-specific values without putting secrets in code. CX Codex +1 36,000installs convex-seed Populates Convex database tables with sample rows or imports external datasets. Useful when preparing dev environments without manual data entry. CX Codex +1 35,800installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor