list-files

name	list-files
description	List files and subdirectories in a specified directory path. This skill should be used when the user wants to explore directory contents or find files in a folder.

List Files

List all files and subdirectories in a given directory path.

Usage

python scripts/list_files.py <directory_path>

Parameters

Parameter	Type	Required	Description
directory_path	string	Yes	Absolute or relative path to a directory

Behavior

• Returns a list of files and directories, one per line
• Prefixes directories with [DIR] and files with [FILE]
• Returns an error if the path does not exist or is not a directory
• Sorted alphabetically for consistent output