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, …
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'.
Similar popular skills
Related neighbors and high-traction skills in the same topics — useful to compare before installing.
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Claude CodeNot declared
CursorNot declared
CodexNot declared
GitHub CopilotNot declared
WindsurfNot declared
Gemini CLINot declared
ClineNot declared
OpenCodeNot declared
Repository health
Stars1
LicenseMIT
Default branchmain
Open issues7
Status
Active
Skill metadata
Parsed from SKILL.md frontmatter.
Version1.0.0
LicenseMIT
More metadata
author
velt
version
1.0.0
Package contents
Files included with this skill beyond the listing page.
skill mdSKILL.md3,094 B
docsSUMMARY.md915 B
History
First seen on skills.sh
First recorded snapshot · 7 installs
SKILL.md
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. There is no VeltProvider or authProvider involved (those are client-side patterns for the Velt React SDK). The adapter authenticates via VELTAPIKEY and auto-generates auth tokens scoped to each organization.
The flow:
User @-mentions the bot in a Velt comment thread
Velt sends a webhook to your API endpoint
The adapter verifies the signature, parses the event, and dispatches to your handler
Your handler calls thread.post() to reply (the adapter posts via Velt's REST API)
