← 返回 Skills 市场
1076
总下载
2
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install folders
功能描述
Index important directories and perform safe folder operations with proper security checks.
使用说明 (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.
安全使用建议
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).
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install folders - 安装完成后，直接呼叫该 Skill 的名称或使用
/folders触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release
元数据
常见问题
Folders 是什么？
Index important directories and perform safe folder operations with proper security checks. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1076 次。
如何安装 Folders？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install folders」即可一键安装，无需额外配置。
Folders 是免费的吗？
是的，Folders 完全免费（开源免费），可自由下载、安装和使用。
Folders 支持哪些平台？
Folders 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（linux, darwin, win32）。
谁开发了 Folders？
由 Iván（@ivangdavila）开发并维护，当前版本 v1.0.0。
推荐 Skills