Convex (unofficial) Skills v1

A collection of AI-consumable skills for building production-ready applications with Convex, following the Agent Skills open format.

Overview

This repository contains skills that help AI assistants understand and implement Convex best practices. Each skill provides structured guidance for specific aspects of Convex development.

Installation

npm (recommended)

# Install globally for CLI access
npm install -g @waynesutton/convex-skills

# List available skills
convex-skills list

# Install a specific skill to your project
convex-skills install convex-best-practices

# Install all skills
convex-skills install-all

# Install templates (CLAUDE.md + skill templates)
convex-skills install-templates

Or use npx without installing:

npx @waynesutton/convex-skills list
npx @waynesutton/convex-skills install-all

Programmatic Usage

npm install @waynesutton/convex-skills

import { listSkills, getSkill, SKILLS } from "@waynesutton/convex-skills";

// List all skills
console.log(listSkills());

// Get a specific skill's content
const content = getSkill("convex-best-practices");

Claude Code (from local clone)

git clone https://github.com/waynesutton/convexskills.git
cd convexskills
# Point Claude Code to this directory

Codex

Follow the Codex skills guide and place the skill under $CODEX_HOME/skills:

# From the repo root
# Defaults to ~/.codex if CODEX_HOME is unset
cp -r skills/convex-best-practices "$CODEX_HOME/skills/"

Codex will auto-discover SKILL.md files in that directory on the next start.

OpenCode

OpenCode discovers skills from ~/.claude/skills/<name>/SKILL.md automatically. See OpenCode Skills docs for more details.

Slash Command

This repo includes a /convex slash command for OpenCode. Install the command by copying command/convex.md to your OpenCode commands directory:

# Copy the slash command
cp command/convex.md ~/.opencode/command/

# Usage in OpenCode
/convex create a schema with users and posts
/convex set up file uploads
/convex add a Stripe webhook endpoint

The slash command provides decision trees to route to the appropriate skill based on your task.

Manual Installation

Copy the desired skill's SKILL.md file to your project's .claude/skills/ directory.

Available Skills

Repository Structure

convex-skills/
├── skills/                   # Core Convex skills for AI agents
│   ├── convex-best-practices/
│   │   └── SKILL.md
│   ├── convex-functions/
│   │   └── SKILL.md
│   ├── convex-cron-jobs/
│   │   └── SKILL.md
│   └── ...
├── command/                  # Slash command definitions (OpenCode)
│   └── convex.md             # /convex command entrypoint
├── templates/                # Templates for forking developers
│   ├── CLAUDE.md             

...