slack-agent

Builds, tests, and deploys Slack agents on Vercel using Chat SDK or Bolt for JavaScript.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/pikkitco-ai-sandbox/Service_B --skill slack-agent-pikkitco-ai-sandbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slack-agent
Source: https://github.com/pikkitco-ai-sandbox/Service_B/tree/main/.agents/skills/slack-agent
Command: npx skills add https://github.com/pikkitco-ai-sandbox/Service_B --skill slack-agent-pikkitco-ai-sandbox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a Slack agent involves many error-prone steps: creating the Slack app manifest, configuring OAuth credentials, handling signature verification and 3-second ack timeouts, wiring AI integration, and deploying to serverless. This Skill guides the entire lifecycle with framework-specific patterns and an interactive wizard. ## Core Features & Use Cases - Interactive Setup Wizard: Six-phase guided flow covering project scaffolding, Slack app creation with customized manifest, environment configuration, local testing with ngrok, Vercel deployment, and Vitest setup. - Dual Framework Support: Provides development patterns for both Chat SDK (Next.js, JSX components, thread state) and Bolt for JavaScript (Nitro, Block Kit JSON, VercelReceiver), with automatic framework detection from package.json. - Custom Implementation Planning: Generates a tailored plan from agent archetypes (standup bot, support bot, alerting bot, etc.) and requires user approval before scaffolding. - Use Case: A developer wants to build a support ticket bot in Slack. The wizard generates a plan with slash commands and AI tools, scaffolds a Next.js + Chat SDK project, customizes the Slack manifest, and walks through ngrok testing and Vercel production deployment. ## Quick Start Invoke the /slack-agent command with 'new' to start the setup wizard and describe the kind of Slack agent you want to build.

Frequently Asked Questions about slack-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Slack bot with Next.js and deploy it to Vercel?

Use the Chat SDK with Next.js App Router: create a bot instance with createSlackAdapter, expose a webhook route at app/api/webhooks/[platform]/route.ts, and deploy with the vercel CLI. The wizard walks through manifest creation, credentials, and ngrok testing.

Chat SDK vs Bolt for JavaScript for Slack agents?

Chat SDK is recommended for new projects, offering JSX components like Card and Button plus thread-scoped state via Redis. Bolt for JavaScript suits existing Bolt codebases, using Nitro server, raw Block Kit JSON, and the VercelReceiver adapter.

Why does my Slack slash command fail with dispatch_failed on Vercel?

In Bolt projects, H3's toWebRequest consumes the request body stream before signature verification. Fix it by buffering the raw body with readRawBody and constructing a new Request before passing it to the handler.

How do I fix operation_timeout errors on Slack slash commands?

Slack requires acknowledgment within 3 seconds. Call await ack() immediately, then start long-running AI work without awaiting it, and post results later using the command's response_url.

Do I need API keys to use AI models in a Vercel Slack bot?

No keys are needed when using @ai-sdk/gateway deployed on Vercel, since it authenticates via OIDC automatically. Direct provider SDKs like @ai-sdk/openai or @ai-sdk/anthropic require managing your own API keys.

Can I test a Slack agent locally before deploying?

Yes. Run pnpm dev, expose port 3000 with ngrok, then update the manifest's event and interactivity request URLs to the ngrok URL. Run vercel link first so AI Gateway authentication works locally.