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

mirage-filesystem

GitHub

提供Mirage虚拟文件系统的操作指南，指导Agent使用专用工具进行文件发现、读取和编辑。强调在虚拟路径下禁止回退到主机文件系统，需处理版本冲突并报告错误。

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

Trigger Scenarios

任务涉及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: d4d1e9e
Hash: cd4084e2
Indexed: 2026-07-24 16:26

mirage-filesystem