workspace-tools
Utilities for inspecting the local project workspace (list files, spot large folders, and determine where to focus).
When & Why to Use This Skill
The workspace-tools skill provides essential utilities for inspecting and mapping local project environments. It enables Claude agents to programmatically visualize directory structures, identify key files, and determine project focus areas. By generating depth-limited directory trees in JSON format, it helps maintain a clean context window while providing a comprehensive overview of the codebase architecture.
Use Cases
- Codebase Onboarding: Quickly mapping the file structure of a new or complex repository to understand the project layout and component relationships.
- Context Management: Helping AI agents identify relevant files and directories to focus on for specific tasks without exceeding token limits.
- Workspace Auditing: Spotting large folders or unnecessary files to optimize the project environment and improve development efficiency.
- Automated Documentation: Generating structured JSON representations of project hierarchies for use in technical documentation or system architecture reviews.
| name | workspace-tools |
|---|---|
| description | Utilities for inspecting the local project workspace (list files, spot large folders, and determine where to focus). |
| license | MIT |
Tools
list-directory
- Purpose: Print a depth-limited directory tree as JSON for the current working directory or a target path.
- Usage:
./scripts/list-directory/list-directory(defaults to current directory, depth 2)./scripts/list-directory/list-directory --path ./src --depth 3
- Flags:
--path <path>: Directory to scan (default:., relative paths are resolved from cwd)--depth <number>: How deep to recurse (default: 2)--json: Emit compact JSON instead of pretty output