note_skill

Overview

This skill saves important context to a persistent in-repo notepad file so key facts survive conversation compaction. It provides simple commands to append, view, prune, and clear notes across three durable sections: Priority, Working Memory, and MANUAL. Use it to keep critical project facts, debugging breadcrumbs, and permanent team info accessible across agent sessions.

How this skill works

The skill creates and updates a .omc/notepad.md file and parses command flags to determine where to store content. It timestamps Working Memory entries, enforces a 500-character limit for Priority Context, and loads Priority and recent Working Memory entries automatically at session start. Commands allow showing contents, pruning older working entries, and clearing temporary notes while preserving priority and MANUAL entries.

When to use it

• Save short, critical facts that must always load at session start (Priority).
• Record session-specific findings, errors, or debugging steps (Working Memory).
• Store permanent references like team contacts, secrets locations, or deployment notes (MANUAL).
• Quickly capture context before a session compaction or agent handoff.
• Inspect or prune accumulated ephemeral notes to avoid bloat.

Best practices

• Keep Priority Context concise (under 500 characters) to avoid eating context budget.
• Use timestamps and short sentences in Working Memory for readable debugging trails.
• Reserve MANUAL for long-lived entries that should never be auto-pruned.
• Prune Working Memory regularly (older than 7 days) to reduce noise.
• Confirm saved content with the --show command after critical updates.

Example use cases

• Add a quick note about a reproducible bug encountered during testing.
• Mark the project package manager or important config paths in Priority so agents always know them.
• Store an internal contact email or deployment URL in MANUAL for future lookups.
• Log step-by-step troubleshooting notes across a debugging session.
• Clear ephemeral notes after a release while keeping permanent documentation intact.