directory-structure

Generate a Markdown ASCII directory tree with depth limits and ignore rules.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/mdnaimul22/human-skills --skill directory-structure-mdnaimul22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: directory-structure
Source: https://github.com/mdnaimul22/human-skills/tree/main/skills/directory-structure
Command: npx skills add https://github.com/mdnaimul22/human-skills --skill directory-structure-mdnaimul22

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

directory-structure helps you quickly understand a project's layout by generating a clean, professional Markdown representation of folders and files.

Core Features & Use Cases

  • Directory tree generation: Produces an ASCII tree in Markdown to visualize the structure of a target directory.
  • Depth control & layout options: Supports vertical (classic top-down) and horizontal (side-by-side top-level dirs) layouts with configurable recursion depth.
  • Smarter output with exclusions: Applies built-in ignore patterns, optional .gitignore parsing, and user-provided ignored paths/extensions to keep results readable.
  • Use case: Before modifying a large repo, generate a structure map for the relevant module to identify key files and relationships without manually browsing.

Quick Start

Run the directory-structure skill to generate a Markdown tree for your project directory while excluding common clutter like node_modules and build artifacts by setting an appropriate ignored_path.

Frequently Asked Questions about directory-structure

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

FAQPage Schema
How do I generate a Markdown directory tree for my project documentation?

To generate a Markdown directory tree, provide your project's filesystem path and the tool outputs a structured ASCII tree file. It automatically applies built-in ignore patterns to exclude common clutter like node_modules, making the result suitable for documentation or sharing.

Can I create an ASCII tree map of a large monorepo without including build artifacts?

Yes, you can map a large monorepo while excluding build artifacts by applying optional .gitignore parsing and user-provided ignored paths. This keeps the generated directory tree readable by filtering out generated files and unnecessary folders.

What is the best way to visualize codebase organization before modifying a repository?

The best way to visualize codebase organization before modifying a repository is to generate a structured directory tree map. This helps you identify key files and relationships without manually browsing, aiding in pre-change planning and code reviews.

Does the directory tree generator support depth limits for visualizing project structure?

Yes, the directory tree generator supports configurable recursion depth limits. You can set depth limits to control how far down the filesystem the tree traverses, ensuring the project structure output remains concise and readable for large codebases.

How do I exclude specific file extensions when generating a codebase directory tree?

You can exclude specific file extensions when generating a directory tree by providing user-provided ignored paths and extensions. This exclusion feature works alongside built-in ignore rules to ensure your codebase documentation only includes relevant files.