vercel-labs / slack-agent-skill

★ 16

A skill package that teaches your agent 1 capability — every one documented and browsable below, no GitHub required · by vercel.

Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.

slack-agent🔥🔥🔥✓ VerifiedFreeQuick setup

Use when working on Slack agent/bot code, Chat SDK applications, Bolt for JavaScript projects, or projects using @chat-adapter/slack or @slack/bolt. Provides development patterns, testing requirements, and quality standards.

→

Slack Agent Skill

An agent-agnostic skill for building and deploying Slack agents on Vercel. Supports two frameworks:

Chat SDK (Recommended for new projects) — chat + @chat-adapter/slack with Next.js
Bolt for JavaScript (For existing Bolt projects) — @slack/bolt with Nitro

Features

Interactive Setup Wizard: Step-by-step guidance from project creation to production deployment
Dual Framework Support: Chat SDK (JSX components, thread subscriptions) and Bolt for JavaScript (Block Kit, event listeners)
Custom Implementation Planning: Generates a tailored plan based on your agent's purpose before scaffolding
Quality Standards: Embedded testing and code quality requirements
AI Integration: Support for Vercel AI Gateway and direct provider SDKs
Comprehensive Patterns: Slack-specific development patterns and best practices for both frameworks
Testing Framework: Vitest configuration and sample tests for both stacks

Installation

Via skills.sh (Recommended)

npx skills add vercel-labs/slack-agent-skill

Manual Installation

Clone the repository into your skills directory. For example, with Claude Code:

git clone https://github.com/vercel-labs/slack-agent-skill.git ~/.claude/skills/slack-agent-skill

Usage

Starting a New Project

Run the slash command:

/slack-agent

Or with arguments:
/slack-agent new       # Start fresh project (recommends Chat SDK)
/slack-agent configure # Configure existing project (auto-detects framework)
/slack-agent deploy    # Deploy to production
/slack-agent test      # Set up testing

The wizard will guide you through:

Framework selection and project setup
Custom implementation plan generation and approval
Slack app creation with customized manifest
Environment configuration
Local testing with ngrok
Production deployment to Vercel
Test framework setup

Development

When working on an existing Slack agent project, the skill automatically detects the framework from package.json:

"chat" in dependencies — Uses Chat SDK patterns
"@slack/bolt" in dependencies — Uses Bolt patterns

The skill then provides framework-appropriate:

Code quality standards (linting, testing, TypeScript)
Slack-specific patterns (event handlers, slash commands, UI components)
AI integration guidance (Vercel AI Gateway, direct providers)
Deployment best practices

Key Commands

# Development
pnpm dev              # Start local dev server
ngrok http 3000       # Expose local server

# Quality
pnpm lint             # Check linting
pnpm lint --write     # Auto-fix lint issues
pnpm typecheck        # TypeScript check
pnpm test             # Run tests

# Deployment
vercel                # Deploy to Vercel
vercel --prod         # Production deployment

Quality Standards

The skill enforces these requirements:

Unit tests for all exported functions
E2E tests for user-facing changes
Linting must pass (Biome)
TypeScript must compile without errors
All tests must pass before completion

License

Apache 2.0 - See LICENSE for details.

Install the whole package (1 skills):

Copy & paste — that's it

npx skills add https://github.com/vercel-labs/slack-agent-skill

Or install a single skill: