{
 "schema": "aiblocks-page/1",
 "id": "build-first-slack-bot-builder-prompt",
 "type": "prompt",
 "name": "Slack bot build brief writer",
 "summary": "Get a coding prompt that builds a Slack bot which replies \"Pong\" when someone says ping. A first test for your Slack bot, in Claude Code.",
 "headline": "Slack bot build brief writer",
 "subhead": "Use this to prove your Slack connection works. You give it your project and tokens. It builds a small ping bot that replies in the thread, and explains each part in plain words.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "codebase",
   "required": true,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  }
 ],
 "outputs": [
  {
   "type": "code_change",
   "required": true,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  }
 ],
 "you_give": [
  "Your code project, open in a coding AI",
  "Your Slack bot token and app token, saved in .env.local",
  "A Slack app with Socket Mode on, the scopes chat:write and channels:history, and the message.channels event",
  "A sandbox Slack workspace to test in"
 ],
 "you_get": [
  "A Slack bot file that replies Pong when someone says ping",
  "A test script to start the bot",
  "A plain explanation of Socket Mode and the two tokens",
  "Steps to invite the bot and test it"
 ],
 "use_when": [
  "You want a first test that your app can talk to Slack.",
  "You are new to Slack bots and want each part explained simply.",
  "You want a small base to grow into a bigger bot later."
 ],
 "skip_when": [
  "You want a bot that does real work for your team: plan that build as its own project, and use this only to test your Slack connection first.",
  "You want to run it in a live company workspace: use a sandbox Slack workspace, or ask a developer to review it first.",
  "You do not have a Slack app, tokens or a code project yet: ask a developer to set those up, then come back."
 ],
 "output_sample": {
  "input": [
   "Your code project (a repository your AI can open)",
   "Your Slack bot token and app token, saved in .env.local",
   "A Slack workspace where you can add a bot"
  ],
  "prerequisites": [
   "A coding AI that can read and write files in your project, such as Claude Code",
   "A Slack app with Socket Mode on, made at api.slack.com/apps",
   "Bot scopes chat:write and channels:history, and the message.channels event turned on",
   "An app-level token with the connections:write scope",
   "An AI that can run code, to use the scripts that come with this skill"
  ],
  "output": [
   {
    "name": "Package install",
    "contains": "The Slack Bolt package added to your project, after you confirm the install."
   },
   {
    "name": "lib/slack/app.ts",
    "contains": "The bot setup using both tokens in Socket Mode, with a listener that answers ping in the same thread."
   },
   {
    "name": "scripts/test-slack-bot.ts",
    "contains": "A short script that starts the bot, prints a running message and shuts down cleanly on Ctrl+C."
   },
   {
    "name": "Plain-language explanation",
    "contains": "Short notes on Socket Mode, what each token does, how to invite the bot and what happens on ping."
   },
   {
    "name": "Test steps",
    "contains": "The command to start the bot, then how to invite it to a channel and type ping."
   }
  ]
 },
 "how_to_use": [
  "Check you have a Slack app, Socket Mode on, the two bot scopes (chat:write and channels:history), the message.channels event turned on and both tokens in .env.local.",
  "Open your project in a coding AI that can write files, such as Claude Code.",
  "Paste the prompt from the skill and send it.",
  "Say yes before it installs the Slack package.",
  "Run the test script, invite the bot to a channel with /invite and type ping.",
  "Check the bot replies in the thread with the channel and user."
 ],
 "checks": [],
 "next": [
  {
   "name": "Slack agent message router builder",
   "url": "https://useaiblocks.com/skills/how-messages-reach-your-agent-implementation-planner",
   "why": "Build it"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/worked-example.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/prompts/build-first-slack-bot-builder-prompt",
  "markdown": "https://useaiblocks.com/prompts/build-first-slack-bot-builder-prompt.md",
  "json": "https://useaiblocks.com/prompts/build-first-slack-bot-builder-prompt.json",
  "instructions": "https://useaiblocks.com/skills/build-first-slack-bot-builder-prompt/SKILL.md",
  "download": "https://useaiblocks.com/skills/build-first-slack-bot-builder-prompt.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/build-first-slack-bot-builder-prompt",
  "api_document": "https://useaiblocks.com/api/v1/documents/prompt/build-first-slack-bot-builder-prompt",
  "mcp": "https://useaiblocks.com/mcp"
 }
}