6.3 KiB
❓ Frequently Asked Questions
General
What is Smart Follow-ups?
A Bot skill that generates contextual follow-up suggestions after AI responses. It analyzes your recent conversation and suggests 3 relevant questions across three categories:
- ⚡ Quick — Clarifications, definitions, immediate next steps
- 🧠 Deep Dive — Technical depth, advanced concepts, thorough exploration
- 🔗 Related — Connected topics, broader context, alternative perspectives
Why only 3 suggestions?
We originally planned 6 (2 per category), but found 3 provides a cleaner UX:
- Less overwhelming, especially on mobile
- Each category gets one focused, high-quality suggestion
- Faster to scan and decide
- Keeps the interface clean
How do I use it?
Type /followups in any Bot conversation. On Telegram/Discord/Slack, you'll see 3 clickable buttons. On Signal/iMessage, you'll see a numbered list — reply with 1, 2, or 3.
Authentication & Providers
What's the default authentication method?
Bot native — the skill uses your existing Bot authentication (Claude CLI token login). No additional API keys required.
Can I use OpenRouter instead?
Yes! Set provider: "openrouter" in your config and provide your OpenRouter API key:
{
"skills": {
"smart-followups": {
"provider": "openrouter",
"apiKey": "sk-or-v1-..."
}
}
}
Can I use direct Anthropic API?
Yes! Set provider: "anthropic" with your Anthropic API key:
{
"skills": {
"smart-followups": {
"provider": "anthropic",
"apiKey": "sk-ant-..."
}
}
}
Which model does it use?
- Bot native: Uses your current session's model (if you're chatting with Opus, follow-ups use Opus)
- OpenRouter/Anthropic: Defaults to Claude Sonnet 4.5, configurable via
modelsetting
Can I force a specific model?
Yes, set the model option:
{
"skills": {
"smart-followups": {
"model": "anthropic/claude-3-haiku"
}
}
}
Privacy & Security
Is my conversation data sent anywhere?
With Bot native (default): Same privacy as your normal chat. Your recent exchanges are processed by your configured AI provider (Anthropic) using your existing authentication.
With OpenRouter: Your recent exchanges are sent to OpenRouter's API. See OpenRouter's privacy policy.
With direct Anthropic: Your recent exchanges are sent to Anthropic's API. See Anthropic's privacy policy.
How much context is sent?
Only the last 1-3 message exchanges (user + assistant pairs). We don't send your entire conversation history.
Are the suggestions logged anywhere?
No. Suggestions are generated on-demand and returned directly to you. Nothing is stored by the skill.
Cost
How much does it cost to use?
- Bot native: Part of your normal API usage, no additional cost structure
- OpenRouter: ~$0.001-0.01 per generation depending on model
- Direct Anthropic: ~$0.001-0.01 per generation depending on model
For reference, using Claude Haiku costs ~$0.0002 per generation. Claude Sonnet costs ~$0.003-0.01.
Can I use a cheaper model for follow-ups?
Yes! Even if your main chat uses Opus, you can configure follow-ups to use Haiku:
{
"skills": {
"smart-followups": {
"provider": "openrouter",
"model": "anthropic/claude-3-haiku",
"apiKey": "..."
}
}
}
Channels
Which channels support buttons?
- ✅ Telegram — Full inline button support
- ✅ Discord — Full button support
- ✅ Slack — Full button support
- ❌ Signal — Text list fallback (reply with number)
- ❌ iMessage — Text list fallback
- ❌ SMS — Text list fallback
What happens on channels without buttons?
You get a numbered text list:
💡 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.
Reply with the number to ask that question.
Troubleshooting
/followups doesn't work
- Check skill is installed:
ls /path/to/bot/skills/smart-followups/ - Check skill is enabled: Look for
smart-followupsin yourbot.json - Restart Bot: After installing or configuring skills
"API key required" error
You're using OpenRouter or Anthropic provider but haven't set an API key. Either:
- Switch to
provider: "bot"(uses existing auth) - Add your API key to the config
Suggestions aren't relevant
The skill analyzes your last 1-3 exchanges. If your conversation is very short or vague, suggestions may be generic. Try having a more detailed exchange first.
Buttons don't appear on Telegram
Check that your Telegram channel config has inlineButtons capability:
{
"channels": {
"telegram": {
"capabilities": ["inlineButtons"]
}
}
}
CLI Tool
Can I use the skill without Bot?
Yes! The CLI tool works standalone:
export OPENROUTER_API_KEY="sk-or-..."
echo '[{"user":"What is Docker?","assistant":"Docker is..."}]' | followups-cli --mode text
What input formats does the CLI accept?
JSON array of exchanges:
[
{"user": "What is Docker?", "assistant": "Docker is a containerization platform..."},
{"user": "How is it different from VMs?", "assistant": "Key differences include..."}
]
Or pipe from a file: cat conversation.json | followups-cli
What output formats are available?
json— Raw JSON objecttelegram— Telegram inline buttons arraytext— Formatted text with categoriescompact— Simple numbered list
Development
How do I contribute?
See CONTRIBUTING.md. Fork, branch, code, test, PR.
Where are the development notes?
See INTERNAL.md for architecture decisions, design rationale, and development history.
How do I run tests?
cd smart-followups
./test.sh
Still have questions?
- Open an issue on GitHub
- Ask on Skills Discussions
- Ping @robbyczgw-cla