Skip to main content
ClaudeWave
Skill654 repo starsupdated today

followups

The followups skill manages message tracking across communication channels like email, Slack, and WhatsApp, monitoring whether sent messages receive responses. It automatically transitions follow-ups through states (pending, overdue, nudged, resolved) based on expected response windows and can resolve them either individually or by conversation, making it useful for identifying conversations requiring immediate attention or needing reminders.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/vellum-ai/vellum-assistant /tmp/followups && cp -r /tmp/followups/assistant/src/config/bundled-skills/followups ~/.claude/skills/followups
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

Track messages sent on external channels (email, Slack, WhatsApp, etc.) that are awaiting a response.

## Lifecycle

Each follow-up moves through these states:

- **pending** -- waiting for a response
- **overdue** -- past the expected response deadline with no reply
- **nudged** -- a reminder was sent after becoming overdue
- **resolved** -- a response was received or the follow-up was manually closed

## Auto-Deadline

When `expected_response_hours` is set, the follow-up automatically becomes overdue after that window. If a `contact_id` is provided, the contact's importance score can inform grace period decisions.

## Resolution

Follow-ups can be resolved in two ways:
1. **By ID** -- resolve a specific follow-up directly
2. **By conversation** -- provide channel + conversation_id to auto-resolve all matching pending follow-ups (useful when a response arrives on a conversation)

## Tips

- Use `followup_list` with `overdue_only: true` to find conversations that need attention.
- Attach a `reminder_schedule_id` to link a recurring reminder schedule to a follow-up.
- Filter by channel, status, or contact to narrow results.