.cursor/skills/create-prd/SKILL.md
# Create a PRD Use this skill before any multi-file feature, architectural decision, or complex bug fix. Activate with: `@create-prd` ## Location and naming - All PRDs live in `prds/` folder - File name: `prds/<feature-or-problem-slug>.md` - Extension is always `.md`, not `.prd` - Use kebab-case for the filename (e.g., `prds/adding-email-auth.md`) ## Template Copy and fill in this template: ```markdown # [Feature or problem name] Created: YYYY-MM-DD HH:mm UTC Last Updated: YYYY-MM-DD HH:
npx skillsauth add get-convex/components-submissions-directory .cursor/skills/create-prdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill before any multi-file feature, architectural decision, or complex bug fix.
Activate with: @create-prd
prds/ folderprds/<feature-or-problem-slug>.md.md, not .prdprds/adding-email-auth.md)Copy and fill in this template:
# [Feature or problem name]
Created: YYYY-MM-DD HH:mm UTC
Last Updated: YYYY-MM-DD HH:mm UTC
Status: Draft | In Progress | Done
## Summary
1-2 sentence description of what this is and why it matters.
## Problem
What is broken or missing. Include symptoms, error messages, or user-facing impact.
## Root cause (for bugs)
What actually caused it. Do not skip this for bugs.
## Proposed solution
How to fix or build it. Be specific about the approach chosen and why.
## Files to change
- `path/to/file.ts` - what changes and why
- `convex/schema.ts` - if schema changes are needed
## Edge cases and gotchas
Anything non-obvious that came up during analysis. This section saves the next session.
## Verification
How to confirm the fix or feature works:
- [ ] Step 1
- [ ] Step 2
## Task completion log
- [ ] Task name completed (YYYY-MM-DD HH:mm UTC)
## Related
Links to related PRDs, issues, or external docs if any.
TASK.md under ## To Do as checkable itemsLast Updated current as tasks move forwarddevelopment
Debug and troubleshoot WorkOS AuthKit authentication issues with Convex. Use when authentication fails, JWT validation errors occur, user identity returns null, email claims are missing, admin access checks fail, or sign in button does not work. Supports Netlify deployment.
development
Set up and configure WorkOS AuthKit authentication with Convex backend. Use when integrating AuthKit, configuring JWT providers, setting up environment variables, or implementing sign in and sign out flows with React and Vite. Supports Netlify deployment.
documentation
# Update project docs Use this skill after completing any feature, fix, or migration to keep the three core project tracking files in sync. Activate with: `@update-project-docs` ## Step 1: Get real dates Run this first: ```bash git log --date=short -n 10 ``` Use actual commit dates. Never use placeholder dates or future months. ## Step 2: Update TASK.md Move completed items into `## Completed` with date and time: ```markdown - [x] Feature name (YYYY-MM-DD HH:mm UTC) - [x] Sub-task det
development
Patterns for scaling read-heavy Convex apps to millions of users. Use when optimizing bandwidth, reducing query costs, fixing slow queries, creating digest tables, replacing reactive subscriptions with one-shot fetches, adding compound indexes, debouncing writes, rate-controlling backfills, or running npx convex insights. Trigger when users mention "scale", "bandwidth", "performance", "optimize", "slow queries", "expensive queries", "digest table", "denormalize", or "thundering herd" in the context of Convex.