notes-review

Analyze markdown notes to surface weekly and monthly progress and tasks.

5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/gabrielkoerich/skills --skill notes-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notes-review
Source: https://github.com/gabrielkoerich/skills/tree/main/notes-review
Command: npx skills add https://github.com/gabrielkoerich/skills --skill notes-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps individuals organize and derive actionable insights from personal markdown notes and journals by surfacing accomplishments, pending work, and alignment with goals using qmd-powered semantic search.

Core Features & Use Cases

  • Semantic search over notes and journals to surface relevant context quickly.
  • Weekly/monthly reflection reports to summarize progress and priorities.
  • Goal alignment assessment by cross-referencing notes with goals data (optional).
  • JSON output for automation and integration with agents or dashboards.

Quick Start

Run the notes-review skill to generate a period summary by pointing it at your notes directory and invoking the review script.

Frequently Asked Questions about notes-review

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

FAQPage Schema
How do I generate weekly and monthly progress reports from markdown notes?

You can generate weekly and monthly progress reports from markdown notes by running a script that analyzes your notes directory to surface accomplishments, pending work, and upcoming tasks. It parses dated notes to summarize progress across defined periods.

How does semantic search work for finding context in personal journals?

Semantic search for personal journals works by using qmd to index markdown notes, allowing you to surface relevant context quickly based on meaning rather than exact keywords. This requires the optional qmd dependency and a defined notes directory to function properly.

Can I assess goal alignment by cross-referencing my notes with goals data?

Yes, you can assess goal alignment by cross-referencing your notes with a goals directory. The analysis matches your reflections and accomplishments against your goals data to determine alignment, provided you have configured the optional goals directory.

Do I need Python 3 to analyze markdown notes for insights?

Yes, you need Python 3 to analyze markdown notes for insights, as the script relies on it to process your notes directory. The qmd tool for semantic search is optional but also requires Python 3 to function properly.

What is the best way to integrate markdown notes insights with dashboards?

The best way to integrate markdown notes insights with dashboards is to use the JSON output generated by the notes review. This format allows automation and integration with agents or dashboards to display your weekly and monthly progress data.

What are the limitations of using markdown notes for structured reflection?

A limitation of using markdown notes for structured reflection is that the analysis depends on a defined notes directory and properly dated notes. Without the optional qmd tool, semantic search capabilities are unavailable, limiting context surfacing.