Folders

What This Skill Does

The Folders skill acts as an intelligent file and directory manager for the OpenClaw AI agent. By maintaining a localized index at ~/.config/folder-index.json, the agent avoids expensive recursive scans, allowing for near-instant access to your most frequently used project directories. It uses smart heuristics to identify project roots by searching for key markers like .git, package.json, or pyproject.toml, while intentionally ignoring bloated subdirectories like node_modules or target to keep your workspace clean and efficient.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/ivangdavila/folders

Use Cases

• Project Management: Quickly switch between multiple active development projects without needing to memorize deep directory paths.
• Workspace Cleanup: Safely prune build artifacts, cache folders, and temporary files by leveraging the skill's built-in awareness of non-essential directory structures.
• System Navigation: Easily locate hidden or forgotten project roots within large development trees through targeted discovery scans.
• Security-First File Handling: Perform sensitive file operations with a safety layer that validates paths, resolves symlinks, and prevents modifications to critical system directories.

Example Prompts

1. "Where is my 'Auth-Module' project located?"
2. "I'm low on disk space; scan my ~/code folder and propose build artifacts I can safely remove."
3. "Search my Documents folder for any unindexed Node.js projects and suggest adding them to my index."

Tips & Limitations

• Safety: The skill uses a protective blacklist to prevent accidental operations on system paths like /etc or C:\Windows.
• Performance: Always prefer using the index. If you perform a deep discovery, do it during idle times as scanning large disks may impact system responsiveness.
• Recovery: When deleting, the skill prefers sending files to the OS trash bin, allowing for recovery. If you are cleaning large artifacts, consider if they are reproducible (e.g., node_modules) before deletion.
• Platform Specifics: The skill handles path normalization across OS platforms, but always verify paths on network-attached storage, as the agent will prompt for confirmation before starting heavy I/O operations.