create-directory¶

Create one or more directories, including all required parent directories.

Category: Write-capable

Parameters¶

paths (required)

List of filesystem paths at which to create directories. Absolute paths are used as-is; relative paths are resolved against the current working directory. Parent directories are created automatically (equivalent to mkdir -p).

Behavior¶

Each path is attempted independently:

• If a directory already exists at a path, that path is treated as a success (idempotent).
• If a directory cannot be created (e.g. due to permissions), the failure is recorded and the tool continues with the remaining paths.
• All failures are reported in the output.

Output¶

A summary message: either a success count, or a success count with a list of paths that could not be created and the reason for each failure.