avoid-feature-creep

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.

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

OpenCode

OpenCode discovers skills from ~/.claude/skills//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.

| Skill | Description |

| ------------------------------------------------------------------------ | ----------------------------------------------------- |

| [convex-best-practices](skills/convex-best-practices/SKILL.md) | Guidelines for building production-ready Convex apps |

| [convex-functions](skills/convex-functions/SKILL.md) | Writing queries, mutations, actions, and HTTP actions |

| [convex-realtime](skills/convex-realtime/SKILL.md) | Patterns for building reactive applications |

| [convex-schema-validator](skills/convex-schema-validator/SKILL.md) | Database schema definition and validation |

| [convex-file-storage](skills/convex-file-storage/SKILL.md) | File upload, storage, and serving |

| [convex-agents](skills/convex-agents/SKILL.md) | Building AI agents with Convex |

| [convex-cron-jobs](skills/convex-cron-jobs/SKILL.md) | Scheduled functions and background tasks |

| [convex-http-actions](skills/convex-http-actions/SKILL.md) | HTTP endpoints and webhook handling |

| [convex-migrations](s