# Ls

> List files and directories in the workspace

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

---


# List Directory Skill

List files and directories in the workspace.

## When to Use

Use the ls skill for:

- **Exploring directories**: See what files exist in a folder
- **Understanding project structure**: Get an overview of files and folders
- **Checking for files**: Verify if a file or directory exists

## Input Format

```json
{
  "path": "src",
  "all": false,
  "long": true
}
```

### Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `path` | string | No | `.` | Directory to list (relative to workspace) |
| `all` | boolean | No | false | Include hidden files |
| `long` | boolean | No | false | Show size, type, and modification time |

## Output Format

```json
{
  "success": true,
  "output": "src/\npackage.json\ntsconfig.json",
  "exitCode": 0
}
```

## Limitations

- Maximum 500 entries returned
- Paths validated to stay within workspace boundaries