/ ディレクトリ / プレイグラウンド / convex-agent-skillz
← 全サーバー ↗ GitHub
● コミュニティ PolarCoding85 ⚡ 即起動

convex-agent-skillz

作者 PolarCoding85 · PolarCoding85/convex-agent-skillz

Convexバックエンドの知識をそのまま提供 — クエリ、ミューテーション、リアルタイムプレゼンス、ワークフロー、認証（Clerk/WorkOS）、AIエージェントパターンがコンテキストに応じて自動ロードされます。

PolarCoding85/convex-agent-skillz は、Convex全般にわたる深い専門知識をClaudeに付与します：クエリ/ミューテーション/アクション/HTTPエンドポイント、スキーマ＋インデックス設計、リアルタイム機能（プレゼンス、ストリーミング、共同編集）、永続オペレーション（ワークフロー、キュー、スケジュール）、認証（ユニバーサル＋Clerk＋WorkOS）、AI統合（エージェントスレッド、ツール呼び出し、RAG、メッセージ履歴）。コンテキストアウェア — convex/ ディレクトリでの作業時に convex-expert エージェントが自動的に有効化され、Rate Limiter や Stripe などのコンポーネントを参照すると対応するパターンがロードされます。

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

convex-agent-skillz-skill.replay ▶ 準備完了
0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： convex-agent-skillz

既存のConvexアプリにリアルタイムプレゼンスを追加する

👤 コラボレーション機能を追加したいConvex開発者 ⏱ ~45 min intermediate

使うタイミング： アプリがあり、ソケットサーバーを立てずにFigmaのような「誰がいるか」インジケーターを実装したい場合。

フロー
  1. 機能を説明する
    Using the Convex skillz — add presence to the documents page. Show cursors and usernames.✓ コピーしました
    → Claudeがカスタム WebSocket ではなく、Convexのプレゼンスパターン（ミューテーション＋リアクティブクエリ）で実装する
  2. 切断時の処理
    What about cleanup when users close the tab?✓ コピーしました
    → Convexの慣例に沿った、古いプレゼンスのクリーンアップ戦略

結果： 適切なクリーンアップを備えた動作するプレゼンス機能。

注意点
  • Convexのリアクティビティと競合するカスタムプレゼンスパターン — スキルが慣用的なバージョンへ誘導します。明確な理由なくオーバーライドしないでください
組み合わせ： filesystem

Clerk認証をConvexに正しく統合する

👤 新規または既存のConvexアプリにClerkを組み込む開発者 ⏱ ~30 min intermediate

使うタイミング： Clerkを選択し、Convexとの統合を最初から正しく設定したい場合。

フロー
  1. プロバイダーを接続する
    Convex skillz — integrate Clerk auth with Convex. Set up the JWT template and the Convex auth config.✓ コピーしました
    → Claudeが正しいClerk JWTテンプレート名と auth.config.ts のセットアップを参照する
  2. クエリを保護する
    Now gate the documents query so only the owner can read.✓ コピーしました
    → ctx.auth.getUserIdentity() パターンと適切なアイデンティティチェック

結果： コードレビューに合格し、テナント間でデータが漏洩しない認証。

Convex上で永続スレッドを持つAIエージェントを構築する

👤 チャットまたはエージェントプロダクトを開発する開発者 ⏱ ~90 min advanced

使うタイミング： セッションをまたいで保持されるスレッド化されたメッセージ履歴が必要な場合。

フロー
  1. スレッドをモデリングする
    Convex skillz — agent threads table + message history + tool calling metadata.✓ コピーしました
    → ストリーミング、部分メッセージ、ツール呼び出し状態をカバーするスキーマ
  2. ストリーミングを接続する
    Stream the assistant response back via a reactive query.✓ コピーしました
    → Convexのリアクティビティを活用した部分メッセージパターン

結果： スケール可能なConvexネイティブのエージェントスレッドレイヤー。

組み合わせ

他のMCPと組み合わせて10倍の力を

convex-agent-skillz-skill + github

Convexの慣例に沿ったdiffで機能追加のPRを作成する

Implement the presence feature, commit and open PR with the Convex skill patterns noted.✓ コピーしました
convex-agent-skillz-skill + filesystem

スキーマ、関数、UIを1セッションで横断的に作業する

Update convex/schema.ts, add the mutation, and wire up the React hook.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
queries_mutations_actions feature intent convex/ での全般的な作業 0
realtime_patterns feature (presence / streaming / collab) リアルタイム機能 0
auth_setup provider (Clerk / WorkOS / custom) 認証の接続 0
durable_ops workflow intent 長時間実行またはリトライが多いロジック 0
ai_agent_threads agent feature description Convex上のエージェントプロダクト 0

コストと制限

運用コスト

APIクォータ
スキル自体からのAPI消費なし
呼び出しあたりのトークン
中程度 — パターンはコンテキストに応じて必要時にロードされます
金額
無料 — スキルはローカルファイルです。Convex自体には独自の料金体系があります。
ヒント
スキルはグローバルではなくプロジェクトの .claude/ に配置してください — 自動有効化はプロジェクトスコープで最も効果的に機能します。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： スキル内にクレデンシャルはありません。認証プロバイダーのシークレットはご自身の環境変数に保持されます。
データ送信先： スキルからのデータ送出なし — コードはローカルに留まります

トラブルシューティング

よくあるエラーと対処法

スキルが呼び出されない — ClaudeがConvexの慣用的でないコードを生成する

「use the Convex skillz」と明示するか、convex/ ディレクトリ内で作業していることを確認してください。

確認： ls <project>/.claude/agents/convex-expert.md
Wrong trigger keywords — 認証パターンが指定のプロバイダーを使用しない

プロバイダー名を明示的に指定してください（「with Clerk」/「with WorkOS」）。

代替案

convex-agent-skillz 他との比較

代替案代わりに使う場面トレードオフ
Convex official docs厳選されたスキルではなく一次情報を参照したい場合エージェント内での自動有効化なし
Hand-rolled patternsConvexの経験が豊富な開発者の場合パターンを自前で再実装することになります。スキルはClaudeがあなたのパターンを一貫して使うようにするだけです

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る