One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill analyze-dir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-dir
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/analyze-dir
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill analyze-dir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of not knowing what a directory is for and how its files relate, especially when you inherit an unfamiliar project or need quick situational awareness.

Core Features & Use Cases

  • Directory structure analysis: Scans the current folder to summarize size, file types, and folder patterns.
  • Purpose and role inference: Reads and interprets key files to explain what each component does.
  • Relationship mapping: Identifies reference/dependency links (e.g., imports, includes, and cross-file usage) to clarify how the codebase flows.

Quick Start

Run analyze-dir on the directory you are investigating and, if you want the result saved, include the --save argument.

Frequently Asked Questions about analyze-dir

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

FAQPage Schema
How do I understand an unfamiliar codebase and map its project structure?

Directory analysis scans the target folder to infer its purpose, summarize file types, and map dependency relationships for fast codebase understanding. It reads key files to explain component roles and cross-file imports.

What is the best way to analyze a directory for repository onboarding?

Directory analysis for repository onboarding scans the folder structure and interprets key files to explain what each component does. It identifies reference links and cross-file usage to clarify how the codebase flows.

How do I generate documentation for a project structure and its dependencies?

Documentation generation for a project structure is done by running the directory analysis with the --save argument. This executes structure scanning and content analysis, saving a high-level map of files and dependencies as an ANALYSIS.md report.

Can I map dependency relationships and imports across files in a directory?

Yes, mapping dependency relationships is a core feature of directory analysis. It identifies reference links such as imports, includes, and cross-file usage to clarify how the codebase flows and connects.

Does directory analysis work for understanding repository submodules?

Yes, directory analysis applies to understanding repository submodules. It scans the target directory to determine its functional structure and produces a high-level map of files and dependencies for engineering work.

What are the limitations of agent-assisted directory inspection for codebase understanding?

Agent-assisted directory inspection provides a high-level map of files and dependencies rather than detailed runtime behavior. It focuses on static structure scanning and content analysis to infer purpose and relationship mapping.