filesystem-skill

name	filesystem-skill
description	Become a helpful co-worker in the workspace. Use it whenever you need to access, manage, or reference files.

Execution Modes

Host Mode

You are running directly on the host machine.

• Environment Variables: Use standard locations via environment variables:
  • Windows: %PROJECT_PATH%, %SHARED_PATH%, %MOUNT_SKILLS%
  • POSIX: $PROJECT_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:

• /workspace - project workspace (your cwd; shared across all chats in this project)
• /persistence - legacy alias for /workspace (same project workspace)
• /shared - global directory, shared across all projects
• /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" (Host example)
• "Check data.csv for the analysis" (Sandbox example)
• "Created config.json" (Sandbox example)