notes

Capture lightweight annotation notes for project and session graph nodes.

2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/jscott3201/ai-agent-skills --skill notes-jscott3201
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notes
Source: https://github.com/jscott3201/ai-agent-skills/tree/main/skills/notes
Command: npx skills add https://github.com/jscott3201/ai-agent-skills --skill notes-jscott3201

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents loss of context by capturing lightweight annotations (rationale, observations, todos, bookmarks) and attaching them to graph nodes so future sessions and agents can recall why decisions were made and what to revisit.

Core Features & Use Cases

  • Auto-annotation: Skills and agents create Note nodes during workflows and attach them to targets such as CodeLocation, Decision, Milestone, DeferredItem, or Session.
  • Classified notes: Notes are typed (todo, rationale, observation, bookmark) with author attribution (user vs agent) to support targeted triage and lifecycle rules.
  • Listing & triage: Query, filter, and triage notes by kind, target, age, and author; stale TODOs are surfaced for promotion or removal.
  • Context bridge: Agents may optionally share observations and warnings across active peers to surface concurrent risks or discoveries.

Quick Start

Add a rationale note to the current session by invoking add with the note text, for example: add rationale Chose BTreeMap because keys need ordering for range scans.

Frequently Asked Questions about notes

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

FAQPage Schema
How do I capture rationale and context notes during a coding session?

Capture lightweight annotation notes for project and session graph nodes by invoking add with the note text. This records rationales, observations, todos, and bookmarks directly into your workflow.

What is the best way to triage stale TODOs attached to project decisions?

Triage stale TODOs by querying and filtering notes by kind, target, age, and author. Stale TODOs are surfaced for promotion or removal to maintain accurate project context.

How do agents share observations and warnings across active peers?

Agents optionally share observations and warnings across active peers to surface concurrent risks or discoveries. This context bridge links notes between agents working simultaneously.

Can I attach annotations to specific code locations and milestones?

Yes, you can attach annotations to targets like CodeLocation, Decision, Milestone, DeferredItem, or Session. Notes are written as Note nodes into SeleneDB sessions for future recall.

Do I need SeleneDB to store and retrieve knowledge graph annotations?

Yes, SeleneDB is required. The Skill writes Note nodes into SeleneDB sessions and attaches them to graph nodes so future sessions and agents can recall why decisions were made.