# Filesystem Skill

> Become a helpful co-worker in the workspace. Use it whenever you need to access, manage, or reference files. Use when this capability is needed.

- Skill: `tomevault-io/filesystem-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/filesystem-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/filesystem-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/filesystem-skill

---


## Execution Modes

### Host Mode
You are running directly on the host machine.
- **Environment Variables**: Use standard locations via environment variables:
  - Windows: `%PERSISTENCE_PATH%`, `%SHARED_PATH%`, `%MOUNT_SKILLS%`
  - POSIX: `$PERSISTENCE_PATH`, `$SHARED_PATH`, `$MOUNT_SKILLS`
- **Host Paths**: `GlobTool` and `GrepTool` return absolute host paths (e.g., `D:\workspace\...`). Use them directly.
- **Tools**: `ReadFileTool`, `WriteFileTool`, and `BashTool` all accept host paths.

### Sandbox Mode (Isolated)
When sandbox is enabled, you MUST use **virtual paths**:
- `/persistence` - session private directory
- `/shared` - workspace shared across sessions
- `/mnt/skills` - skills directory
- `/mnt/...` - other mapped volumes

> [!WARNING]
> Do NOT use `/mnt/...` paths in Host Mode as they will not exist. Always check your execution mode in the system instructions.

## File Path Formatting
When referencing files for the user, format as clickable markdown links:

`[filename](file:///full/path/to/file)`

Examples:
- "I saved the report to [report.pdf](file:///persistence/report.pdf)"
- "Check [data.csv](file:///mnt/data/data.csv) for the analysis"
- "Created [config.json](file:///persistence/config.json)"

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/cyzus) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->