# List Directory

> Get a detailed listing of all files and directories in a specified path. Results clearly distinguish between files and directories with [FILE] and [DIR] prefixes. This tool is essential for understanding directory structure and finding specific files within a directory. Only works within allowed directories.

- Skill: `xiaobai1017/list-directory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xiaobai1017/list-directory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaobai1017/list-directory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiaobai1017 (https://skillmd.com/u/xiaobai1017)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xiaobai1017/list-directory

---


# List Directory

Get a detailed listing of all files and directories in a specified path. Results clearly distinguish between files and directories with [FILE] and [DIR] prefixes. This tool is essential for understanding directory structure and finding specific files within a directory. Only works within allowed directories.

## Purpose

This skill provides access to the MCP tool `list_directory`. It allows you to get a detailed listing of all files and directories in a specified path. results clearly distinguish between files and directories with [file] and [dir] prefixes. this tool is essential for understanding directory structure and finding specific files within a directory. only works within allowed directories..

## Parameters

The tool accepts the following parameters:

### `path`
**Required**
- **Type**: `string`
- **Description**: No description provided


## Usage Instructions

To use this tool:

1. **Prepare the parameters** according to the schema above
2. **Invoke the MCP tool** `list_directory` with the prepared parameters
3. **Process the result** returned by the tool

## Example

```json
{
  "path": "example_value"
}
```

## Expected Output

The tool returns data with the following structure:

- **content** (`string`): No description provided


## Notes

- This skill requires an active MCP connection to the server providing the `list_directory` tool
- Ensure the MCP server is properly configured and running before attempting to use this tool
- Review the parameter requirements carefully to avoid errors