AutoGineer
Generated banner for Convex Add
Generated logo for Convex Add

Convex Add

ConvexOfficialPublished by Convex

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • No issues found
Download ZIP

From the author

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.
— the description by Convex

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The convex-add skill provides a structured workflow for extending existing Convex applications with new features. It prioritizes a live, served capability catalog to ensure procedures remain current without requiring plugin updates. If a specific capability is not found in the catalog or the service is unreachable, the skill gracefully falls back to legacy methods, including automated static hosting setup or component searching via the @convex-dev ecosystem.

What it does

  • Consults a live capability catalog to identify the correct procedure for adding features.
  • Executes specific installation procedures based on retrieved capability documentation.
  • Falls back to automated static hosting configuration for hosting-related requests.
  • Uses component search scripts to identify and install relevant @convex-dev components.
  • Confirms successful additions by providing relevant URLs or component identifiers to the user.

When to use it

  • When you need to add new backend functionality like authentication, cron jobs, or search to a Convex app.
  • When you want to deploy static hosting for your Convex project.
  • When you are looking for the most up-to-date installation procedure for a specific Convex capability.
  • When you need to integrate third-party components from the @convex-dev ecosystem.

Advantages

  • Ensures procedures are always current by fetching them from a live catalog.
  • Reduces manual configuration effort by automating the installation and wiring process.
  • Provides a robust fallback mechanism to ensure functionality even if the primary catalog is unavailable.
  • Maintains consistency by using standardized component search and installation workflows.

Usage examples

“/add auth”
The agent identifies the authentication capability from the catalog and executes the required setup steps for your Convex app.
“I need to add hosting to my project.”
The agent triggers the static hosting workflow, configuring the necessary @convex-dev/static-hosting components.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/convex/convex-add/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip convex-add.zip -d .agents/skills

Documentation by Convex

<!-- 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.

Files

ATTRIBUTION.md

Attribution

This folder is an unmodified copy of the Agent Skill "convex-add", distributed by AutoGineer (https://autogineer.com/agent-skills).

The skill's own files are unmodified copies. AutoGineer is not affiliated with or endorsed by the author or the publisher.

Files added by AutoGineer

  • ATTRIBUTION.md: this file, written by AutoGineer

  • LICENSE: copied from LICENSE

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Convex
Publisher
Convex (Official)
Source
convex/agent-skills · skills/convex-add · commit f60629d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Convex.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download convex-add.zip