review

SKILL.md

Review Skill

Smart router that detects context and launches the appropriate review workflow.

Usage

/review           # Auto-detect the right review based on time/context
/review daily     # Force daily review
/review weekly    # Force weekly review
/review monthly   # Force monthly review

Or simply: "Help me review" — and the right workflow starts.

Auto-Detection Logic

When invoked without arguments, detect context using these rules:

1. Check the Time of Day

HOUR=$(date +%H)
  • Before noon (< 12): Morning routine — delegate to /daily morning workflow
  • After 5 PM (>= 17): Evening shutdown — delegate to /daily evening workflow
  • Midday (12-17): Midday check-in — delegate to /daily midday workflow

2. Check the Day of Week

DAY_OF_WEEK=$(date +%u)  # 1=Monday, 7=Sunday
  • Sunday (7) or Monday (1): Weekly review — delegate to /weekly
    • Override time-of-day detection
    • Ask: "Ready for your weekly review?" before proceeding

3. Check the Day of Month

DAY_OF_MONTH=$(date +%d)
DAYS_IN_MONTH=$(date -v+1m -v1d -v-1d +%d 2>/dev/null || date -d "$(date +%Y-%m-01) +1 month -1 day" +%d)
  • Last 3 days of month (DAY_OF_MONTH >= DAYS_IN_MONTH - 2): Monthly review — delegate to /monthly

    • Override both time-of-day and day-of-week detection
    • Ask: "End of month — ready for your monthly review?" before proceeding
  • First day of month (DAY_OF_MONTH == 1): Also suggest monthly review

    • "It's the first of the month. Want to do your monthly review for last month?"

4. Check Staleness

Before routing, check for overdue reviews:

# Read weekly review file for last date
WEEKLY_REVIEW="Goals/3. Weekly Review.md"
# If last weekly review > 7 days ago, suggest weekly regardless of day
  • Weekly review overdue (>7 days): Suggest weekly review
    • "Your last weekly review was N days ago. Want to catch up?"
    • If user says no, fall through to time-of-day detection

Routing Behavior

After detecting context:

  1. Tell the user what was detected: "It's Sunday evening — launching your weekly review."
  2. Delegate to the appropriate skill's workflow
  3. The delegated skill handles everything from there

Delegation

This skill does NOT duplicate the logic of /daily, /weekly, or /monthly. It:

  1. Detects context
  2. Informs the user
  3. Follows the instructions from the target skill's SKILL.md

Explicit Override

If the user specifies a type (/review weekly), skip auto-detection entirely and go directly to that review type.

Output on Detection

### Review Router

**Time:** 7:15 AM (Morning)
**Day:** Sunday
**Month day:** 15th

**Detected:** Weekly review (Sunday override)
**Last weekly review:** 3 days ago (not overdue)

Launching weekly review...

Edge Cases

  • Multiple triggers (e.g., last Sunday of month): Monthly takes priority over weekly
  • No daily note exists: Create one first, then continue with review
  • User says "no" to suggestion: Fall through to next detection level
  • Explicit argument overrides everything: /review monthly runs monthly review even on a Tuesday morning

Integration

Works with:

  • /daily — Morning, midday, and evening routines
  • /weekly — Full weekly review process
  • /monthly — Monthly review and planning
  • Session init hook — Staleness data already calculated
Weekly Installs
7
GitHub Stars
1.2K
First Seen
Feb 25, 2026
Installed on
opencode7
codex7
gemini-cli6
github-copilot6
amp6
cline6