← Back to Skills Marketplace
Workspace Files
by
EcosincronIA
· GitHub ↗
· v1.0.1
· MIT-0
674
Downloads
0
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install workspace-files
Description
Work safely with files inside the OpenClaw workspace sandbox. Use for listing directories, reading text files, writing text files, and searching files by nam...
Usage Guidance
This skill appears to do exactly what it says: list, read, write, and search text files inside a sandbox. Before installing, confirm the hardcoded SANDBOX_ROOT (/home/cmart/.openclaw/workspace) is the intended workspace on your agent — if your agent uses a different home or user, the path may not exist or could point to another user's files. The script uses realpath to canonicalize and rejects paths that resolve outside the sandbox, which prevents typical path-traversal escapes; still, review whether you want an agent able to write files under that directory. No credentials or network access are requested.
Capability Analysis
Type: OpenClaw Skill
Name: workspace-files
Version: 1.0.1
The skill bundle provides standard file management operations (listing, reading, writing, and searching) restricted to a specific sandbox directory. The shell script `scripts/workspace-files.sh` implements path validation using `realpath` to prevent directory traversal attacks, and the instructions in `SKILL.md` are consistent with the stated purpose without any signs of prompt injection or malicious intent.
Capability Assessment
Purpose & Capability
Name/description promise file operations inside a workspace sandbox and the included script implements list, read, write, and search operations restricted to a single sandbox root. Required resources (none) match the described functionality.
Instruction Scope
SKILL.md instructs the agent to operate only on relative paths inside the workspace, and the script enforces that by resolving paths and rejecting anything that canonicalizes outside the SANDBOX_ROOT. The commands do not access environment variables, network endpoints, or other system paths.
Install Mechanism
No install spec; the skill is instruction-only with a bundled shell script. Nothing is downloaded or installed from external sources.
Credentials
The skill declares no environment variables, credentials, or config paths. It operates only on the hardcoded sandbox path and does not request secrets or unrelated access.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide configuration. It reads and writes only inside the declared sandbox path.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-files - After installation, invoke the skill by name or use
/workspace-files - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated _meta.json file.
- No changes to skill functionality or documentation.
v1.0.0
- Initial release of workspace-files skill.
- Enables safe file operations within the OpenClaw workspace sandbox.
- Supports listing directories, reading text files, writing text files, and searching files by name.
- Only operates inside /home/cmart/.openclaw/workspace; paths outside this directory are not permitted.
- Use only for text files and directory inspection, not binary files.
Metadata
Frequently Asked Questions
What is Workspace Files?
Work safely with files inside the OpenClaw workspace sandbox. Use for listing directories, reading text files, writing text files, and searching files by nam... It is an AI Agent Skill for Claude Code / OpenClaw, with 674 downloads so far.
How do I install Workspace Files?
Run "/install workspace-files" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Workspace Files free?
Yes, Workspace Files is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Workspace Files support?
Workspace Files is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Workspace Files?
It is built and maintained by EcosincronIA (@ecosincronia); the current version is v1.0.1.
More Skills