Files

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 model setting

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

  1. Check skill is installed: ls /path/to/bot/skills/smart-followups/
  2. Check skill is enabled: Look for smart-followups in your bot.json
  3. 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 object
  • telegram — Telegram inline buttons array
  • text — Formatted text with categories
  • compact — 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?