fs-list

List files and directories within a filesystem sandbox path using Python's pathlib.

10|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill fs-list
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fs-list
Source: https://github.com/bdambrosio/Cognitive_workbench/tree/main/src/world-tools/fs/fs-list
Command: npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill fs-list

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly discover and organize files and directories within your project's filesystem sandbox, making it easier to locate and manage your project's assets.

Core Features & Use Cases

  • Filesystem Navigation: Browse directories and list their contents.
  • Selective Listing: Filter results to include or exclude files and directories, and control recursion depth.
  • Structured Output: Returns results as a Collection of Notes (for files) and Collections (for subdirectories), with metadata.
  • Use Case: When working on a new feature, you can use this Skill to get an overview of the relevant code directories and identify configuration files.

Quick Start

List all files and directories in the current directory recursively.

Frequently Asked Questions about fs-list

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

FAQPage Schema
How do I list files and directories in a project sandbox?

To list files and directories, specify a target path and the tool traverses the filesystem sandbox using Python's pathlib. It returns structured collections of files and subdirectories with associated metadata for easy navigation.

Can I filter directory listings to show only files or only subdirectories?

Yes, you can filter directory listings by file or directory type. The tool supports selective listing, allowing you to include or exclude specific entry types and control recursion depth when browsing the sandbox.

What is the best way to recursively browse a filesystem sandbox?

The best way to recursively browse a filesystem sandbox is to use the recursive listing feature. It utilizes Python's pathlib for path resolution and directory traversal, returning structured output for all nested files and subdirectories.

How do I limit the number of entries returned when listing files?

You can limit the number of entries returned by specifying a limit parameter when listing files. This constrains the directory traversal output, making it easier to manage large filesystems by returning a controlled subset of results.

Does filesystem navigation work without external dependencies?

Yes, filesystem navigation works without external dependencies. The tool relies solely on Python's built-in pathlib module for path resolution and directory traversal within the sandbox, requiring no additional setup.

Why use structured output for listing directory contents?

Structured output is used for listing directory contents to organize results into Collections of Notes for files and Collections for subdirectories. This format includes metadata, making it easier to locate and manage project assets programmatically.