A specialized tool for maintaining a lightweight directory index and performing secure, platform-aware folder operations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install folders
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install folders using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Folders?
The Folders skill is designed to streamline how AI agents interact with your local file system by creating a structured index of important directories. Instead of performing slow, exhaustive scans every time you need to find a file, this skill utilizes a lightweight configuration file to remember project locations, types, and notes. It is a core component of the Openclaw Skills library that prioritizes both speed and safety during directory traversal.
Beyond simple indexing, the skill incorporates robust security checks to prevent accidental modification of system paths and provides platform-specific optimizations for macOS and Windows. By using this skill, developers can ensure their AI assistants have immediate context of their workspace while maintaining strict boundaries around sensitive operating system areas.
Folders Use Cases
- Rapidly locating specific projects or repositories across multiple dev folders.
- Safely cleaning up build artifacts like node_modules or pycache to save space.
- Indexing new workspaces to provide instant context to an AI coding agent.
- Managing complex directory structures across different operating systems without path errors.
How Folders Works
- The skill checks for an existing index at ~/.config/folder-index.json to resolve known paths immediately.
- For new directories, it performs targeted discovery by scanning common developer locations like ~/code or ~/projects.
- It identifies project roots by detecting specific markers such as .git, package.json, or Cargo.toml.
- Before any operation, it canonicalizes paths and runs security checks to reject system-protected directories.
- It executes operations using platform-specific logic, such as using the OS trash for deletions and handling Windows long-path prefixes.
Folders Setup
To get started with this skill within the Openclaw Skills ecosystem, ensure your agent has permissions to read and write to your user configuration directory.
# The skill automatically creates the index, but you can manually verify the path:
ls ~/.config/folder-index.json
Folders Data Schema & Taxonomy
The skill organizes directory metadata using a simple JSON schema located in the user's config folder.
| Property | Type | Description |
|---|---|---|
| folders | Array | A list of indexed folder objects. |
| path | String | The absolute, canonicalized path to the directory. |
| type | String | The detected or assigned category (e.g., project). |
| note | String | Optional metadata or descriptions for the directory. |
Folders Advanced Features
- Automatic detection of project markers for various languages including Rust, Go, and Python.
- Smart recursion limits that stop at the first project marker to avoid bloating the index.
- Recovery-aware destructive operations that distinguish between permanent data and rebuildable artifacts.
- Specialized handling for macOS .app bundles and Windows network drives to ensure stability.
SKILL.md
Loading
Related Openclaw Skills
Florida
A specialized AI agent skill designed to provide resident-first guidance for navigating Florida's unique insurance, weather, and legal landscapes.
Flask
A specialized Openclaw Skills toolkit for building secure, scalable Flask applications by mastering context management and production-ready configurations.
Flashcards
A specialized skill for generating high-retention flashcards based on spaced repetition and memory science principles.
Fiverr Freelancing Accelerator
A strategic framework for building and scaling a high-performance Fiverr freelancing business using AI-assisted workflows.
Follow Content & Topic Monitor
A sophisticated content monitoring agent that tracks people, topics, and feeds with automated filtering and tiered alerts.
Font Awesome
A comprehensive utility for integrating, styling, and managing Font Awesome icons across various web frameworks and installation methods.
Featured*
