folder-auditlisted
Install: claude install-skill mcmespinaa/folder-structure-protocol
# Folder Architecture Audit Skill
Evaluates a project folder against the ICM five-layer context hierarchy and produces a scored audit report. The base audit scores Layers 0–1 and Tools (X/16). If ICM pipeline stages are detected, an extended assessment covers Layers 2–4 (X/18).
## Trigger
Use this skill when:
- The user asks to audit, evaluate, review, or score a project's folder structure
- The user is onboarding Claude Code to an existing project
- The user reports degraded AI output quality and the cause may be structural
- The user says "folder audit", "evaluate structure", "score this project", "check folder quality", or similar
## Procedure
### Step 1: Snapshot the File Tree
Generate a file tree of the target project. Exclude hidden directories (except `.claude/`), `node_modules/`, `dist/`, `build/`, `__pycache__/`, and other generated directories.
```
Use two Bash commands:
1. find [project-path] -not -path '*/node_modules/*' -not -path '*/dist/*' -not -path '*/build/*' -not -path '*/__pycache__/*' -not -name '.DS_Store' | grep -v '/\.' | sort | head -150
2. find [project-path]/.claude -type f 2>/dev/null | sort
```
The second command captures the `.claude/` directory (skills, settings) which the first command's `grep -v '/\.'` excludes.
### Step 2: Score Layer 0 -- The Map (CLAUDE.md)
Read the root CLAUDE.md (or equivalent root config). Score each criterion 0 or 1:
| # | Criterion | Check |
|---|-----------|-------|
| 1 | Root config exists | CLAUDE.md or e