Setup Structure Index

This skill should be used when the user asks to "set up structure index", "add codebase structure tracking", "create structure files", "set up code structure YAML", or needs to set up the codebase structure index system in a project. It creates a two-tier structure index (compact file map in CLAUDE.md + detailed YAML files) and configures a TaskCompleted hook to enforce updates.

17 stars 1 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add shannonbay/setup-structure-index --skill setup-structure-index

Manual install

git clone --depth 1 https://github.com/shannonbay/setup-structure-index.git /tmp/setup-structure-index
mkdir -p ~/.claude/skills
cp -r /tmp/setup-structure-index/. ~/.claude/skills/setup-structure-index

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Codebase Structure Index — Setup Guide

A two-tier system for maintaining a living structural index of your codebase. A compact file map in CLAUDE.md provides instant zero-cost orientation every session, while detailed per-directory YAML files are read on demand when deeper exploration is needed.

## Why Two Tiers?

Most of the exploration savings come from knowing *where things are*, not their exact method signatures. A compact file map (~100-200 lines) embedded in CLAUDE.md captures ~70% of the navigation value at zero extra token cost (CLAUDE.md is already loaded into the system prompt). Detailed YAML files with full signatures are only needed when working in an unfamiliar area of the codebase.

**Token economics of the old single-tier approach:**
- Reading a full structure YAML (~1000-2000 lines per module) every session
- Most sessions only touch 1-2 directories, wasting tokens on irrelevant detail
- Method signatures are low value — you still need to read source before editing

**Token economics of the two-tier approach:**
- Tier 1 (file map in CLAUDE.md): 0 extra tokens (already in system prompt)
- Tier 2 (detailed YAML): read only when needed, split by directory for targeted reads
- Net result: most sessions read 0 extra lines; deep exploration reads ~100-300 lines

## What It Creates

### Tier 1: Compact File Map (in CLAUDE.md)

Read the full skill on GitHub

Details

Skill name: setup-structure-index
Repository: shannonbay/setup-structure-index
Repo updated: 9 February 2026

FAQ

What does the Setup Structure Index skill do?

How do I install the Setup Structure Index skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add shannonbay/setup-structure-index --skill setup-structure-index. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Setup Structure Index popular?

It lives in shannonbay/setup-structure-index, which has 17 GitHub stars and 1 forks.

Related skills

Codex Pet Generator

wyddy7/codex-pet-generator

Create Codex desktop pets from character references by defining row semantics, generating tiny-UI-readable loops, approving or rejecting rows, following slicing guidance, packing a 1536x1872 spritesheet with the bundled packer, validating it, and installing under ~/.codex/pets.

Software Development

Coolify Manager

ajmcclary/Coolify-Manager

Manage and troubleshoot Coolify deployments using the official CLI and API. Use this skill when the user needs help with Coolify server management, WordPress troubleshooting on Coolify, debugging service issues, checking SSL certificates, accessing containers, or managing applications and databases through Coolify. Particularly useful for diagnosing down services, fixing .htaccess issues, REST API problems, and performing deployment operations.

Software Development

Grok Search

Autsunset/grok-search

Use when the user explicitly asks to search the web, check latest/current facts, fetch a URL, or discover pages on a website. Also use when the user asks to install, configure, or setup grok-search (API URL/key, chat vs responses). Do not use for local code search or stable offline knowledge unless the user asks for live web access.

Software Development

Avito API

MissiaL/avito-api

Integrate and troubleshoot Avito Business API: listings, Messenger, orders, delivery, jobs, Autoload, Autoteka, Promo and Ads. Look up bundled endpoint schemas, choose authentication and official Ads SDKs, and check migrations. Use for Avito API requests and integrations, not ordinary browsing of avito.ru.

Software Development

Alibaba Java Coding Guidelines Skill

ns3154/alibaba-java-coding-guidelines-skill

Use when 需要按 Alibaba Java Coding Guidelines（阿里巴巴 Java 编码规范）审查、生成或重构 Java、Spring、MyBatis、Maven、MySQL、SQL、日志、异常、安全或数据库相关代码。

Software Development

Audit Flow

ArunJRK/audit-flow

Interactive system flow tracing across CODE, API, AUTH, DATA, NETWORK layers with SQLite persistence and Mermaid export. Use for security audits, compliance documentation, flow tracing, feature ideation, brainstorming, debugging, architecture reviews, or incident post-mortems. Triggers on audit, trace flow, document flow, security review, debug flow, brainstorm, architecture review, post-mortem, incident review.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.