# Followup

> Schedule a follow-up reminder for a specific date. Use when user wants to set a reminder to follow up on a project, task, question, or any item. Adds entries to _Followups.md which get pulled into daily notes.

- Skill: `majiayu000/followup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/followup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/followup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/followup

---


# Follow-up Scheduler

Schedule follow-up reminders that appear in daily notes on the specified date.

## Usage

`/followup [date] [description]`

Examples:
- `/followup 2025-12-23 Check deployment status`
- `/followup next monday Ask Alex about hiring decision`
- `/followup +3 Review PR feedback`

## Date Formats

Accept flexible date input:
- ISO format: `2025-12-23`
- Relative: `tomorrow`, `next monday`, `next friday`
- Offset: `+3` (3 days from now), `+1w` (1 week from now)

## Workflow

1. Parse the date from input (first argument)
2. Parse the description (remaining arguments)
3. Convert to ISO date format (YYYY-MM-DD)
4. Append to `_Followups.md` in the vault

## File Location

- Vault: `/Users/larslevie/Library/Mobile Documents/iCloud~md~obsidian/Documents/Real Geeks/`
- File: `_Followups.md`

## Entry Format

Markdown table row:

```markdown
| 2025-12-23 | Check deployment status | pending |
```

Status values: `pending`, `done`

## Implementation

```python
import datetime
import re

def parse_date(date_str):
    today = datetime.date.today()

    # ISO format
    if re.match(r'\d{4}-\d{2}-\d{2}', date_str):
        return date_str

    # Relative days
    if date_str == 'tomorrow':
        return (today + datetime.timedelta(days=1)).isoformat()

    # Offset: +N or +Nw
    if date_str.startswith('+'):
        if date_str.endswith('w'):
            weeks = int(date_str[1:-1])
            return (today + datetime.timedelta(weeks=weeks)).isoformat()
        else:
            days = int(date_str[1:])
            return (today + datetime.timedelta(days=days)).isoformat()

    # next [weekday]
    if date_str.startswith('next '):
        weekday = date_str[5:].lower()
        days = {'monday': 0, 'tuesday': 1, 'wednesday': 2, 'thursday': 3,
                'friday': 4, 'saturday': 5, 'sunday': 6}
        target = days.get(weekday)
        if target is not None:
            current = today.weekday()
            diff = (target - current + 7) % 7
            if diff == 0:
                diff = 7
            return (today + datetime.timedelta(days=diff)).isoformat()

    return None
```

## After Adding

1. Read current `_Followups.md`
2. Insert new row before the empty line after the table header
3. Confirm to user with the parsed date and description

Example confirmation:
```
Added follow-up for 2025-12-23: "Check deployment status"
```