help

Guide Convex development through a five-step reflection-first problem-solving workflow.

9|3|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/get-convex/components-submissions-directory --skill help-get-convex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: help
Source: https://github.com/get-convex/components-submissions-directory/tree/main/.claude/skills/help
Command: npx skills add https://github.com/get-convex/components-submissions-directory --skill help-get-convex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reflection-first problem-solving methodology that helps Convex developers diagnose root causes before coding, reducing wasted effort and boosting code quality.

Core Features & Use Cases

  • Reflective decision framework: five-step approach (Reflect, Identify, Theorize, Distill, Proceed) to guide debugging and design.
  • Enforces scope discipline and changelog awareness to minimize risk.
  • Comprehensive guidelines for Convex development, including mutations, authentication, and documentation practices.

Quick Start

Describe the current issue in your Convex project and run the five-step reflection process before implementing a solution.

Frequently Asked Questions about help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is reflection-first problem solving in Convex development?

A structured debugging workflow for Convex uses a five-step reflection process to enforce root-cause analysis, scope discipline, and changelog awareness before implementing any code changes.

How do I debug a Convex mutation using a structured workflow?

To debug a Convex mutation, apply the five-step reflection process: reflect on the issue, identify the root cause, theorize a fix, distill scoped changes, and proceed with implementation while enforcing strict change-scope rules.

What's the best way to plan feature implementation across Convex apps?

The best way to plan feature implementation across Convex apps is using a reflection-first approach that enforces root-cause analysis, scoped changes, and documentation guidance to minimize risk before proceeding.

Does this reflection workflow work with existing Convex authentication and documentation practices?

Yes, the reflection workflow integrates with existing Convex authentication and documentation practices by enforcing comprehensive guidelines, scoped changes, and strict adherence to change-scope rules during development.

Why should I identify root causes before coding in Convex?

Identifying root causes before coding in Convex reduces wasted effort and boosts code quality by enforcing scope discipline, changelog awareness, and strict adherence to the 98% confidence and change-scope rules.

When should I not use a reflection-first debugging approach for Convex?

You should avoid reflection-first debugging for Convex when addressing trivial syntax fixes or immediate production outages where rapid patching takes priority over structured root-cause analysis and scope discipline.