π‘ Smart Follow-ups
π¦ A Bot Skill
Generate contextual follow-up suggestions for your AI conversations
This is a skill for Bot β the AI assistant that works across Telegram, Discord, Signal, WhatsApp, and more.
After every AI response, get 3 smart suggestions for what to ask next:
- β‘ Quick β Clarifications and immediate questions
- π§ Deep Dive β Technical depth and detailed exploration
- π Related β Connected topics and broader context
Telegram/Discord/Slack: Clickable inline buttons
Signal/iMessage/SMS: Numbered text list
β¨ Features
- π― Context-Aware β Analyzes your last 1-3 exchanges
- π Interactive Buttons β One tap to ask (Telegram, Discord, Slack)
- π Text Fallback β Numbered lists for channels without buttons
- β‘ Fast β ~2 second generation time
- π Privacy-First β Uses your existing Bot auth by default
- π§ Flexible β Multiple provider options (see below)
π¦ What is Bot?
Bot is a powerful AI assistant that connects Claude to your favorite messaging apps β Telegram, Discord, Signal, WhatsApp, iMessage, and more. Skills extend Bot with new capabilities.
Not using Bot yet? Check out bot.com to get started!
π Quick Start
Installation
# Via Skills (recommended)
skills install smart-followups
# Or manually
cd /path/to/bot/skills
git clone https://github.com/robbyczgw-cla/smart-followups
cd smart-followups
npm install
Usage
Just say "followups" (or "give me follow-ups", "suggestions") in any Bot conversation:
You: What is Docker?
Bot: Docker is a containerization platform that...
You: followups
Bot: π‘ What would you like to explore next?
[β‘ How do I install Docker?]
[π§ Explain container architecture]
[π Docker vs Kubernetes?]
Click any button β sends that question automatically!
Note: This works as a keyword the agent recognizes, not as a registered
/slashcommand. Bot skills are guidance docs β the agent reads the SKILL.md and knows how to respond when you ask for follow-ups.
π Authentication Options
Option 1: Bot Native (Default) β
Uses your existing Bot authentication β same model and login as your current chat.
- β No additional API keys needed
- β Uses your current session's model (Haiku/Sonnet/Opus)
- β Works out of the box
{
"skills": {
"smart-followups": {
"provider": "bot"
}
}
}
Option 2: OpenRouter
Use OpenRouter for model access. Requires API key.
{
"skills": {
"smart-followups": {
"provider": "openrouter",
"apiKey": "${OPENROUTER_API_KEY}",
"model": "anthropic/claude-sonnet-4.5"
}
}
}
Get an OpenRouter API key: openrouter.ai/keys
Option 3: Direct Anthropic
Use Anthropic's API directly. Requires API key.
{
"skills": {
"smart-followups": {
"provider": "anthropic",
"apiKey": "${ANTHROPIC_API_KEY}",
"model": "claude-sonnet-4-5"
}
}
}
Get an Anthropic API key: console.anthropic.com
βοΈ Configuration
Add to your bot.json:
{
"skills": {
"smart-followups": {
"enabled": true,
"provider": "bot",
"model": null,
"autoTrigger": false
}
}
}
| Option | Default | Description |
|---|---|---|
enabled |
true |
Enable/disable the skill |
provider |
"bot" |
Auth provider: bot, openrouter, anthropic |
model |
null |
Model override (null = inherit from session) |
apiKey |
β | API key for openrouter/anthropic providers |
autoTrigger |
false |
Auto-show follow-ups after every response |
π± Channel Support
Works on every Bot channel with adaptive formatting:
| Channel | Mode | Interaction |
|---|---|---|
| Telegram | Inline buttons | Tap to ask |
| Discord | Inline buttons | Click to ask |
| Slack | Inline buttons | Click to ask |
| Signal | Text list | Reply 1, 2, or 3 |
| Text list | Reply 1, 2, or 3 | |
| iMessage | Text list | Reply 1, 2, or 3 |
| SMS | Text list | Reply 1, 2, or 3 |
| Matrix | Text list | Reply 1, 2, or 3 |
| Text list | Reply with number |
π See CHANNELS.md for detailed channel-specific documentation.
π οΈ CLI Tool (Optional)
A standalone CLI is included for testing and scripting:
# Set API key (OpenRouter or Anthropic)
export OPENROUTER_API_KEY="sk-or-..."
# Generate follow-ups from JSON context
echo '[{"user":"What is Docker?","assistant":"Docker is..."}]' | \
followups-cli --mode text
# Output modes: json, telegram, text, compact
followups-cli --mode telegram < context.json
See followups-cli --help for all options.
π Examples
Telegram Buttons
π‘ What would you like to explore next?
[β‘ How do I install Docker? ]
[π§ Explain Docker's architecture ]
[π Compare Docker to Kubernetes ]
Signal Text Mode
π‘ Smart Follow-up Suggestions
β‘ Quick
1. How do I install Docker?
π§ Deep Dive
2. Explain Docker's architecture
π Related
3. Compare Docker to Kubernetes
Reply with 1, 2, or 3 to ask that question.
β FAQ
Why 3 suggestions instead of 6?
Cleaner UX, especially on mobile. Each category (Quick, Deep, Related) gets one focused suggestion instead of overwhelming you with options.
Can I use this without Bot?
Yes! The CLI tool works standalone with OpenRouter or Anthropic API keys. But the best experience is integrated with Bot.
How does it know what to suggest?
The skill analyzes your last 1-3 message exchanges and generates contextually relevant questions across three categories: quick clarifications, deep technical dives, and related topics.
Will it work with my custom model?
Yes! With provider: "bot" (default), it uses whatever model your current chat is using. With other providers, specify the model in config.
Is my conversation data sent anywhere?
With Bot native: Same privacy as your normal chat β processed by your configured AI provider.
With OpenRouter/Anthropic: Your recent exchanges are sent to generate suggestions. See their respective privacy policies.
How much does it cost?
- Bot native: Uses your existing chat's API usage
- OpenRouter/Anthropic: ~$0.001-0.01 per generation depending on model
ποΈ Project Structure
smart-followups/
βββ cli/
β βββ followups-cli.js # Standalone CLI tool
βββ handler.js # Bot command handler
βββ package.json
βββ README.md # This file
βββ SKILL.md # Bot skill manifest
βββ FAQ.md # Frequently asked questions
βββ INTERNAL.md # Development notes
βββ CHANGELOG.md # Version history
βββ LICENSE # MIT License
π€ Contributing
Contributions welcome! Please read CONTRIBUTING.md first.
- Fork the repository
- Create a feature branch
- Make your changes
- Test across multiple channels
- Submit a pull request
π License
MIT Β© Robby
π Credits
- Inspired by Chameleon AI Chat's smart follow-up feature
- Built for the Bot ecosystem
- Powered by Claude
Made with π¦ by the Bot community