monthly-review

Aggregate weekly review notes into a consolidated monthly markdown overview.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/alexanderop/vault-astro --skill monthly-review-alexanderop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monthly-review
Source: https://github.com/alexanderop/vault-astro/tree/main/.claude/skills/monthly-review
Command: npx skills add https://github.com/alexanderop/vault-astro --skill monthly-review-alexanderop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aggregates scattered weekly review notes into a single, consistent monthly overview so you can quickly understand themes, achievements, and public notes without manual collation.

Core Features & Use Cases

  • Determine month boundaries and compute ISO week ranges for the target month.
  • Locate and read weekly reviews from src/content/notes/private, extract week summaries, key events, learnings, and referenced public notes.
  • Synthesize major themes and achievements, build a monthly note with correct YAML frontmatter and wiki-links, and provide an interactive review step before saving. Use cases include personal monthly retrospectives, end-of-month reporting, and maintaining a searchable knowledge archive.

Quick Start

Create a monthly review for the target month by aggregating weekly reviews from src/content/notes/private and save the generated note to src/content/notes/private/YYYY-MM.md.

Frequently Asked Questions about monthly-review

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

FAQPage Schema
How do I aggregate weekly review notes into a monthly overview automatically?

To aggregate weekly review notes into a monthly overview, this Skill globs your private notes, extracts week summaries and key events, and synthesizes them into a consolidated monthly markdown file. It automatically identifies ISO week numbers and month boundaries.

Can I generate a monthly retrospective from Obsidian notes that span across different months?

Yes, you can generate a monthly retrospective from Obsidian notes that span across months. The Skill correctly identifies month boundaries and computes ISO week ranges to include partial weeks and weeks that span months in the overview.

How does generating a monthly review handle YAML frontmatter and wiki-links?

Generating a monthly review handles YAML frontmatter and wiki-links by parsing your existing private notes and writing a new consolidated monthly markdown file with proper frontmatter and correctly formatted wiki-links to referenced public notes.

What is the best way to summarize weekly notes for end-of-month reporting?

The best way to summarize weekly notes for end-of-month reporting is to use an aggregation tool that extracts learnings and key events from your weekly files, synthesizes major themes and achievements, and provides an interactive review step before saving.

Do I need a specific folder structure to consolidate weekly reviews into a monthly markdown file?

Yes, you need a specific folder structure to consolidate weekly reviews. The Skill locates and reads weekly reviews specifically from the src/content/notes/private directory and saves the generated monthly note directly into that same path.

Why are my partial weekly notes not showing up in the monthly summary?

Partial weekly notes might not show up in the monthly summary if they are not stored in the expected src/content/notes/private directory, as the Skill relies on this specific path to glob files and compute ISO week ranges for the target month.