Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

Convex Component Authoring

A blueprint skill for building, structuring, and publishing reusable Convex components.

Dev & CodingAdvanced40532AI score 7/10Last updated: Feb 6, 2026

What it does

  • Lays out the canonical folder structure for a Convex component (src/index.ts, component.ts, schema.ts, functions/).
  • Provides working code for defineComponent, defineSchema, and queries/mutations with v.* validators and explicit return types.
  • Shows how consuming apps wire it up via defineApp().use(), including multiple named instances.
  • Ships templates for package.json (peerDependencies, files, prepublishOnly) and tsconfig.json for npm publishing.
  • Summarizes five common pitfalls: cross-table references, missing type exports, hardcoded config, no versioning, weak docs.
  • Safety rules: never run npx convex deploy or git commands unless told to.

Who it's for

  • Developers on Convex who want to reuse backend logic across projects.
  • Teams publishing internal or open-source Convex packages to npm.
  • TypeScript devs learning Convex's component table-isolation model.

Usage examples

  1. "Build a rate limiter component" → generates the requests table, checkLimit mutation, and a client-side hook as shown in the skill.
  2. "Extract the notifications logic from my convex folder into its own package" → moves schema/functions, writes index.ts exports and package.json.
  3. "Mount this component twice under different names" → applies app.use(myComponent, { name: "instance1" }).

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-component-authoring/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/convex-component-authoring folder from the GitHub repo waynesutton/convexskills into my ~/.claude/skills/convex-component-authoring/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/waynesutton/convexskills.git /tmp/convexskills && mkdir -p ~/.claude/skills && cp -r /tmp/convexskills/skills/convex-component-authoring ~/.claude/skills/

This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/waynesutton/convexskills.git
  2. Create the skills directory: mkdir -p ~/.claude/skills
  3. Copy just this skill: cp -r convexskills/skills/convex-component-authoring ~/.claude/skills/
  4. Verify that ~/.claude/skills/convex-component-authoring/SKILL.md exists.
  5. Restart Claude Code, open your Convex project, and ask something like "create a reusable Convex component".
  6. Prerequisites: Node.js and the convex package (1.x) in your project; review any deploy commands yourself before running them.
View source on GitHubLicense: Apache-2.0