skills.rest
Redtropig
RedtropigCOMMUNITY
Explore all skills by this author →
GitHub

project-indexing

Index project files into a machine-friendly PROJECT-TOC.md with freshness validation.

14|Updated May 28, 2026
Search Tags:#indexing#codebase#navigation#glob#toc#project-structure#file-discovery
One-click install
npx skills add https://github.com/Redtropig/harness-anchor --skill project-indexing-redtropig
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-indexing
Source: https://github.com/Redtropig/harness-anchor/tree/main/skills/project-indexing
Command: npx skills add https://github.com/Redtropig/harness-anchor --skill project-indexing-redtropig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PROJECT-TOC.md is the project's machine-friendly index — one line per file, ≤80 chars summary. Reading it is dramatically cheaper than a full Glob traversal.

Core Features & Use Cases

  • Use PROJECT-TOC.md as a fast, machine-friendly index to answer questions like "Where is X defined?"
  • Validate freshness by reading the generated-at commit marker and detecting drift; fall back to Glob when TOC is missing or stale.

Quick Start

Run /index-project at the project root to generate or refresh PROJECT-TOC.md, then search for a file by its definition.

Frequently Asked Questions about project-indexing

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

FAQPage Schema
How do I navigate a large codebase to find where a definition resides?▼

Generate a PROJECT-TOC.md index to navigate a large codebase and locate where a definition resides without performing a full directory traversal.

What is the best way to index project files for fast file discovery?▼

Creating a PROJECT-TOC.md file with one-line summaries under 80 characters provides a fast machine-friendly index for efficient file discovery and lookup.

How do I generate a table of contents for my project structure?▼

Run the index-project command at the project root to generate or refresh PROJECT-TOC.md, validating directory maps and per-file entries to build an accurate project structure index.

What happens if my project TOC is missing or stale during codebase navigation?▼

When the TOC is missing or stale, the system detects drift via the generated-at commit marker and falls back to glob searches to locate files during codebase navigation.

Can I use glob search as a fallback for file discovery in a project?▼

Yes, glob search serves as a fallback for file discovery when the TOC is missing or stale, ensuring file location lookup remains functional without a valid generated index.

Related Skills

Explore More Software Engineering Skills→
alansmelloalansmello

speckit-git-initialize

Initialize a Git repository with an initial commit in Bash or PowerShell.

Community
Intermediate
willietranwillietran
3

coherence-audit

Automate cross-layer coherence checks after merges to detect DRY violations, architecture drift, and security gaps.

Community
Advanced
jubscodesjubscodes
49

gsp-doctor

Analyze GSP project .design directory for structural and configuration drift.

Community
Advanced
SyntaxAsSpiralSyntaxAsSpiral
5

memory-systems

Persist AI agent context across sessions with vector stores and temporal knowledge graphs.

Community
Advanced