/ Каталог / Песочница / convex-agent-skillz
● Сообщество PolarCoding85 ⚡ Сразу

convex-agent-skillz

автор PolarCoding85 · PolarCoding85/convex-agent-skillz

Drop-in Convex backend knowledge — queries, mutations, real-time presence, workflows, auth (Clerk/WorkOS), and AI agent patterns auto-load by context.

PolarCoding85/convex-agent-skillz gives Claude deep expertise across Convex: queries/mutations/actions/HTTP endpoints, schema + indexing, real-time features (presence, streaming, collab editing), durable operations (workflows, queues, schedules), auth (universal + Clerk + WorkOS), AI integration (agent threads, tool calling, RAG, message history). Context-aware — working in convex/ auto-activates the convex-expert agent; referencing components like Rate Limiter or Stripe loads the matching pattern.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

convex-agent-skillz-skill.replay ▶ готово
0/0

Установка

Репозиторий автора · Официальная документация Claude Skills

Сценарии использования

Реальные сценарии: convex-agent-skillz

Add real-time presence to an existing Convex app

👤 Convex devs adding collab features ⏱ ~45 min intermediate

Когда использовать: You have an app and want Figma-style 'who's here' indicators without running a socket server.

Поток
  1. Describe the feature
    Using the Convex skillz — add presence to the documents page. Show cursors and usernames.✓ Скопировано
    → Claude implements with Convex's presence pattern (mutation + reactive query), not a custom WebSocket
  2. Handle disconnection
    What about cleanup when users close the tab?✓ Скопировано
    → Specific stale-presence cleanup strategy aligned with Convex conventions

Итог: Working presence with proper cleanup.

Подводные камни
  • Custom presence pattern that fights Convex's reactivity — Skill steers you toward the idiomatic version; don't override without a reason
Сочетать с: filesystem

Integrate Clerk auth with Convex properly

👤 Devs wiring Clerk into a new or existing Convex app ⏱ ~30 min intermediate

Когда использовать: You picked Clerk and want its Convex integration right the first time.

Поток
  1. Wire the provider
    Convex skillz — integrate Clerk auth with Convex. Set up the JWT template and the Convex auth config.✓ Скопировано
    → Claude references the right Clerk JWT template name and auth.config.ts setup
  2. Protect queries
    Now gate the documents query so only the owner can read.✓ Скопировано
    → ctx.auth.getUserIdentity() pattern with proper identity check

Итог: Auth that passes code review and doesn't leak across tenants.

Build an AI agent with persistent threads on Convex

👤 Devs building chat or agent products ⏱ ~90 min advanced

Когда использовать: You want threaded message history that survives across sessions.

Поток
  1. Model threads
    Convex skillz — agent threads table + message history + tool calling metadata.✓ Скопировано
    → Schema that covers streaming, partial messages, and tool-call state
  2. Hook up streaming
    Stream the assistant response back via a reactive query.✓ Скопировано
    → Partial-message pattern leveraging Convex's reactivity

Итог: A Convex-native agent thread layer ready to scale.

Комбинации

Сочетайте с другими MCP — эффект x10

convex-agent-skillz-skill + github

Open PRs for feature additions with Convex-conventional diffs

Implement the presence feature, commit and open PR with the Convex skill patterns noted.✓ Скопировано
convex-agent-skillz-skill + filesystem

Work across schema, functions, and UI in one session

Update convex/schema.ts, add the mutation, and wire up the React hook.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
queries_mutations_actions feature intent Any convex/ work 0
realtime_patterns feature (presence / streaming / collab) Real-time features 0
auth_setup provider (Clerk / WorkOS / custom) Wiring auth 0
durable_ops workflow intent Long-running or retry-heavy logic 0
ai_agent_threads agent feature description Agent products on Convex 0

Стоимость и лимиты

Во что обходится

Квота API
None from the skill
Токенов на вызов
Moderate — patterns load as needed by context
Деньги
Free — skills are local files. Convex itself has its own pricing.
Совет
Place skill in project .claude/ rather than global — auto-activation works best scoped to the project.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: No credentials in the skill. Your auth provider secrets live in your own env.
Исходящий трафик: None from the skill — code stays local

Устранение неполадок

Частые ошибки и исправления

Skill not invoked — Claude writes non-Convex-idiomatic code

Say 'use the Convex skillz' or ensure you're working inside convex/ directory.

Проверить: ls <project>/.claude/agents/convex-expert.md
Wrong trigger keywords — auth pattern doesn't use your provider

Name the provider explicitly ('with Clerk' / 'with WorkOS').

Альтернативы

convex-agent-skillz в сравнении

АльтернативаКогда использоватьКомпромисс
Convex official docsYou want primary source rather than a curated skillNo in-agent auto-activation
Hand-rolled patternsYou're an experienced Convex devYou'll reinvent patterns; skill just makes Claude use yours consistently

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills