weekly-review

Consolidates weekly activity logs into a structured retrospective and actionable plan.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/derrybirkett/shulkerbox --skill weekly-review-derrybirkett
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-review
Source: https://github.com/derrybirkett/shulkerbox/tree/main/skills/productivity/weekly-review
Command: npx skills add https://github.com/derrybirkett/shulkerbox --skill weekly-review-derrybirkett

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of losing track of progress, learning, friction, and priorities when weeks pass, by consolidating your logs into a structured retrospective and a clear plan for what to do next.

Core Features & Use Cases

  • End-of-week reflection: Reads your activity log, inbox, friction log, insights, and prior reviews to ground the review in real evidence.
  • Prompts-driven insight capture: Guides you through four specific questions to extract friction, actionable process changes, what you learned, and what’s been nagging you.
  • Actionable output for iteration: Writes a review to notes/reviews/YYYY-WW.md and updates the inbox, friction log, and skills plan so the repository improves over time.
  • Monthly skill audit (pruning weeks): Every 4th review, inventories skills and checks usage signals to keep, merge, or prune inactive skills.

Quick Start

Run weekly review or /weekly-review to generate your structured end-of-week reflection and save it into notes/reviews/.

Frequently Asked Questions about weekly-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a weekly retrospective from my activity logs and notes?

A weekly retrospective consolidates your activity log, inbox, friction log, and insights into an actionable next-week plan. It prompts you for specific process changes and learnings, then writes the structured review directly to your notes repository.

What is the best way to automate a recurring weekly review for continuous improvement?

Automating a recurring weekly review involves reading prior notes to ground your reflection in real evidence, capturing friction and learnings through targeted prompts, and writing the output to a structured markdown file for consistent backlog planning.

How do I perform a skills audit to prune inactive workflows from my repository?

A skills audit inventories your existing skills and checks usage signals to decide whether to keep, merge, or prune inactive ones. This review process triggers conditionally on a recurring schedule, specifically every fourth weekly review.

Can I use my friction log and inbox to plan actionable process changes for next week?

Yes, you can use your friction log and inbox to plan actionable process changes. The review workflow reads these files to identify ongoing issues, prompts you for targeted solutions, and updates the logs to ensure your repository improves over time.

Does this weekly review workflow require specific file formats or directory structures?

The weekly review workflow requires specific notes files located under a ./notes/ directory, including your activity log and friction log. It conditionally writes the generated retrospective output as a markdown file formatted YYYY-WW.md inside notes/reviews/.

What should a weekly review capture to prevent losing track of priorities and progress?

A weekly review should capture friction, actionable process changes, learnings, and nagging issues to prevent losing track of progress. By consolidating these signals with prior reviews, it creates a clear momentum plan for the upcoming week.