convexskills — Instalar & Demo en vivo

Por qué usarlo

Características clave

12 habilidades específicas de Convex con ejemplos de código real
Cubre funciones (query/mutation/action/HTTP), esquema, tiempo real, cron, almacenamiento de archivos, agentes
Dos habilidades de seguridad: convex-security-check y convex-security-audit
Patrones de migración para la evolución del esquema
convex-component-authoring para componentes reutilizables

Demo en vivo

Cómo se ve en la práctica

convexskills-skill.replay ▶ listo

0/0

Instalación

Repositorio del autor · Documentación oficial de Skills de Claude

Casos de uso

Usos del mundo real: convexskills

Andamiar una nueva aplicación Convex con tiempo real + autenticación + carga de archivos

👤 Desarrolladores full-stack que inician un nuevo proyecto Convex ⏱ ~90 min intermediate

Cuándo usarlo: Estás empezando de cero y quieres patrones correctos de Convex desde el archivo uno.

Requisitos previos

Convex CLI — npm create convex

Flujo

Diseñar el esquema

Usa la habilidad convex-schema-validator. Diseña tablas para usuarios, proyectos y archivos con índices apropiados.✓ Copiado

→ El esquema usa v.id(), índices declarados, relaciones correctas
Conectar consultas y mutaciones

Usa la habilidad convex-functions. Implementa CRUD para proyectos.✓ Copiado

→ Consulta para lecturas, mutación para escrituras, sin mal uso de acciones
Agregar tiempo real + carga de archivos

Usa convex-realtime y convex-file-storage para que los proyectos se actualicen en vivo con archivos adjuntos.✓ Copiado

→ React se suscribe a través de useQuery, archivos almacenados a través de storage.generateUploadUrl

Resultado: Una aplicación Convex correctamente estructurada sobre la que puedas construir.

Errores comunes

Usar acciones donde las mutaciones son suficientes — La habilidad obliga: mutaciones para escrituras en BD, acciones para E/S externa

Agregar un trabajo cron diario que limpie filas antiguas

👤 Desarrolladores de Convex que agregan mantenimiento en segundo plano ⏱ ~20 min beginner

Cuándo usarlo: Necesitas una tarea programada sin ejecutar un worker.

Flujo

Usa la habilidad cron

Usa convex-cron-jobs. Agrega un trabajo diario que elimine filas de más de 30 días de la tabla sesiones.✓ Copiado

→ Entrada crons.ts + mutación interna para la limpieza
Probar

Dame una forma de disparar esto manualmente para pruebas.✓ Copiado

→ Acción HTTP solo para desarrollo o receta CLI

Resultado: Un cron ejecutándose en el planificador administrado de Convex.

Errores comunes

Cron ejecuta una consulta en lugar de una mutación interna — La habilidad obliga mutación interna para eliminaciones

Auditar una aplicación Convex para encontrar agujeros de autorización

👤 Desarrolladores antes de un lanzamiento a producción ⏱ ~45 min advanced

Cuándo usarlo: Tu aplicación está lista pero no has probado la autenticación bajo presión.

Flujo

Ejecutar la auditoría

Usa convex-security-audit en este repo. Verifica que cada mutación pública tenga autenticación adecuada.✓ Copiado

→ Postura de autenticación por función con gravedad
Corregir

Aplica las correcciones con verificaciones de identidad y retorna nulo para lecturas no autorizadas.✓ Copiado

→ Funciones actualizadas con verificaciones ctx.auth

Resultado: Autenticación reforzada antes de producción.

Errores comunes

Confiar en el modelo mental 'public=unauthenticated' — Las funciones públicas de Convex son accesibles desde INTERNET; la habilidad insiste en verificaciones de autenticación

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

convexskills-skill + github

La habilidad diseña + implementa; el MCP de GitHub abre el PR

Usa convexskills para construir la función, luego abre un PR con los cambios.✓ Copiado

convexskills-skill + playwright-skill

Construir backend Convex, luego Playwright prueba la UI de extremo a extremo

Implementa el backend de Convex, luego escribe una prueba playwright-skill que golpee la UI y verifique actualizaciones en tiempo real.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
convex-functions	necesidad de función	Cualquier trabajo de función
convex-schema-validator	modelo de datos	Diseñar o cambiar tablas
convex-realtime	caso de uso de UI	Agregar UI reactiva
convex-cron-jobs	tarea programada	Trabajo periódico en segundo plano
convex-migrations	cambio de esquema	Evolucionar un esquema existente
convex-security-audit	repo	Revisión previa a producción

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno para la habilidad; Convex tiene sus propios niveles gratuito + de pago
Tokens por llamada: 2-6k por habilidad cargada
Monetario: Gratuito — la habilidad es local. Convex tiene un nivel gratuito generoso.
Consejo: Nombra la habilidad específica (por ejemplo, convex-cron-jobs) para evitar cargar el conjunto completo.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales en la habilidad. Las claves de despliegue de Convex permanecen en tu .env.

Salida de datos: Ninguno de la habilidad en sí

Las funciones públicas de Convex son accesibles desde Internet. Siempre ejecuta convex-security-audit antes de ir a producción.

Resolución de problemas

Errores comunes y soluciones

Claude escribe una acción cuando una mutación es suficiente

Regla general que la habilidad obliga: solo BD → mutación; E/S externa → acción.

El cambio de esquema rompe los datos existentes

Usa la habilidad convex-migrations — planifica transiciones seguras con relleno.

useQuery no se actualiza en tiempo real

Verifica la reactividad: la consulta debe leer los datos que cambiaron, no un índice antiguo.

Alternativas

convexskills vs otros

Alternativa	Cuándo usarla	Contrapartida
Documentos de Convex manual + ejemplos	Ya eres un desarrollador experimentado de Convex	Incorporación más lenta sin la habilidad
Habilidades fullstack específicas del framework	No estás en Convex	Stack diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills