Setup Structure Index
Installs a two-tier codebase index (CLAUDE.md file map + per-directory YAML) with a hook that enforces upkeep.
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 15, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 7e9d052
Built the prescribed CLAUDE.md file map, .claude/structure/*.yaml, and .claude/settings.json TaskCompleted hook on a throwaway 4-file repo; all three artifacts parsed as valid JSON/YAML, unlike the baseline's static prose notes that carry zero enforcement. Independently confirmed against the locally installed Claude Code settings schema that TaskCompleted is a genuine hook event, not an invented one.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 9/10
- Docs & honesty 5/5
What Setup Structure Index does
Sets up a compact zero-cost file map inside CLAUDE.md plus detailed per-directory export-signature YAML files in .claude/structure/, and wires a TaskCompleted hook that blocks task completion when files/classes/functions are added, removed, or renamed without updating the index. Triggers on "set up structure index", "add codebase structure tracking", "create structure files", or "set up code structure YAML".
How to install Setup Structure Index
git clone https://github.com/shannonbay/setup-structure-index
cd setup-structure-index
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/setup-structure-index
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Setup Structure Index
-
/setup-structure-indexInstalls a two-tier codebase index (CLAUDE.md file map + per-directory YAML) with a hook that enforces upkeep.
It also activates on plain-language prompts like these:
-
Set up a structure index so my CLAUDE.md stays in sync with the codebase -
Add per-directory YAML export signatures and a hook to enforce updates -
Create a codebase structure map that blocks tasks when files get renamed
Frequently asked questions
- Is the Setup Structure Index skill free?
- Yes. The skill itself is free from shannonbay/setup-structure-index. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Setup Structure Index work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 15, 2026. Verdict: Tested · Works. Built the prescribed CLAUDE.md file map, .claude/structure/*.yaml, and .claude/settings.json TaskCompleted hook on a throwaway 4-file repo; all three artifacts parsed as valid JSON/YAML, unlike the baseline's static prose notes that carry zero enforcement. Independently confirmed against the locally installed Claude Code settings schema that TaskCompleted is a genuine hook event, not an invented one.
- What is the Setup Structure Index SkillProof Score?
- 9.6/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 9/10, docs & honesty 5/5.
- How do I install Setup Structure Index?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Setup Structure Index with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.