Index repo

Skill senior-sigan/llm-skills/skills/index-repo

Install

npx -y skills add senior-sigan/llm-skills --skill index-repo

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Repository Indexing - 94% token reduction

SKILL.md

2.7 KB, as published. Nobody here has run it

Repository Index Creator

📊 Index Creator activated

Problem Statement

Before: Reading all files → 58,000 tokens every session After: Read PROJECT_INDEX.md → 3,000 tokens (94% reduction)

Index Creation Flow

Phase 1: Analyze Repository Structure

Parallel analysis (5 concurrent Glob searches):

Code Structure

src/**/*.{ts,py,js,tsx,jsx}
lib/**/*.{ts,py,js}

Documentation

docs/**/*.md
*.md (root level)
README*.md

Configuration

*.toml
*.yaml, *.yml
*.json (exclude package-lock, node_modules, .venv)

Tests

tests/**/*.{py,ts,js}
**/*.test.{ts,py,js}
**/*.spec.{ts,py,js}

Scripts & Tools
```
scripts/**/*
bin/**/*
tools/**/*
```

Phase 2: Extract Metadata

For each file category, extract:

Entry points (main.py, index.ts, cli.py)
Key modules and exports
API surface (public functions/classes)
Dependencies (imports, requires)

Phase 3: Generate Index

Create PROJECT_INDEX.md with structure:

# Project Index: {project_name}

Generated: {timestamp}

## 📁 Project Structure

{tree view of main directories}

## 🚀 Entry Points

- CLI: {path} - {description}
- API: {path} - {description}
- Tests: {path} - {description}

## 📦 Core Modules

### Module: {name}
- Path: {path}
- Exports: {list}
- Purpose: {1-line description}

## 🔧 Configuration

- {config_file}: {purpose}

## 📚 Documentation

- {doc_file}: {topic}

## 🧪 Test Coverage

- Unit tests: {count} files
- Integration tests: {count} files
- Coverage: {percentage}%

## 🔗 Key Dependencies

- {dependency}: {version} - {purpose}

## 📝 Quick Start

1. {setup step}
2. {run step}
3. {test step}

Phase 4: Validation

Quality checks:

All entry points identified?
Core modules documented?
Index size < 5KB?
Human-readable format?

Usage

Create index:

/index-repo

Update existing index:

/index-repo mode=update

Quick index (skip tests):

/index-repo mode=quick

Token Efficiency

ROI Calculation:

Index creation: 2,000 tokens (one-time)
Index reading: 3,000 tokens (every session)
Full codebase read: 58,000 tokens (every session)

Break-even: 1 session 10 sessions savings: 550,000 tokens 100 sessions savings: 5,500,000 tokens

Output Format

Creates two files:

PROJECT_INDEX.md (3KB, human-readable)
PROJECT_INDEX.json (10KB, machine-readable)

Index Creator is now active. Run to analyze current repository.