Agent Skills › strukto-ai/mirage › mirage-filesystem

mirage-filesystem

GitHub

指导在Mirage虚拟文件系统中操作文件和目录，包括发现、读取、编辑及执行命令。强调使用Mirage专用工具而非宿主机工具，确保正确处理挂载数据并处理配置错误。

plugins/mirage/skills/mirage-filesystem/SKILL.md strukto-ai/mirage

Trigger Scenarios

任务涉及Mirage虚拟路径需要检查或修改Mirage挂载的数据提及Mirage工具或云/数据库挂载数据

Install

npx skills add strukto-ai/mirage --skill mirage-filesystem -g -y

More Options

Non-standard path

npx skills add https://github.com/strukto-ai/mirage/tree/main/plugins/mirage/skills/mirage-filesystem -g -y

Use without installing

npx skills use strukto-ai/mirage@mirage-filesystem

指定 Agent (Claude Code)

npx skills add strukto-ai/mirage --skill mirage-filesystem -a claude-code -g -y

安装 repo 全部 skill

npx skills add strukto-ai/mirage --all -g -y

预览 repo 内 skill

npx skills add strukto-ai/mirage --list

SKILL.md

Frontmatter

{
    "name": "mirage-filesystem",
    "description": "Work with files and directories mounted in a Mirage virtual filesystem. Use when a task mentions Mirage, mounted cloud or database data, Mirage virtual paths, or asks to inspect, search, create, or edit data exposed through the Mirage tools."
}

Mirage Filesystem

Use the Mirage tools for virtual paths. Host filesystem tools cannot access those paths unless the user separately configured a FUSE mount.

Workflow

Use the Mirage ls, grep, or execute_command tool to discover mounted data.
Use the Mirage read tool before modifying an existing file.
Use edit for an existing file and write only for a new file.
If an edit reports that the file changed since it was read, read the file again, reconsider the edit against the new content, and retry.
Use execute_command for pipelines and structured-file commands that need Mirage shell semantics.

Do not fall back to a host filesystem tool when a Mirage tool fails on a virtual path. Report the Mirage error or fix the Mirage configuration.

Version History

4260904 Current 2026-07-24 16:26

Metadata

Files: 0
Version: 0645461
Hash: cd4084e2
Indexed: 2026-07-24 16:26

mirage-filesystem