← Back to Skills Marketplace
1076
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install folders
Description
Index important directories and perform safe folder operations with proper security checks.
README (SKILL.md)
Folder Index
Maintain a lightweight index at ~/.config/folder-index.json to know where important things are without rescanning.
{
"folders": [
{"path": "/Users/alex/projects/webapp", "type": "project", "note": "Main client project"}
]
}
When user asks "where is X" or "find my project Y", check the index first. If not found, do targeted discovery then offer to add the result.
Discovery
When asked to find or index folders:
- Scan likely locations: ~/projects, ~/Documents, ~/code, ~/dev, ~/work
- Detect projects by markers: .git, package.json, pubspec.yaml, Cargo.toml, go.mod, pyproject.toml, *.sln
- Stop at first marker (don't recurse into node_modules, vendor, build)
- Propose what was found, don't auto-add: "Found 8 projects in ~/code. Add to index?"
Path Security
- Canonicalize paths (resolve
~,.., symlinks) before any operation - Reject system paths: /, /etc, /var, /usr, /System, /Library, C:\Windows, C:\Program Files
- Skip symlinks during traversal, report them separately
Destructive Operations
- Use OS trash instead of permanent delete
- State recoverability: "node_modules: recoverable with npm install"
- Build artifacts safe to delete: node_modules, pycache, .gradle, build/, target/, Pods/, .next/
Platform Quirks
- macOS: .DS_Store alone = effectively empty. Treat .app as single item.
- Windows: Paths >260 chars need
\\?\prefix. - Network drives: Warn before bulk ops — may be slow or offline.
Usage Guidance
This skill is internally consistent for indexing projects and doing safe folder operations, but it will scan parts of your home directory and write a persistent file at ~/.config/folder-index.json. Before installing, decide whether you trust the agent to access those folders and create/update the index automatically. Ask the maintainer (or your agent policy) to: require explicit confirmation before any bulk or destructive actions, restrict autonomous invocation if you don't want background scans, and store the index with appropriate file permissions. If you want to be extra cautious, back up or inspect ~/.config/folder-index.json after first use and run the skill in a limited environment (or with reduced folder scope).
Capability Analysis
Type: OpenClaw Skill
Name: folders
Version: 1.0.0
This skill bundle is classified as benign. The `SKILL.md` instructions explicitly guide the AI agent to perform folder operations with strong security checks, including canonicalizing paths, rejecting operations on critical system directories (e.g., `/etc`, `C:\Windows`), and using the OS trash for deletions instead of permanent removal. There is no evidence of prompt injection with malicious intent, data exfiltration, unauthorized execution, or persistence mechanisms. The instructions prioritize user consent and safe file system interactions, aligning perfectly with the stated purpose of indexing and managing user-level folders.
Capability Assessment
Purpose & Capability
Name and description match the runtime instructions: maintaining a local index (~/.config/folder-index.json), scanning common development/document folders, detecting project markers, and performing safe deletion semantics. No unrelated binaries, env vars, or network endpoints are requested.
Instruction Scope
Instructions are focused and constrained (scan limited set of likely paths, stop at first marker, don't recurse into large dirs, propose additions). However, the skill instructs filesystem discovery and deletion operations (using OS trash) which are inherently invasive — the SKILL.md generally requires user prompts for adding items but is less explicit about explicit confirmation for destructive bulk operations. Also assumes ability to canonicalize and skip symlinks; implementations must be careful to honor these rules.
Install Mechanism
No install spec and no code files — lowest risk: nothing is written to disk by an installer and nothing is downloaded or executed beyond what the host agent already does.
Credentials
The skill requests no credentials or environment variables, which is appropriate. It does require read/write access to the user's home config (~/.config/folder-index.json) and will traverse user directories (~/projects, ~/Documents, etc.). This is proportional to its purpose but is sensitive: the index and any scan results are local data that should be protected.
Persistence & Privilege
always:false and no system-wide config changes are requested, which is appropriate. The skill does write a persistent index file in the user's config directory — benign for this purpose — but if the agent is allowed to invoke skills autonomously, it could perform scans and update the index without frequent explicit user prompts. Consider controlling autonomous invocation or requiring explicit consent for bulk operations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install folders - After installation, invoke the skill by name or use
/folders - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Folders?
Index important directories and perform safe folder operations with proper security checks. It is an AI Agent Skill for Claude Code / OpenClaw, with 1076 downloads so far.
How do I install Folders?
Run "/install folders" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Folders free?
Yes, Folders is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Folders support?
Folders is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).
Who created Folders?
It is built and maintained by Iván (@ivangdavila); the current version is v1.0.0.
More Skills