# Notes Reflect

> Periodic review of the vault — synthesises recent daily notes, surfaces themes, summarises project activity, and identifies open questions. Use when doing a weekly or monthly review, or when the user asks "what did I work on this week" / "what themes came up" / "reflect on my notes". Read-only unless the user asks to create or modify notes.

- Skill: `wellcaffeinated/notes-reflect` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wellcaffeinated/notes-reflect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wellcaffeinated/notes-reflect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wellcaffeinated (https://skillmd.com/u/wellcaffeinated)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wellcaffeinated/notes-reflect

---


# Notes — Reflect

A periodic review skill. Read the vault, synthesise, present. Do not create or modify anything unless the user explicitly asks.

## Before starting

**Invoke the `notebook:notes-workflow` skill before proceeding.** It verifies the vault connection, reads `VAULT.md` for conventions, and provides the CLI patterns this skill depends on. If it is not available, ask the user to install the `notebook` plugin.

## What this skill does

1. In parallel: query recent daily note activity and project state — see VAULT.md for how to access each
2. Read individual daily notes and relevant project notes in full for detail
3. Identify themes, recurring topics, open questions, and wins
4. Present a structured synthesis to the user

## Handling ambiguity

Daily notes and project notes are often messy and lack context. If a note's meaning or intent is unclear, don't guess — flag it when presenting the synthesis and ask the user what they meant or what the outcome was. This is especially useful for single-line entries or cryptic shorthand.

## Suggested structure for the reflection output

- **What you worked on** — projects and topics that appeared across the period
- **Themes** — patterns or ideas that recurred
- **Open questions** — things that came up but weren't resolved
- **Wins** — things that got done
- **Possible next actions** — surfaced from context, not prescriptive

## Read-only by default

Present findings conversationally. If the user wants a reflection note created, ask where they'd like it filed before creating anything.