velt-chat-sdk-adapter-best-practices
Velt Chat SDK Adapter implementation patterns and best practices for building bots that integrate with Velt comment threads. Use when building a bot (greeting bot, AI bot, support bot) that responds to @-mentions in Velt comments, handling webhook events from Velt (comment.add, comment.reaction_add), configuring the Chat SDK with createVeltAdapter, setting up webhook routes in Next.js or other Node.js frameworks, handling reactions on Velt comments, resolving user identities for bot responses, or deploying a Velt-connected bot to Vercel or other platforms. Triggers on any task involving @veltdev/chat-sdk-adapter, Chat SDK adapters for Velt, Velt bot integration, Velt webhook handling for comments, onNewMention, onReaction, thread.post(), or building an automated responder for Velt comment threads — even if the user doesn't explicitly say 'chat SDK adapter'.
Install
With your agent
Install OMGSkills skill "velt-js/velt-plugin-cursor:skills/velt-chat-sdk-adapter-best-practices" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/velt-js/velt-plugin-cursor /tmp/velt-plugin-cursor && ln -s /tmp/velt-plugin-cursor/skills/velt-chat-sdk-adapter-best-practices ~/.claude/skills/velt-chat-sdk-adapter-best-practicesFrom README
Velt Chat SDK Adapter Best Practices Comprehensive guide for building bots that integrate with Velt comment threads via the Chat SDK Adapter (@veltdev/chat-sdk-adapter). The adapter bridges the cross-platform Chat SDK with Velt's comment threading system, so a single bot can run on Velt, Slack, Discord, and other Chat SDK-compatible platforms. When to Apply Reference these guidelines when: Building a bot that responds to @-mentions in Velt comment threads Setting up webhook routes to receive Velt comment/reaction events Configuring createVeltAdapter with proper credentials and user resolution Handling reactions (read on managed Velt, write requires self-hosting) Deploying a Velt bot to Vercel, other serverless platforms, or a Node.js server Building an AI agent that streams LLM replies into Velt threads Core Architecture The adapter is server-side only — it runs in your API routes, not in the browser.
More from this repo
install-velt
Full guided installation of the Velt collaboration SDK into a React or Next.js project.
velt-activity-best-practices
Velt Activity Logs implementation patterns and best practices for React, Next.js, and web applications.
velt-approval-engine-best-practices
Best practices for the Velt Approval Engine — the declarative workflow runtime for multi-step agent + human approval...