notes-locator

Search repo-local and centralized notes directories, returning categorized file paths, types, and headers.

4|1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/gtheys/pi-my-rifle-ext --skill notes-locator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notes-locator
Source: https://github.com/gtheys/pi-my-rifle-ext/tree/main/skills/notes-locator
Command: npx skills add https://github.com/gtheys/pi-my-rifle-ext --skill notes-locator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you discover and surface relevant documents in a project's notes/ directory, enabling faster access to specs, tickets, research docs, PR descriptions, and related context.

Core Features & Use Cases

  • Notes discovery: Locate and categorize documents across notes/ subdirectories (research, specs, tickets, prs, etc.).
  • Repo-local and centralized support: Works with both repo-local notes/ and a centralized notes root via $LLM_NOTES_ROOT.
  • Organized results: Returns structured results with file paths, types, and headers, enabling quick context checks without content overload.

Quick Start

Ask me to locate notes for a topic and I will search the repo's notes/ directories and return matching files with brief headers.

Frequently Asked Questions about notes-locator

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

FAQPage Schema
How do I locate project notes and specs across multiple directories?

To locate project notes, this tool searches both repo-local notes/ directories and a centralized notes root via $LLM_NOTES_ROOT. It categorizes matching files into research, specs, tickets, PRs, and general notes, returning file paths and headers to support faster context gathering.

Can I search a centralized notes root instead of just local repository notes?

Yes, you can search a centralized notes root by setting the $LLM_NOTES_ROOT environment variable. The tool queries both this centralized location and the repository's local notes/ directory, organizing all discovered documents by category for quick access.

What is the best way to find research docs and tickets without reading full file contents?

The best way to find research docs and tickets without content overload is using a notes locator that surfaces file paths, types, and headers. It scans the notes/ directory structure and returns categorized metadata, enabling quick context checks without opening or reading entire files.

Does the notes locator work with existing repository notes structures?

Yes, the notes locator respects the repository's existing notes structure. It searches through standard subdirectories like research, specs, tickets, and prs, organizing results by category while preserving the project's original file organization and directory hierarchy.

How do I gather context for due diligence by searching project notes and PR descriptions?

To gather context for due diligence, search project notes and PR descriptions by querying the notes/ directory. The locator surfaces relevant documents organized by category—specs, tickets, PRs, and research—returning file paths and headers to accelerate context gathering without reading full contents.