convexskills — Instalar & Demo ao vivo

Por que usar

Principais recursos

12 Convex-specific skills with real code examples
Covers functions (query/mutation/action/HTTP), schema, realtime, cron, file storage, agents
Two security skills: convex-security-check and convex-security-audit
Migration patterns for schema evolution
convex-component-authoring for reusable components

Demo ao vivo

Como fica na prática

convexskills-skill.replay ▶ pronto

0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: convexskills

Scaffold a new Convex app with realtime + auth + file uploads

👤 Full-stack devs starting a new Convex project ⏱ ~90 min intermediate

Quando usar: You're starting fresh and want correct Convex patterns from file one.

Pré-requisitos

Convex CLI — npm create convex

Fluxo

Design the schema

Use the convex-schema-validator skill. Design tables for users, projects, and files with proper indices.✓ Copiado

→ Schema uses v.id(), indices declared, relationships correct
Wire queries and mutations

Use the convex-functions skill. Implement CRUD for projects.✓ Copiado

→ Query for reads, mutation for writes, no action misuse
Add realtime + file uploads

Use convex-realtime and convex-file-storage to make projects live-update with file attachments.✓ Copiado

→ React subscribes via useQuery, files stored via storage.generateUploadUrl

Resultado: A correctly-structured Convex app you can build on.

Armadilhas

Using actions where mutations suffice — Skill enforces: mutations for DB writes, actions for external I/O

Add a daily cron job that cleans up stale rows

👤 Convex devs adding background maintenance ⏱ ~20 min beginner

Quando usar: You need a scheduled task without spinning up a worker.

Fluxo

Use the cron skill

Use convex-cron-jobs. Add a daily job that deletes rows older than 30 days from table sessions.✓ Copiado

→ crons.ts entry + internal mutation for the cleanup
Test

Give me a way to trigger this manually for testing.✓ Copiado

→ Dev-only HTTP action or CLI recipe

Resultado: A cron running on Convex's managed scheduler.

Armadilhas

Cron runs a query instead of internal mutation — Skill enforces internal mutation for deletes

Audit a Convex app for authorization holes

👤 Devs before a production launch ⏱ ~45 min advanced

Quando usar: Your app is ready but you haven't pressure-tested auth.

Fluxo

Run the audit

Use convex-security-audit on this repo. Check every public mutation for proper auth.✓ Copiado

→ Per-function auth posture with severity
Fix

Apply the fixes with identity checks and fallback to return null for unauthorized reads.✓ Copiado

→ Functions updated with ctx.auth checks

Resultado: Auth tightened before production.

Armadilhas

Relying on 'public=unauthenticated' mental model — Convex public functions are INTERNET-reachable; skill insists on auth checks

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

convexskills-skill + github

Skill designs + implements; GitHub MCP opens the PR

Use convexskills to build the feature, then open a PR with the changes.✓ Copiado

convexskills-skill + playwright-skill

Build Convex backend, then Playwright tests the UI end-to-end

Implement the Convex backend, then write a playwright-skill test that hits the UI and verifies realtime updates.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
convex-functions	function need	Any function work
convex-schema-validator	data model	Designing or changing tables
convex-realtime	UI use case	Adding reactive UI
convex-cron-jobs	scheduled task	Periodic background work
convex-migrations	schema change	Evolving an existing schema
convex-security-audit	repo	Pre-production review

Custo e limites

O que custa rodar

Cota de API: None for the skill; Convex has its own free + paid tiers
Tokens por chamada: 2-6k per skill loaded
Monetário: Free — skill is local. Convex has a generous free tier.
Dica: Name the specific skill (e.g. convex-cron-jobs) to avoid loading the full set.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials in the skill. Convex deploy keys stay in your .env.

Saída de dados: None from the skill itself

Convex public functions are Internet-reachable. Always run convex-security-audit before going to production.

Solução de problemas

Erros comuns e correções

Claude writes an action when a mutation suffices

Rule of thumb the skill enforces: DB-only → mutation; external I/O → action.

Schema change breaks existing data

Use convex-migrations skill — it plans safe transitions with backfill.

useQuery doesn't update in realtime

Check reactivity: the query must read the data that changed, not a stale index.

Alternativas

convexskills vs. outros

Alternativa	Quando usar	Troca
Manual Convex docs + examples	You're already an experienced Convex dev	Slower onboarding without the skill
Framework-specific fullstack skills	You're not on Convex	Different stack

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills