skills.rest
ZHLX2005
ZHLX2005COMMUNITY
Explore all skills by this author →
GitHub

index-repos

Creates PROJECT_INDEX.md and PROJECT_INDEX.json for multiple repositories using parallel subagents.

3|1|Updated Apr 14, 2026
Search Tags:#automation#claude code#codebase analysis#project index#parallel subagents#batch workflow#repository indexing
One-click install
npx skills add https://github.com/ZHLX2005/sl --skill index-repos-zhlx2005
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: index-repos
Source: https://github.com/ZHLX2005/sl/tree/main/skills/index-repos
Command: npx skills add https://github.com/ZHLX2005/sl --skill index-repos-zhlx2005

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Indexing many repositories one by one is slow and repetitive. This Skill scans the .claude/repo directory, finds repositories missing PROJECT_INDEX.md or PROJECT_INDEX.json, and generates both index files for all of them concurrently using parallel subagents. ## Core Features & Use Cases - Batch Repository Scanning: Lists all repositories under .claude/repo using direct filesystem tools (ls, Glob), excluding the _read directory and bypassing git-index limitations caused by .gitignore. - Parallel Subagent Indexing: Launches one background general-purpose subagent per repository in a single message, each loading the sc:index-repo skill to analyze structure, entry points, and core modules. - Deterministic Verification: Validates results by checking file existence and byte size with wc instead of reading subagent transcripts, then reports total and missing index counts. - Use Case: After cloning ten project repositories into .claude/repo, run this Skill once to produce human-readable PROJECT_INDEX.md and machine-readable PROJECT_INDEX.json for every repository in parallel. ## Quick Start Ask the AI to create PROJECT_INDEX.md and PROJECT_INDEX.json for all repositories under .claude/repo that do not have indexes yet, running each repository in a parallel subagent.

Frequently Asked Questions about index-repos

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

FAQPage Schema
How do I create project indexes for multiple repositories at once?▼

Scan the .claude/repo directory for repositories missing PROJECT_INDEX.md or PROJECT_INDEX.json, then launch one background subagent per repository in a single message. Each subagent analyzes the repository structure and writes both index files independently.

How to run parallel subagents for batch repository indexing?▼

Issue all Agent tool calls in the same message with run_in_background set to true and subagent_type general-purpose. The system schedules them concurrently; issuing them in separate messages forces serial execution.

Why does git ls-files show no repositories in .claude/repo?▼

Repositories under .claude/repo are typically excluded by .gitignore, so git commands like ls-files and status cannot see them. Use direct filesystem tools such as ls, Glob, or Get-ChildItem to list the directories.

Should subagent prompts use relative or absolute paths?▼

Always use absolute paths in subagent prompts. Subagents do not inherit the main session's cd state, and Bash working directory changes can persist across calls, causing files to be written to wrong locations.

How do I verify subagent results without reading output files?▼

Check the generated artifacts directly with wc -c on PROJECT_INDEX.md and PROJECT_INDEX.json instead of reading subagent .output files, which are full JSONL transcripts that overflow context. Task notifications provide sufficient completion summaries.

Related Skills

Explore More Software Engineering Skills→
vaughnangoyvaughnangoy

clone-repo

Clone GitHub and other git repositories into a structured local directory layout.

Community
Advanced
linkerdoglinkerdog
15

rara-codebase

Generate a subsystem-aligned repository map with file-by-file reading paths.

Official
Basic
Jimmy-JungJimmy-Jung

deep-index

Index a codebase to generate module summaries, dependency graphs, and entry-point maps.

Community
Advanced
VMAFxVMAFx
3

lint-all

Run multiple static analysis tools and merge findings into one report.

Official
Advanced