etanhey/convex
skills/golem-powers/convex/SKILL.md
Manage Convex backend operations including dev server lifecycle, cloud deployments, function execution, schema management, and data import/export. Wraps the npx convex CLI with project-specific configuration. Includes workflows for starting local dev, deploying to production, running one-off functions, exporting/importing data snapshots, and managing environment variables. Use when starting a Convex dev server, deploying backend changes, running mutations or queries, managing Convex schema, or debugging Convex function errors. Triggers on 'convex', 'backend deploy', 'run function', 'schema change', 'convex dev'. NOT for: Supabase or Firebase operations (use respective tools), frontend-only React work, or general database queries.
$ install --global
skillsauthnpx skillsauth add etanhey/golems convexInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 3:41 AM159.4s16 files scanned
SKILL.md
- name:
- convex
- description:
- Manage Convex backend operations including dev server lifecycle, cloud deployments, function execution, schema management, and data import/export. Wraps the npx convex CLI with project-specific configuration. Includes workflows for starting local dev, deploying to production, running one-off functions, exporting/importing data snapshots, and managing environment variables. Use when starting a Convex dev server, deploying backend changes, running mutations or queries, managing Convex schema, or debugging Convex function errors. Triggers on 'convex', 'backend deploy', 'run function', 'schema change', 'convex dev'. NOT for: Supabase or Firebase operations (use respective tools), frontend-only React work, or general database queries.
Convex Operations
Backend skill wrapping
npx convexCLI. Routes to workflows for specific operations.
Project Detection
Run first to verify you're in a Convex project:
[ -d "convex" ] && echo "Convex project detected" || echo "ERROR: No convex/ directory found"
If no convex/ directory: Run npx convex init to initialize.
Quick Actions
| What you want to do | Workflow | |---------------------|----------| | Start dev server | workflows/dev.md | | Deploy to production | workflows/deploy.md | | Run a Convex function | workflows/run-function.md | | Export data | workflows/data-export.md | | Import data | workflows/data-import.md | | Inspect/validate schema | workflows/schema.md | | Delete user and all data | workflows/user-deletion.md | | Fix errors | workflows/troubleshooting.md |
Available Scripts
Execute directly - they handle errors and edge cases:
| Script | Purpose | Usage |
|--------|---------|-------|
| scripts/dev.sh | Start dev server with auto-cleanup | bash ~/.claude/commands/convex/scripts/dev.sh [--deployment <name>] |
| scripts/deploy.sh | Deploy to production | bash ~/.claude/commands/convex/scripts/deploy.sh [--1p] [--dry-run] |
| scripts/run-function.sh | Execute queries/mutations/actions | bash ~/.claude/commands/convex/scripts/run-function.sh api:funcName [--args '{}'] |
| scripts/export-data.sh | Export database backup | bash ~/.claude/commands/convex/scripts/export-data.sh [--path <file>] |
| scripts/import-data.sh | Import data (with safety prompts) | bash ~/.claude/commands/convex/scripts/import-data.sh --path <file.zip> |
Common Commands Reference
# Development
npx convex dev # Start dev server with hot reload
# Deployment
npx convex deploy # Deploy to production
# Functions
npx convex run api:functionName # Run a function
npx convex run api:func --arg '{"key":"value"}' # With arguments
# Data
npx convex export --path ./backup.zip # Export all data
npx convex import --path ./backup.zip # Import data
# Environment
npx convex env list # List env vars
npx convex env set KEY=value # Set env var
npx convex env get KEY # Get env var
# Other
npx convex dashboard # Open dashboard in browser
npx convex codegen # Regenerate types
npx convex logs --name prod # View production logs
Safety Rules
- Always check project - Verify
convex/directory exists before running commands - Deploy key for CI - Production deploys need
CONVEX_DEPLOY_KEY(see deploy workflow) - Backup before import - Always export before importing data
- Review schema changes - Schema migrations can be destructive
🚨 CRITICAL: Auto-Clean Before Any Convex Command
ALWAYS prefix Convex commands with this cleanup:
rm -f convex/*.js 2>/dev/null; npx convex dev
The "Two output files" Error
If you see:
✘ [ERROR] Two output files share the same path but have different contents: out/auth.js
Cause: Orphan .js files in convex/ folder (from git worktrees, crashes, or manual operations).
Fix: rm -f convex/*.js then retry.
Prevention: Always use the cleanup prefix. Only .ts files belong in convex/.
See workflows/troubleshooting.md for details.
Related Skills
etanhey/writing-skills
development
VerifiedTrustedCommunity
Create, edit, and verify golem-powers skills using the standard SKILL.md structure, workflow files, adapters, templates, and eval fixtures. Use for new skills, structural edits, workflows/adapters, and pre-deploy validation. NOT for invoking existing skills, superpowers skills, or skill-creator agent workflows.
3SKILL.mdUpdated Jun 4, 2026
etanhey/video-extract
testing
VerifiedTrustedCommunity
Extract structured knowledge from any video source — YouTube URLs or local screen recordings. YouTube → gems workflow (yt-dlp transcript → keyword hotspots → frame extract → brain_digest → structured gems). Screen recordings → QA workflow (reuses /qa-video stalker pipeline). Use when user shares a YouTube link wanting deep extraction with frames, shares a .mov/.mp4 for QA processing, says "extract from video", "video gems", "process this recording", or mentions gem extraction from video content.
3SKILL.mdUpdated Jun 4, 2026
etanhey/monitor-loop
testing
VerifiedTrustedCommunity
Use when running or reviewing any recurring monitor loop for merge queues, worker queues, collab tails, or agent completion. Enforces drive-to-completion ticks: every tick must query live state with `!`, classify whether real progress happened, and then dispatch, verify-and-decrement, or escalate-park. Triggers on: monitor loop, /loop, recurring tick, keep monitoring, silent autonomous, merge gate, blocked review, no-progress loop.
3SKILL.mdUpdated Jun 4, 2026
etanhey/mehayom
tools
VerifiedTrustedCommunity
MeHayom freelance client management — daily updates, decision tracking, time logging. Use when drafting Yuval updates, logging scope changes, tracking hours, or any MeHayom client communication. Triggers: 'draft Yuval update', 'client update', 'daily update', 'log decision', 'track time', 'mehayom'.
3SKILL.mdUpdated Jun 4, 2026