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

mirage-filesystem

GitHub

提供在Mirage虚拟文件系统中操作文件的规范，指导使用专用工具进行数据发现、读取、编辑和命令执行，禁止回退到宿主机文件系统。

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

触发场景

需要访问Mirage挂载的虚拟路径或云数据库数据任务涉及Mirage虚拟路径下的文件检查、搜索、创建或编辑

安装

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

更多选项

非标准路径

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

不安装直接使用

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.