Agent 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.
Install this agent skill to your Project
npx add-skill https://github.com/ballred/obsidian-claude-pkm/tree/main/vault-template/.claude/skills/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
/dailymorning workflow - After 5 PM (>= 17): Evening shutdown — delegate to
/dailyevening workflow - Midday (12-17): Midday check-in — delegate to
/dailymidday 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:
- Tell the user what was detected: "It's Sunday evening — launching your weekly review."
- Delegate to the appropriate skill's workflow
- The delegated skill handles everything from there
Delegation
This skill does NOT duplicate the logic of /daily, /weekly, or /monthly. It:
- Detects context
- Informs the user
- 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 monthlyruns 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
weekly
Facilitate weekly review process with reflection, goal alignment, and planning. Create review notes, analyze past week, plan next week. Use on Sundays or whenever doing weekly planning.
project
Create, track, and archive projects linked to goals. The bridge between goals and daily tasks. Use for project creation, status dashboards, and archiving completed work.
goal-tracking
Track progress toward 3-year, yearly, monthly, and weekly goals. Calculate completion percentages, surface stalled goals, connect daily tasks to objectives. Use for goal reviews and progress tracking.
daily
Create daily notes and manage morning, midday, and evening routines. Structure daily planning, task review, and end-of-day reflection. Use for daily productivity routines or when asked to create today's note.
search
Search vault content by keyword using Grep. Zero dependencies — works in any vault without indexes or plugins. Groups results by directory for easy scanning.
adopt
Scaffold the PKM system onto an existing Obsidian vault. Scans your vault structure, maps folders interactively, and generates configuration — no template required.
Didn't find tool you were looking for?