Agent skill
weekly-summary
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/weekly-summary
SKILL.md
/weekly-summary
Generate comprehensive weekly summary from daily notes, meetings, tasks, and project updates using parallel sub-agents.
Usage
/weekly-summary
/weekly-summary --last-week
/weekly-summary --from 2026-01-01 --to 2026-01-07
/weekly-summary --output page # Create Page note instead of just outputting
Instructions
This skill uses 5 parallel sub-agents to gather data concurrently from different vault areas, then synthesizes a comprehensive weekly report.
Phase 1: Launch Parallel Data Collectors
Create 5 Task agents running in parallel (use model: "haiku" for speed):
Agent 1: Daily Notes Collector (Haiku)
Task: Extract key activities from daily notes
- Determine date range (default: last 7 days, or from user's --from/--to flags)
- Use Glob to find +Daily/YYYY/YYYY-MM-DD.md files in range
- For each daily note:
- Read content
- Extract "Wins" or achievements section
- Extract "Challenges" or blockers section
- Extract "Notes" or key decisions
- Extract task completions (lines with [x])
- Note significant activities or meetings mentioned
- Return: Structured data with date, wins, challenges, decisions, completed tasks
Agent 2: Tasks Analyzer (Haiku)
Task: Analyze task completions and changes
- Use Glob to find all "Task - *.md" files
- Filter to tasks modified in date range (check frontmatter.modified)
- Categorize:
- Completed this week (completed: true, modified in range)
- New tasks created (created in range)
- Still in progress (high priority, not completed)
- Blocked tasks (status issues mentioned)
- For each category, extract: title, priority, project, due date
- Return: Task statistics and key task movements
Agent 3: Meetings Collector (Haiku)
Task: Gather meeting summaries from this week
- Use Glob to find all "+Meetings/Meeting - *.md" files
- Filter to meetings with date in range (frontmatter.date)
- For each meeting:
- Extract title, date, attendees, project
- Extract summary or key decisions from frontmatter or first section
- Note action items (lines starting with "- [ ]" or "TODO")
- Extract important discussion points
- Group by project if possible
- Return: Chronological list of meetings with key points
Agent 4: ADR Tracker (Haiku)
Task: Track architecture decisions this week
- Use Glob to find all "ADR - *.md" files
- Filter to ADRs modified or created in date range
- For each ADR:
- Extract title, status (proposed/accepted/deprecated)
- Note status changes (proposed → accepted)
- Extract decision and rationale summary
- Note impacted projects or systems
- Return: New ADRs, status changes, key decisions
Agent 5: Project Progress Tracker (Haiku)
Task: Analyze project progress this week
- Use Glob to find all "Project - *.md" files
- Filter to projects with status: active
- For each active project:
- Check if modified in date range
- Extract status, priority, recent updates
- Count related tasks completed this week
- Note any status changes (paused, completed)
- Extract milestones mentioned
- Return: Project progress summary with task completions
Phase 2: Wait for All Agents
Use TaskOutput with blocking to wait for all 5 agents to complete. Collect their outputs.
Phase 3: Synthesize Weekly Summary
Combine all agent data into cohesive weekly summary:
# Weekly Summary: {{Start Date}} - {{End Date}}
Generated: {{TIMESTAMP}}
## 📊 Week at a Glance
**Highlights:**
- {{Top 3 achievements from daily notes}}
- {{Major decisions or milestones}}
- {{Significant meetings or collaborations}}
**Statistics:**
- **Tasks Completed:** {{count}} ({{high priority count}} high priority)
- **New Tasks Created:** {{count}}
- **Meetings:** {{count}} ({{total hours if available}})
- **ADRs:** {{new count}} new, {{status change count}} updated
- **Active Projects:** {{count}} ({{tasks completed across projects}})
---
## ✅ Completed Tasks ({{count}})
### High Priority ({{count}})
- [x] [[Task - {{title}}]] ({{project}}) - {{due date}}
- [x] [[Task - {{title}}]] ({{project}})
### Medium Priority ({{count}})
{{list}}
### Low Priority ({{count}})
{{list if > 5, else "All completed"}}
---
## 🚀 Project Progress
### [[Project Name]] ({{status}})
**Tasks Completed:** {{count}}/{{total}}
**Key Updates:**
- {{update from project note or meetings}}
- {{completed task summaries}}
**Next Steps:**
- {{open high priority tasks}}
- {{upcoming milestones}}
---
### [[Another Project]] ({{status}})
{{same format}}
---
## 🏛️ Architecture Decisions
### New ADRs ({{count}})
- **[[ADR - {{title}}]]** ({{status}})
- **Decision:** {{one-line summary}}
- **Rationale:** {{brief reason}}
- **Impact:** {{projects or systems affected}}
### Status Changes ({{count}})
- **[[ADR - {{title}}]]**: Proposed → Accepted
- {{context for change}}
---
## 📅 Meetings This Week ({{count}})
### Monday, {{DATE}}
- **[[Meeting - {{title}}]]** ({{project}})
- Attendees: {{list}}
- **Key Points:** {{summary}}
- **Action Items:** {{count}} ({{assigned tasks}})
### Wednesday, {{DATE}}
{{same format}}
---
## 💡 Daily Highlights
### {{Monday DATE}}
**Wins:**
- {{from daily note}}
**Challenges:**
- {{from daily note}}
### {{Tuesday DATE}}
{{same format}}
---
## 🎯 Focus for Next Week
**Priorities:**
1. {{High priority open tasks}}
2. {{Upcoming project milestones}}
3. {{Pending ADR decisions}}
4. {{Follow-ups from meetings}}
**Blocked Items:**
- {{Tasks or projects marked blocked}}
- {{Challenges noted in daily notes}}
**Upcoming:**
- {{Due dates next week}}
- {{Scheduled meetings}}
- {{Project deadlines}}
---
## 📈 Trends & Insights
**Productivity:**
- Task completion rate: {{completed}}/{{total new + existing}} ({{%}})
- Average daily task completions: {{avg}}
- Most active project: [[{{project}}]] ({{task count}} tasks)
**Collaboration:**
- People most frequently mentioned: {{top 3}}
- Cross-project connections: {{count meetings involving 2+ projects}}
**Quality:**
- ADRs with quality indicators: {{count}}/{{total}} ({{%}})
- Stale projects updated: {{count}}
- Documentation created: {{new Page notes}}
---
## 🏷️ Tags This Week
Most frequently used tags:
- #{{tag1}} ({{count}} notes)
- #{{tag2}} ({{count}} notes)
- #{{tag3}} ({{count}} notes)
---
## Related Notes
- [[Weekly Summary {{previous week}}]] (last week)
- Active projects: {{list wiki-links}}
- Team members involved: {{list Person wiki-links}}
Phase 4: Output Options
Based on user's --output flag:
-
Console Output (default)
- Print the summary to console
- Offer to save as Page note
-
Create Page Note
- Save as
Page - Weekly Summary YYYY-MM-DD.md - Frontmatter:
yaml
type: Page title: Weekly Summary {{START_DATE}} - {{END_DATE}} created: {{TODAY}} tags: - weekly-summary - productivity - meta/reporting date-range: start: {{START_DATE}} end: {{END_DATE}}
- Save as
-
Append to Weekly Log
- Check if
Page - 2026 Weekly Summaries.mdexists - Append this week's summary
- Add to table of contents
- Check if
Phase 5: Follow-up Prompts
After generating summary, offer:
✅ Weekly summary generated!
Would you like to:
1. Export to Page note for archiving
2. Review blocked tasks and challenges
3. Generate next week's priorities as Task notes
4. Create meeting follow-up tasks
5. Update project notes with progress
Use Cases
Weekly Reviews:
- Personal productivity tracking
- Team status reports
- Manager updates
- Sprint retrospectives
Time Tracking:
- Where did time go this week?
- Which projects got attention?
- Meeting time vs. execution time
Accountability:
- Track commitment completions
- Identify recurring blockers
- Measure velocity trends
Historical Record:
- Archive weekly progress
- Year-end reviews
- Performance self-assessments
Configuration
Date Range Detection
// Default: Last 7 days
if (args.includes('--last-week')) {
// Previous Monday - Sunday
start = previousMonday;
end = previousSunday;
} else if (args.includes('--from') && args.includes('--to')) {
// Custom range
start = parseDate(args['--from']);
end = parseDate(args['--to']);
} else {
// Last 7 days from today
start = today - 7;
end = today;
}
Customization
Users can customize by editing .claude/skills/weekly-summary/SKILL.md:
- Adjust date range defaults
- Add/remove sections
- Change prioritization logic
- Modify output format
- Add custom metrics
Performance
- 5 parallel agents = 5x faster than sequential
- ~100 notes/week: 20-40 seconds
- ~500 notes/week: 1-2 minutes
- Uses Haiku for speed (Sonnet alternative for deeper analysis)
Notes
- Excludes templates and system notes
- Handles missing data gracefully (some weeks may have no ADRs, etc.)
- Chronological ordering within sections
- Links preserved for easy navigation
- Can run for any historical week
- Output is ready to share with teams or managers
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?