hidden-folder-audit
Audit and consolidate hidden folders in a repository. Identifies duplicates, dead directories, and consolidation opportunities for .agent-os/, .ai/, .claude/, and other hidden folders.
npx skills add majiayu000/claude-skill-registry --skill hidden-folder-audit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Hidden Folder Audit Skill Systematic audit and consolidation of hidden (dot) folders in a repository. Identifies duplicate configurations, dead symlinks, orphaned directories, and consolidation opportunities to establish a clean, maintainable folder structure. ## Version Metadata ```yaml version: 1.2.0 python_min_version: '3.10' dependencies: [] compatibility: tested_python: - '3.10' - '3.11' - '3.12' - '3.13' os: - Windows - Linux - macOS ``` ## When to Use - Repository has accumulated multiple hidden folders over time - Multiple AI/agent configuration directories exist (`.agent-os/`, `.ai/`, `.claude/`) - Symlinks point to non-existent targets - Unclear which configuration is authoritative - Preparing for repository restructure or cleanup - After inheriting or forking a repository - Before establishing new folder standards ## Audit Process ### Step 1: Inventory All Hidden Folders List all hidden directories at the repository root. ```bash # List all hidden directories (excluding .git) find . -maxdepth 1 -type d -name ".*" ! -name ".git" | sort # With sizes du -sh .*/ 2>/dev/null | grep -v "^0" | sort -hr # Include symlinks find . -maxdepth 1 \( -type d -o -type l \) -name ".*"
- Version Metadata
- When to Use
- Audit Process
- Step 1: Inventory All Hidden Folders
- Step 2: Check Git Tracking Status
- Step 3: Analyze Content Overlap
- Step 4: Identify Authoritative Source
- Step 5: Plan Consolidation
- Common Hidden Folders Reference
- Related Directory Patterns
- specs/archive/
- benchmarks/
- Consolidation Commands
- Migrate .agent-os to .claude
List all hidden directories (excluding .git) find . -maxdepth 1 -type d -name ".*" ! -name ".git" | sort With sizes du -sh .*/ 2>/dev/null | grep -v "^0" | sort -hr Include symlinks find . -maxdepth 1 \( -type d -o -type l \) -name ".*" ! -name ".git" | sort Check if folder is tracked git ls-files --error-unmatch .folder/ 2>/dev/null && echo "TRACKED" || echo "NOT TRACKED" Check if folder is ignored git check-ignore -v .folder/ 2>/dev/null && echo "IGNORED" || echo "NOT IGNORED"
What does the hidden-folder-audit skill do?
Audit and consolidate hidden folders in a repository. Identifies duplicates, dead directories, and consolidation opportunities for .agent-os/, .ai/, .claude/, and other hidden folders.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill hidden-folder-audit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.