filesystem-skill

Manage workspace files across host and sandbox execution modes.

62|9|Updated Jul 27, 2025
One-click install
npx skills add https://github.com/cyzus/suzent --skill filesystem-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: filesystem-skill
Source: https://github.com/cyzus/suzent/tree/main/skills/filesystem
Command: npx skills add https://github.com/cyzus/suzent --skill filesystem-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a consistent, safe way for the agent to access, manage, and reference files across host and isolated sandbox workspaces so users can read, write, and search documents without confusion about paths or execution context.

Core Features & Use Cases

  • Dual Execution Modes: Clear guidelines for Host Mode (absolute host paths and environment-variable locations) and Sandbox Mode (virtual paths like /persistence, /shared, /mnt/skills).
  • File Operations & Tools: Guidance for using ReadFileTool, WriteFileTool, BashTool, GlobTool, and GrepTool to read, write, search, and list files.
  • Path Formatting & Links: Standardized clickable file link formatting for user-facing responses (file:///full/path/to/file).
  • Use Case: Inspect a user's workspace to locate project files, open a README, or save generated outputs into the session persistence folder with clear, accessible links.

Quick Start

List the files in the persistence workspace and provide clickable file links for each item.

Frequently Asked Questions about filesystem-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write workspace files in sandbox mode?

To access workspace files in host mode, use absolute paths or environment-variable locations. BashTool, GlobTool, and GrepTool interact with these host paths to read, write, and search files across your local environment.

What is the best way to format file links for users in a workspace?

To search for files across workspaces, use GlobTool to list and locate files by pattern, and GrepTool to search file contents. Both tools support host and sandbox execution modes for comprehensive file-search operations.

Does this file management approach work with both host and sandbox execution?

Environment-variable path resolution allows you to reference dynamic file locations in host mode. WriteFileTool and BashTool interpret these environment variables to access and manage files without hardcoding absolute paths in your workspace.

Why use virtual paths for file management in a sandbox workspace?

To save generated outputs into the session persistence folder, use WriteFileTool with the /persistence virtual path in sandbox mode, or an environment-variable location in host mode. Return a clickable file:/// link so users can access the output.