Agent Skill

Overview

The BotBell Agent Skill lets AI coding agents send push notifications to your phone and wait for your replies — without writing any code. It follows the Agent Skills open standard supported by 30+ platforms.

• Notify you when a long task finishes (tests, builds, deploys)
• Ask for confirmation before risky operations (delete, force push, deploy)
• Send analysis results or code review summaries to your phone
• Ask questions and wait for your reply to continue

Works with Claude Code, GitHub Copilot, Cursor, OpenAI Codex, Gemini CLI, and any tool that supports the Agent Skills standard.

Installation

Install the skill with a single command:

npx skills add qq418716640/botbell-skill

Prerequisites

• curl — pre-installed on macOS and most Linux distributions
• jq — install from jqlang.github.io/jq/download

Setup

1. Download the BotBell app from the App Store
2. Create a Bot and copy its token
3. Set the environment variable:

export BOTBELL_TOKEN="bt_your_token_here"

Usage

Just tell your AI assistant what you want. The skill activates automatically based on context:

• Run the tests and notify me when done
• Deploy to production, but confirm with me first
• Review this code and send the summary to my phone
• Ask me which config to use

You can also invoke the skill directly with /botbell:

/botbell run the migration and let me know the result

Scenarios

Notify after a long task

When you ask the AI to run tests, build, or deploy, it sends you a summary notification when done. You don't need to watch the terminal.

Confirm before risky operations

Before deleting files, force pushing, or deploying to production, the AI sends a confirmation request with Yes/No buttons to your phone. It waits for your response before proceeding.

Ask a question

When the AI needs your input (which config, which branch, what name), it sends the question to your phone with options or a text input field, then continues with your answer.

Send a report

After analyzing code, reviewing a PR, or generating a summary, the AI sends the formatted results to your phone for review on the go.

Skill vs MCP Server

BotBell offers two ways to integrate with AI tools. Choose the one that fits your needs:

For multi-bot management and PAT authentication, see MCP Server