{ "schemaVersion": "1.0", "item": { "slug": "convex", "name": "Convex", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/ivangdavila/convex", "canonicalUrl": "https://clawhub.ai/ivangdavila/convex", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/convex", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=convex", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "memory-template.md", "operations-playbook.md", "schema-and-indexes.md", "setup.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/convex" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/convex", "agentPageUrl": "https://openagent3.xyz/skills/convex/agent", "manifestUrl": "https://openagent3.xyz/skills/convex/agent.json", "briefUrl": "https://openagent3.xyz/skills/convex/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Setup", "body": "On first use, read setup.md for integration guidelines." }, { "title": "When to Use", "body": "User is building, debugging, or scaling a Convex backend and needs reliable patterns for data modeling, queries, mutations, actions, auth, and deployments.\n\nThis skill focuses on implementation quality and operational safety, not generic framework tutorials." }, { "title": "Architecture", "body": "Memory lives in ~/convex/. See memory-template.md for structure and status fields.\n\n~/convex/\n|- memory.md # Durable project context and technical decisions\n|- schema-notes.md # Table design and index rationale\n|- rollout-notes.md # Deploy and incident learnings\n`- auth-notes.md # Auth model and permission edge cases" }, { "title": "Quick Reference", "body": "Use the smallest relevant file for the current task.\n\nTopicFileSetup flowsetup.mdMemory templatememory-template.mdSchema and indexesschema-and-indexes.mdDeploy and operationsoperations-playbook.md" }, { "title": "Requirements", "body": "No API keys or external credentials are required by this skill itself.\nTOKEN/KEY: Not required by this skill.\nIf a project uses third-party integrations, treat those credentials as user-managed secrets and never persist raw values in memory files." }, { "title": "Data Storage", "body": "This skill stores reusable context only under ~/convex/:\n\nmemory file for durable project context and decisions\nschema notes for modeling and index rationale\nrollout notes for deployment and incident lessons\nauth notes for permission and boundary edge cases\n\nDo not store secrets, access tokens, or personal data unless the user explicitly requests it." }, { "title": "1. Model Access Patterns Before Writing Schema", "body": "Define tables and indexes from real read paths first:\n\nWhich fields are filtered most often\nWhich sort order is needed\nWhich uniqueness guarantees are required\n\nDo not rely on table scans in production paths." }, { "title": "2. Keep Function Boundaries Strict", "body": "Use each function type for its intended purpose:\n\nQuery: read-only and deterministic\nMutation: validated state changes\nAction: external side effects and network calls\n\nDo not mix external calls inside deterministic data paths." }, { "title": "3. Enforce Auth and Authorization at Every Entry Point", "body": "Treat every query, mutation, action, and HTTP entrypoint as untrusted input:\n\nResolve identity explicitly\nCheck workspace or tenant boundaries\nValidate ownership before returning or mutating records\n\nNever trust client-provided identifiers without server checks." }, { "title": "4. Design Indexes for Stability, Not Just Speed", "body": "Create indexes that match long-term product workflows:\n\nPrimary user lookup paths\nAdmin and backoffice paths\nBackground processing queues\n\nDocument index intent so future changes do not break critical queries." }, { "title": "5. Make Writes Idempotent for Retries", "body": "For webhooks and external callbacks:\n\nUse stable idempotency keys\nUpsert safely when replayed\nRecord processing status\n\nA retry should not create duplicate side effects." }, { "title": "6. Ship with Safe Rollout Discipline", "body": "Before deploying schema or logic changes:\n\nVerify backward compatibility for current clients\nPrepare migration steps for renamed fields or tables\nConfirm failure mode and rollback path\n\nNever deploy unreviewed breaking data changes." }, { "title": "7. Preserve Debuggability in Production", "body": "When fixing incidents:\n\nCapture a minimal reproduction query\nKeep structured logs around actor, function, and record ids\nRecord final root cause and preventive rule in memory\n\nFast diagnosis compounds over time." }, { "title": "Common Traps", "body": "Building schema from entities only, not query paths -> slow reads and rework.\nPutting network side effects in deterministic logic -> nondeterministic failures.\nTreating auth as a UI concern -> cross-tenant data leaks.\nAdding indexes reactively during outages -> unstable rollout under pressure.\nShipping breaking schema changes without migration staging -> runtime failures.\nIgnoring idempotency for callbacks -> duplicate writes and billing errors." }, { "title": "Security & Privacy", "body": "Data that leaves your machine:\n\nNone by default from this skill itself.\n\nData that stays local:\n\nConvex project context and decisions under ~/convex/.\n\nThis skill does NOT:\n\nAutomatically call external services.\nManage or store secrets outside user-approved files.\nApply destructive schema changes without explicit confirmation.\nModify files outside ~/convex/ for memory." }, { "title": "Related Skills", "body": "Install with clawhub install if user confirms:\n\nbackend - Service architecture and operational reliability patterns.\ntypescript - Type-safe design and implementation for app and backend code.\njavascript - Runtime behavior and language-level debugging workflows." }, { "title": "Feedback", "body": "If useful: clawhub star convex\nStay updated: clawhub sync" } ], "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser is building, debugging, or scaling a Convex backend and needs reliable patterns for data modeling, queries, mutations, actions, auth, and deployments.\n\nThis skill focuses on implementation quality and operational safety, not generic framework tutorials.\n\nArchitecture\n\nMemory lives in ~/convex/. See memory-template.md for structure and status fields.\n\n~/convex/\n|- memory.md # Durable project context and technical decisions\n|- schema-notes.md # Table design and index rationale\n|- rollout-notes.md # Deploy and incident learnings\n`- auth-notes.md # Auth model and permission edge cases\n\nQuick Reference\n\nUse the smallest relevant file for the current task.\n\nTopic\tFile\nSetup flow\tsetup.md\nMemory template\tmemory-template.md\nSchema and indexes\tschema-and-indexes.md\nDeploy and operations\toperations-playbook.md\nRequirements\nNo API keys or external credentials are required by this skill itself.\nTOKEN/KEY: Not required by this skill.\nIf a project uses third-party integrations, treat those credentials as user-managed secrets and never persist raw values in memory files.\nData Storage\n\nThis skill stores reusable context only under ~/convex/:\n\nmemory file for durable project context and decisions\nschema notes for modeling and index rationale\nrollout notes for deployment and incident lessons\nauth notes for permission and boundary edge cases\n\nDo not store secrets, access tokens, or personal data unless the user explicitly requests it.\n\nCore Rules\n1. Model Access Patterns Before Writing Schema\n\nDefine tables and indexes from real read paths first:\n\nWhich fields are filtered most often\nWhich sort order is needed\nWhich uniqueness guarantees are required\n\nDo not rely on table scans in production paths.\n\n2. Keep Function Boundaries Strict\n\nUse each function type for its intended purpose:\n\nQuery: read-only and deterministic\nMutation: validated state changes\nAction: external side effects and network calls\n\nDo not mix external calls inside deterministic data paths.\n\n3. Enforce Auth and Authorization at Every Entry Point\n\nTreat every query, mutation, action, and HTTP entrypoint as untrusted input:\n\nResolve identity explicitly\nCheck workspace or tenant boundaries\nValidate ownership before returning or mutating records\n\nNever trust client-provided identifiers without server checks.\n\n4. Design Indexes for Stability, Not Just Speed\n\nCreate indexes that match long-term product workflows:\n\nPrimary user lookup paths\nAdmin and backoffice paths\nBackground processing queues\n\nDocument index intent so future changes do not break critical queries.\n\n5. Make Writes Idempotent for Retries\n\nFor webhooks and external callbacks:\n\nUse stable idempotency keys\nUpsert safely when replayed\nRecord processing status\n\nA retry should not create duplicate side effects.\n\n6. Ship with Safe Rollout Discipline\n\nBefore deploying schema or logic changes:\n\nVerify backward compatibility for current clients\nPrepare migration steps for renamed fields or tables\nConfirm failure mode and rollback path\n\nNever deploy unreviewed breaking data changes.\n\n7. Preserve Debuggability in Production\n\nWhen fixing incidents:\n\nCapture a minimal reproduction query\nKeep structured logs around actor, function, and record ids\nRecord final root cause and preventive rule in memory\n\nFast diagnosis compounds over time.\n\nCommon Traps\nBuilding schema from entities only, not query paths -> slow reads and rework.\nPutting network side effects in deterministic logic -> nondeterministic failures.\nTreating auth as a UI concern -> cross-tenant data leaks.\nAdding indexes reactively during outages -> unstable rollout under pressure.\nShipping breaking schema changes without migration staging -> runtime failures.\nIgnoring idempotency for callbacks -> duplicate writes and billing errors.\nSecurity & Privacy\n\nData that leaves your machine:\n\nNone by default from this skill itself.\n\nData that stays local:\n\nConvex project context and decisions under ~/convex/.\n\nThis skill does NOT:\n\nAutomatically call external services.\nManage or store secrets outside user-approved files.\nApply destructive schema changes without explicit confirmation.\nModify files outside ~/convex/ for memory.\nRelated Skills\n\nInstall with clawhub install if user confirms:\n\nbackend - Service architecture and operational reliability patterns.\ntypescript - Type-safe design and implementation for app and backend code.\njavascript - Runtime behavior and language-level debugging workflows.\nFeedback\nIf useful: clawhub star convex\nStay updated: clawhub sync" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ivangdavila/convex", "publisherUrl": "https://clawhub.ai/ivangdavila/convex", "owner": "ivangdavila", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/convex", "downloadUrl": "https://openagent3.xyz/downloads/convex", "agentUrl": "https://openagent3.xyz/skills/convex/agent", "manifestUrl": "https://openagent3.xyz/skills/convex/agent.json", "briefUrl": "https://openagent3.xyz/skills/convex/agent.md" } }