SKILL.md frontmatter wrong

Re-copy .claude/ from the repo.

convex-agent-skillz — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Deep Convex patterns — queries, mutations, actions, HTTP endpoints
Real-time features: presence, streaming, collaborative editing
Durable ops: workflows, queues, scheduled tasks
Auth patterns — universal, plus Clerk and WorkOS specifics
AI agent patterns: threads, tool calling, RAG, persistent message history

라이브 데모

실제 사용 모습

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.

흐름

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
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.

흐름

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
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.

흐름

Model threads

Convex skillz — agent threads table + message history + tool calling metadata.✓ 복사됨

→ Schema that covers streaming, partial messages, and tool-call state
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와 조합해 10배 효율

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
realtime_patterns	feature (presence / streaming / collab)	Real-time features
auth_setup	provider (Clerk / WorkOS / custom)	Wiring auth
durable_ops	workflow intent	Long-running or retry-heavy logic
ai_agent_threads	agent feature description	Agent products on Convex

비용 및 제한

운영 비용

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

Auth patterns assume you configure JWT templates correctly in Clerk/WorkOS — read their docs in addition.

문제 해결

자주 발생하는 오류와 해결

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 docs	You want primary source rather than a curated skill	No in-agent auto-activation
Hand-rolled patterns	You're an experienced Convex dev	You'll reinvent patterns; skill just makes Claude use yours consistently

convex-agent-skillz