note

Save non-obvious learnings to NOTES.md under date and category sections.

4|2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/blake-simpson/belmont --skill note-blake-simpson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: note
Source: https://github.com/blake-simpson/belmont/tree/main/plugin/skills/note
Command: npx skills add https://github.com/blake-simpson/belmont --skill note-blake-simpson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill saves non-obvious learnings and discoveries to NOTES.md so they persist across sessions and context refreshes, helping you maintain a running record of insights and patterns.

Core Features & Use Cases

  • Persistent notes: stores non-obvious learnings to feature-level or global NOTES.md files for cross-session reference.
  • Contextual organization: categorizes notes by issue type and date to enable quick retrieval.
  • Use Case: after debugging a tricky issue, save the exact environment quirks and workarounds to NOTES.md for future teammates.

Quick Start

Save a non-obvious learning to NOTES.md in the correct location for persistence across sessions.

Frequently Asked Questions about note

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

FAQPage Schema
How do I persist learnings and notes across sessions?

To persist learnings across sessions, save non-obvious discoveries to a NOTES.md file. This maintains a running record of insights, categorizing notes by date and issue type for quick retrieval.

What's the best way to save debugging workarounds for future reference?

Saving debugging workarounds to NOTES.md provides persistent reference for future teammates. The note is categorized under the matching date section and issue type within feature-level or global files.

Where should context notes be stored for cross-session retrieval?

Context notes should be stored in the appropriate {base}/NOTES.md for feature-level scope or global .belmont/NOTES.md for broader scope, ensuring non-obvious learnings persist across context refreshes.

Can I organize session notes by issue type and date?

Yes, notes are categorized by issue type and date to enable quick retrieval. This contextual organization ensures that environment quirks and patterns are structured logically within NOTES.md files.

When do I need to save non-obvious learnings to a markdown file?

You need to save non-obvious learnings when you discover environment quirks or workarounds during debugging. Storing these insights in NOTES.md ensures the knowledge persists across context refreshes and sessions.