AgentToolHub
SkillClaude CodeCursorClineOpenClawWindsurfVS CodeChatGPT

convexskills

Builder skills for Convex apps. Convex patterns plus a PRD, task.md, changelog, and files.md workflow for Claude Code, Codex, Cursor, and OpenCode.

Features

  • ✓AI-driven development tools for Convex
  • ✓Structured guidance for Convex development practices
  • ✓Complementary to @convex-dev/eslint-plugin for code quality
  • ✓Supports npm and npx for easy installation
  • ✓Customizable skills and templates for production apps

Installation Guide

npm (recommended)

bash
# 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 all skills to .agents/skills
convex-skills install-all --target agents

# Symlink SKILL.md files instead of copying
convex-skills install-all --target agents --link

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

Or use npx without installing:

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

Programmatic Usage

bash
npm install @waynesutton/convex-skills
javascript
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)

bash
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:

bash
# 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.

If you are working from a repo clone, Codex also auto-discovers skills from .codex/skills at the repo root. You can symlink this repo’s skills/* into .codex/skills so updates flow through without copying.

Standard Agent Skills Path

Some tools are standardizing on .agents/skills for discovery. This repo supports that layout via the CLI:

bash
convex-skills install-all --target agents
convex-skills install-all --target agents --link

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:

bash
# 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.

Reviews