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, glob, grep, or shell 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 shell for pipelines and structured-file commands that need Mirage shell semantics.