Note Graph

Regenerate navigable note graphs from Markdown files when content changes.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/swarm-ai-research/aeon --skill note-graph
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Note Graph
Source: https://github.com/swarm-ai-research/aeon/tree/main/skills/notegraph
Command: npx skills add https://github.com/swarm-ai-research/aeon --skill note-graph

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Note Graph keeps your navigable representation of memory and docs up to date by regenerating the graph whenever content changes, and only notifies on meaningful changes.

Core Features & Use Cases

  • Fingerprint memory and docs Markdown inputs to detect changes.
  • Run an extractor to generate notegraph.json and docs/notegraph.md and docs/notegraph.html from memory/ and docs/, with silent behavior when nothing changed.
  • Open a PR and notify when changes occur, including analysis of new orphans and bundled notes.

Quick Start

Run the notegraph workflow to regenerate the memory/docs graph and update outputs only when changes occur.

Frequently Asked Questions about Note Graph

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

FAQPage Schema
How do I automatically regenerate a navigable graph for markdown memory and docs?▼

To automatically regenerate a navigable graph for markdown memory and docs, this Skill scans memory/**/*.md and docs/**/*.md, computes a fingerprint, and runs an extractor to produce notegraph.json, docs/notegraph.md, and docs/notegraph.html outputs only when content changes are detected.

How does fingerprinting detect changes in markdown documentation files?▼

Fingerprinting detects changes in markdown documentation files by computing a deterministic hash of the memory and docs inputs, comparing it against the previous state, and skipping the extraction workflow entirely if the content remains unchanged, ensuring silent behavior when nothing is modified.

Can I automate a pull request notification when new markdown notes are added?▼

Yes, you can automate a pull request notification when new markdown notes are added, because this Skill seeds a PR and notification workflow specifically when changes occur, including defined verdicts and analysis for new bundled notes and orphaned documentation files.

What is the best way to handle orphaned notes in a navigable documentation graph?▼

The best way to handle orphaned notes in a navigable documentation graph is to run an extraction workflow that compares the current markdown state against previous outputs, automatically identifying new orphans and bundled notes with defined verdicts to notify you of meaningful structural changes.

Does this documentation graph generator work without external dependencies?▼

Yes, this documentation graph generator works without external dependencies, using only internal scripts to scan markdown files, compute deterministic fingerprints, generate JSON and HTML outputs, and manage PR workflows based on detected content changes.

Why are my markdown documentation outputs not updating when nothing changes?▼

Your markdown documentation outputs are not updating because the extraction workflow enforces deterministic outputs and operates silently when fingerprinting detects no changes, ensuring the graph is only regenerated and PRs are only opened for meaningful content modifications.