convex-suggest

Sugiere el componente Convex adecuado cuando el usuario implementa manualmente un patrón que ya resuelve (crons, sharded-counter, rate-limiter, storage, search, presence, workflow, RAG, prosemirror-sync). Pasivo: sugiere después de la tarea, nunca interrumpe. Nunca instala sin consentimiento.

npx skills add https://github.com/get-convex/agent-skills --skill convex-suggest

Proactively suggest the right Convex component

When you see code or intent that duplicates what a Convex component already does, surface a targeted suggestion: ONE component, WHY (anchored in the user's own code or ask), and a concrete install hint. Never install without explicit consent. Never suggest more than one component at a time unless the user asks.

Workflow

  1. Observe the codeSnippets and userAsk passively — never block the current task to suggest.
  2. Match against the detector rules (see generators/suggest-detector.mjs): email/SMTP → resend; push notifications → expo-push; setInterval/cron → @convex-dev/crons; shared counter increments → @convex-dev/sharded-counter; .collect().length scans → @convex-dev/aggregate; multi-step/long-running actions → @convex-dev/workflow; bounded concurrency → @convex-dev/workpool; rate-limit counters in DB → @convex-dev/rate-limiter; fs.write/S3 uploads → Convex Storage; Elasticsearch/Algolia → built-in full-text search; presence/typing → @convex-dev/presence; Pinecone/external vector DB → @convex-dev/rag; collaborative editing → @convex-dev/prosemirror-sync.
  3. After finishing the current task, offer ONE suggestion: name the component, quote the specific code or phrase that triggered it, explain why the component fits better.
  4. If the user says yes: run /add <component> or follow the installHint from the detector.
  5. If the user says no or ignores it: drop it. Do not repeat the same suggestion.

Rules

  • Passive — never interrupt the current task; surface the suggestion AFTER completing what the user asked.
  • One at a time — pick the highest-priority match; do not dump a list of five components.
  • Cite WHY from the user's own code or ask — 'I noticed you wrote post.likes + 1 in a mutation that many users call concurrently; that causes OCC conflicts at scale.'
  • Never install without explicit consent — suggest, explain, wait for a yes.
  • Do not suggest a component the user has already installed.
  • Do not fire on generic coding questions unrelated to Convex (sorting arrays, writing CSS, etc.).

Más skills de get-convex

convex-performance-audit
get-convex
Audita el rendimiento de Convex en lecturas, suscripciones, contención de escritura y límites de funciones. Úselo para funciones lentas, hallazgos de insights, conflictos OCC o amplificación de lectura.
developmentdatabasedata-analysis
convex
get-convex
Enruta solicitudes generales de Convex a la habilidad de proyecto correcta. Úsalo cuando el usuario pregunte qué habilidad de Convex usar o asigne una tarea de aplicación de Convex poco especificada.
developmentdatabase
convex-setup-auth
get-convex
Configura la autenticación de Convex, el mapeo de identidad y el control de acceso. Úsalo para inicio de sesión, proveedores de autenticación, tablas de usuarios, funciones protegidas o roles en una aplicación de Convex.
developmentdatabaseapi
convex-quickstart
get-convex
Crea o añade Convex a una aplicación. Se usa para nuevos proyectos de Convex, npm create convex@latest, configuración del frontend, variables de entorno, o la primera ejecución de npx convex dev.
developmentdatabase
convex-migration-helper
get-convex
Planifica migraciones de esquemas y datos de Convex con widen-migrate-narrow y @convex-dev/migrations. Úsalo para cambios de esquema disruptivos, rellenos de datos, remodelación de tablas o implementaciones sin tiempo de inactividad.
developmentdatabase
convex-create-component
get-convex
Construye componentes reutilizables de Convex con tablas aisladas y APIs orientadas a la aplicación. Úselo para nuevos componentes, módulos de backend reutilizables, integraciones o trabajo en límites de componentes.
developmentdatabase
convex-migrate
get-convex
Migra el esquema y rellena datos en una app de Convex desplegada usando @convex-dev/migrations.
developmentdatabase
convex-optimize
get-convex
Auditar y optimizar una aplicación Convex existente: seguridad, escala, actualizaciones, observabilidad.