List Files

Displays file/directory listings and details for Python-based workflows.

Updated Jul 4, 2025
One-click install
npx skills add https://github.com/avb7/Codeine --skill list-files
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: List Files
Source: https://github.com/avb7/Codeine/tree/main/skills/learn-skill/skills/list-files
Command: npx skills add https://github.com/avb7/Codeine --skill list-files

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve?

Manually navigating directories and listing files can be cumbersome, especially when needing specific details or working within an AI environment. This Skill provides a structured and programmatic way to inspect file systems, saving you time and reducing manual effort.

Core Features & Use Cases

  • Directory Listing: Effortlessly lists all files and subdirectories in a specified path, defaulting to the current directory.
  • Detailed Information: Offers an optional flag to display comprehensive details, including file sizes and clear indicators for files (πŸ“„) and directories (πŸ“).
  • Use Case: When an AI needs to understand the contents of a directory before performing an operation (e.g., "What files are in /data?", "Show me the size of report.pdf"), this Skill offers a clear, programmatic interface for file system introspection.

Quick Start

List files in current directory

python3 list-files.py

List files with detailed information

python3 list-files.py --details

Frequently Asked Questions about List Files

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

FAQPage Schema
How do I list files in a directory with their sizes?β–Ό

List files in a directory by running `python3 list-files.py --details` to display comprehensive metadata including file sizes and type indicators (πŸ“„ for files, πŸ“ for directories), enabling quick inspection of directory contents.

Can I use this to inspect a specific directory path?β–Ό

Yes, file listing supports the `--path` option to specify any local filesystem directory. Run `python3 list-files.py --path /your/directory` to list contents of that location, with graceful handling of missing paths and permission errors.

What's the best way to programmatically inspect file systems in shell scripts?β–Ό

Use structured file listing within shell scripts to programmatically reveal directory contents before performing operations. This Skill provides a clear interface for file system introspection, reducing manual navigation and enabling automated workflows.

How do I get file system information for debugging and logging?β–Ό

File listing generates structured output of directory contents with optional detailed metadata, making it ideal for debugging contexts and logging file system state without manual directory traversal.

Does this work with missing or inaccessible directories?β–Ό

The Skill gracefully handles missing paths and permission errors, returning appropriate feedback instead of failing, so you can safely inspect any local filesystem location without crashes.