daily-notes_skill

Overview

This skill manages daily notes stored in the workspace notes directory using the M-D-YYYY.md filename format (for example, 1-1-2026.md). It provides commands to view, create, and fetch ranges of daily notes and integrates with the workspace paths API to find the configured notes location. Use it to read today’s note, fetch the last week of notes, or add entries to a specific date.

How this skill works

The skill expects the NOTES_DIR environment variable to be set to the workspace notes path (retrieved from the workspace paths API). It runs a small CLI script that supports commands such as get-today, get-note, get-last-x, and get-range, returning file contents or creating a file when needed. When invoked, the skill reads the requested note files, parses their contents, and returns summaries or raw text as requested; edits should preserve existing content by using append/edit operations.

When to use it

• When you want to open or create today's daily note.
• When you ask to see what you worked on in the last 7 days or another recent range.
• When you reference a note by date or use @notes/ in a request.
• When you want to add an entry to a specific day’s note.
• When you need to fetch notes between two calendar dates.

Best practices

• Always set NOTES_DIR to the workspace notes path from Settings > Storage before running commands.
• Convert natural language dates to M-D-YYYY without leading zeros (e.g., 3-5-2026).
• Handle missing note files gracefully—return a helpful message and create a new file only when appropriate.
• Preserve existing content by appending edits rather than overwriting files.
• Limit fetches to reasonable ranges (e.g., last 7 or 30 days) to avoid large responses.

Example use cases

• Fetch and summarize tasks and highlights from the last 7 days to prepare a weekly review.
• Open or create today’s note and append a status update or completed task.
• Retrieve a specific date’s note by providing its M-D-YYYY identifier (e.g., get-note 1-1-2026).
• Get notes between two ISO dates to compile project progress for a date range.
• Quickly show recent notes when the user references @notes/ or asks “What did I do this week?”