weekly

name: weekly description: Weekly review with blocker detection. Analyze past 7 days, identify stuck tasks (3+ days via wikilinks), calculate completion rate, plan next week. Use on Sundays or whenever doing weekly planning. allowed-tools: Read, Write, Edit, Glob, Grep user-invocable: true

Weekly Review Skill

Facilitates your weekly review process by analyzing the past week's daily notes, detecting blockers via task wikilinks, and helping plan the next week.

Usage

Invoke with /weekly on Sundays or whenever you do weekly planning.

/weekly

What This Skill Does

1. Reviews Daily Notes

• Reads last 7 days of daily notes from 20_Daily Notes/YYYY/Mnn/
• Counts completed vs incomplete tasks per day (wikilink format)
• Calculates completion rate

2. Detects Blockers (Task File Based)

• Identifies task wikilinks appearing 3+ days without completion
• Reads task files from 00_Inbox/Tasks/ for additional context
• Lists as blockers that need attention
• Shows task priority and due date from YAML frontmatter

3. Calculates KPIs

• Total tasks completed
• Total tasks incomplete
• Completion rate percentage
• Average tasks per day

4. Guides Reflection

• Reviews accomplishments
• Identifies challenges and patterns
• Captures lessons learned

5. Plans Next Week

• Creates weekly review note in 20_Daily Notes/YYYY/Mnn/YYYY-Www.md
• Sets ONE focus for the week
• Identifies key tasks

Blocker Detection

Tasks that appear in 3 or more days without being completed are flagged:

## Blockers (3+ days without completion)

| Task | Days Stuck | Priority | Due Date |
|------|------------|----------|----------|
| [[Review PR 123]] | 4 days | high | 2026-01-15 |
| [[Update documentation]] | 3 days | medium | - |

These tasks may need:
- Breaking into smaller steps
- Removing blockers
- Delegating
- Dropping if not important

The skill reads each task file to show:

• Priority from YAML frontmatter
• Due date if set
• Scheduled date

Weekly Review Output

The skill creates a weekly review note:

# Weekly Review: 2026-W02

## Summary
- Days reviewed: 7
- Tasks completed: 23
- Tasks incomplete: 8
- Completion rate: 74%

## This Week's Wins
1.
2.
3.

## Challenges & Lessons
- Challenge:
- Lesson:

## Blockers (3+ days without completion)

| Task | Days Stuck | Priority | Due |
|------|------------|----------|-----|
| [[Task X]] | 4 days | high | 2026-01-20 |
| [[Task Y]] | 3 days | low | - |

## Next Week

### ONE Focus
>

### Key Tasks
- [ ] [[Task 1]]
- [ ] [[Task 2]]
- [ ] [[Task 3]]

## Notes

Task Format

Tasks use wikilinks to reference task files:

• Incomplete: - [ ] [[Task Name]]
• Completed: - [x] [[Task Name]] ✅ 2026-01-13

Task files in 00_Inbox/Tasks/ have YAML frontmatter:

---
tags: [task]
status: open
priority: high
due: 2026-01-20
scheduled: 2026-01-15
---

Review Process

Step 1: Data Collection (automatic)

• Scan daily notes from past 7 days
• Extract task completion data (wikilinks)
• Map which tasks appear on which days
• Identify recurring incomplete tasks

Step 2: Task File Analysis

• For each blocker task, read 00_Inbox/Tasks/{Task Name}.md
• Extract priority, due date, scheduled date
• Show context in blocker report

Step 3: Reflection (10 minutes)

• Review wins and celebrate progress
• Analyze challenges and extract lessons
• Acknowledge blockers

Step 4: Planning (10 minutes)

• Set ONE focus for next week
• Identify 3-5 key tasks
• Decide what to do with blockers

Best Practices

Consistent Timing

• Same day each week (Sunday recommended)
• Same time if possible
• Treat as non-negotiable

Handle Blockers

For each blocker, decide:

• Break down: Split into smaller tasks
• Unblock: Identify and remove obstacle
• Delegate: Assign to someone else
• Drop: Remove if no longer important

Follow-through

• Commit changes after review (/push)
• Share highlights if relevant
• Celebrate wins

Integration

Works with:

• /daily-setup - Creates daily notes for the week
• /daily-review - Evening reflections aggregate here
• /task-create - Create new task files
• /task-done - Mark tasks as completed
• /push - Commit after completing review
• /onboard - Load context for informed review

Requirements

• TaskNotes plugin - For task file management
• Periodic Notes plugin - For daily/weekly note structure