Agent Skills

slack-agent

An agent skill for building Slack agents deployed to Vercel

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

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 4/22/2026

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

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:

  1. Framework selection and project setup
  2. Custom implementation plan generation and approval
  3. Slack app creation with customized manifest
  4. Environment configuration
  5. Local testing with ngrok
  6. Production deployment to Vercel
  7. 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.