Files
gh-devkade-collaborator-ski…/skills/temporal/weekly-review/SKILL.md
2025-11-29 18:19:46 +08:00

4.6 KiB

name, description
name description
pkm:weekly-review Generate or update the Weekly Summary section by aggregating daily notes in Obsidian

Weekly Review Skill

This skill helps you reflect on your week by aggregating data from your daily notes and generating comprehensive weekly insights.

Purpose

Automatically generate the 📆 Weekly Summary with:

  • Weekly highlights and accomplishments
  • KPIs (completion rate, total focus time)
  • Project status tracking
  • Insights and patterns
  • Blockers and delayed tasks
  • Next week's priorities

Context

  • Weekly notes location: 20_Notes/Journal/YYYY/Mnn/YYYY-Www.md
  • Daily notes location: 20_Notes/Journal/YYYY/Mnn/YYYY-MM-DD.md
  • Obsidian vault: ~/Obsidian/Altellus
  • Current week: Calculate from today's date
  • Review period: Past 7 days of daily notes

Workflow

1. Identify the weekly note

  • Calculate current week number (e.g., 2025-W46)
  • Path format: ~/Obsidian/Altellus/20_Notes/Journal/2025/M11/2025-W46.md
  • Create from template if doesn't exist

2. Aggregate daily notes (TaskNotes format)

  • Read the past 7 daily notes from 20_Notes/Journal/
  • Extract completed tasks in TaskNotes format: - [x] [[Task Name]] ✅ YYYY-MM-DD
  • Extract incomplete tasks: - [ ] [[Task Name]]
  • Count pomodoros from YAML pomodoros array in each daily note
  • Collect data from both "🌅 Daily Notes" and "🌙 Daily Review" sections

3. Fill "주간 하이라이트" (Weekly Highlights)

  • List 3-5 major accomplishments this week
  • Use TaskNotes format for highlights: - [x] [[Task Name]]
  • What moved forward? What was completed?
  • Focus on significant wins and progress

4. Fill "KPI & 지표" (KPIs & Metrics) - TaskNotes format

  • 완료율 (Completion rate): Count completed vs total TaskNotes tasks
  • 총 Pomodoros: Sum pomodoros array length from all 7 daily notes
  • Display with emoji: 총 🍅 x 35 (7일간)
  • Show daily average: 일평균: 5 pomodoros/day
  • Example format:
    • - 완료율: 23/30 tasks (77%)
    • - 총 Pomodoros: 🍅 x 35

5. Fill "주요 프로젝트 상태" (Project Status)

  • Identify projects mentioned across the week
  • Track progress and current status
  • Format: - [[Project Name]] — status description

6. Fill "🧠 Insights"

  • Patterns discovered across the week
  • What worked well consistently?
  • What recurring issues appeared?
  • Any systemic improvements needed?

7. Fill "⏱ Time & Energy"

  • Project-wise time breakdown
  • Energy flow observations (when was most productive?)
  • Time allocation vs. planned focus areas

8. Fill "🧱 Blockers" - TaskNotes format

  • Find TaskNotes tasks appearing 3+ days without completion: - [ ] [[Task Name]]
  • Format: - [ ] [[Task Name]] — X일 연속 미완료
  • Recurring obstacles that appeared multiple times
  • External dependencies blocking progress
  • Identify root causes if visible

9. Fill "🎯 다음 주 우선순위" (Next Week Priorities) - TaskNotes format

  • Based on blockers and incomplete work
  • Format as TaskNotes checklist: - [ ] [[Priority Task]]
  • Connect to blocker resolutions
  • Include carried-forward important tasks
  • Prioritize delayed tasks from blockers section

Output Format

Provide the complete weekly note content with all sections filled.

Important:

  • Pull data from actual daily notes, not assumptions
  • Calculate real numbers for KPIs from TaskNotes YAML frontmatter
  • Preserve frontmatter and template structure
  • Base all insights on actual data from the 7 daily notes

Usage

This skill is called via the /pkm:weekly-review command, typically on Friday evening or Sunday evening to reflect on the week.

Integration

  • Works with Periodic Notes plugin in Obsidian
  • Reads daily notes from the past 7 days
  • Aggregates YAML frontmatter data (pomodoros)
  • Links to daily notes using wikilinks

Example

Input: User runs /pkm:weekly-review on 2025-11-22 (Friday of week 47)

Process:

  1. Calculate week number: 2025-W47
  2. Identify weekly note: ~/Obsidian/Altellus/20_Notes/Journal/2025/M11/2025-W47.md
  3. Read 7 daily notes: 2025-11-16 through 2025-11-22
  4. Extract from each daily note:
    • Completed tasks from "오늘 완료"
    • Pomodoros from YAML frontmatter
    • Insights from "인사이트"
    • Projects mentioned
    • Incomplete tasks
  5. Aggregate and analyze:
    • Count total tasks: 23 completed / 30 total = 77%
    • Sum pomodoros: 58 total = 29 hours
    • Identify projects: Project A, Project B, Project C
    • Find blockers: Tasks mentioned 3+ days
  6. Generate insights and priorities

Output: Complete weekly note with all 9 sections filled based on actual weekly data.