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.