Skip to content
Productivity
Skill

/review

Smart review router. Detects context (morning, Sunday, end of month) and launches the appropriate review workflow. Use anytime for the right review at the right time.

From plugin
obsidian-claude-pkm
1.7k13 skills4 agents
Install
$ npx -y skills add ballred/obsidian-claude-pkm --skill review --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/review

Context preview

The summary Claude sees to decide when to auto-load this skill.

Smart review router. Detects context (morning, Sunday, end of month) and launches the appropriate review workflow. Use anytime for the right review at the right time.

SKILL.md

review.SKILL.md
name: review
description: Smart review router. Detects context (morning, Sunday, end of month) and launches the appropriate review workflow. Use anytime for the right review at the right time.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList, TaskGet
model: sonnet
user-invocable: true

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
Read more
Ships withobsidian-claude-pkm

Not another PKM starter kit. This is an execution system that connects your 3-year vision to what you do today — and holds you accountable with AI. Every layer connects. /daily surfaces your ONE Big Thing from the weekly review. /weekly shows project progress.

Get the whole plugin
Stats
1,741
Stars
119
Forks
Maintained
Maintenance
Shell
Language
MIT
License
5mo ago
Last commit
1y ago
Created

Repo: ballred/obsidian-claude-pkm