convex-runtime
Implement Convex runtime features: HTTP actions, file storage, search (full text + vector), scheduling (crons + scheduled functions), and RAG patterns. Use for webhooks, uploads, search indexes, vectorSearch actions, and background workflows. Use proactively when users mention HTTP endpoints, files, search, embeddings, or cron/schedule. Examples: - user: "Add full text search" → define searchIndex + withSearchIndex query - user: "Upload files" → generate upload URL and persist storageId - user: "Vector search" → action with ctx.vectorSearch and doc fetch - user: "Run cleanup nightly" → cronJobs + function reference
How do I install this agent skill?
npx skills add https://github.com/igorwarzocha/opencode-workflows --skill convex-runtimeIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions and patterns for implementing standard Convex runtime features such as HTTP actions, file storage, full-text and vector search, and task scheduling. All external references point to official documentation, and no malicious patterns or security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Runtime Operations
- HTTP actions: define handlers with
httpAction, register inconvex/http.tsviahttpRouter(default export REQUIRED). - HTTP Syntax:
http.route({ path: "/api/echo", // Exact path method: "POST", handler: httpAction(async (ctx, req) => { const body = await req.bytes(); return new Response(body, { status: 200 }); }), }); - HTTP actions MUST be exposed at
https://<deployment>.convex.site. - Upload URL flow: generate URL mutation → client POST → store
storageId; URLs expire after 1 hour. - HTTP upload flow:
ctx.storage.store(blob)then mutation. Uploads via HTTP actions are limited to 20MB. - Serving files:
ctx.storage.getUrl(storageId)in queries/mutations; returns signed URL ornull. - File metadata:
ctx.db.system.get("_storage", id)orquery("_storage");storage.getMetadata()is deprecated. - Scheduling:
ctx.scheduler.runAfter/runAt; cron jobs inconvex/crons.tsusingcronJobs(). - Cron Scheduling: You MUST use
crons.intervalorcrons.cron. You MUST NOT use deprecated helpers likecrons.hourly,crons.daily, orcrons.weekly. - Cron internal calls: If a cron calls an internal function, You MUST import the
internalobject from_generated/apito reference it, even if defined in the same file.
Core Rules
- HTTP actions MUST be routed only via
convex/http.tsdefault export. - HTTP actions MUST parse
Requestmanually as they do not support validators. - Search Example:
const messages = await ctx.db.query("messages") .withSearchIndex("search_body", (q) => q.search("body", "hello hi").eq("channel", "#general") ).take(10); - Vector search MUST be actions-only; results are non-reactive.
- Search behavior: full text search is relevance-ordered and uses prefix matching on the final term; fuzzy matches are deprecated.
- You SHOULD prefer search/vector filters in index definitions and query filters.
- Scheduled functions MUST remain backward compatible with args.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/igorwarzocha/opencode-workflows/convex-runtime">View convex-runtime on skillZs</a>