Skip to content
cccskills
FreePublished on GitHub

mirage-filesystem

Inspect, search, create, and edit data exposed as files through Mirage. Guides agents through the appropriate tools, reading before editing, and retrying changes when a file has been updated since it was read.

OriginalShow the original 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.

See how to install

Good for

  • Find files in mounted cloud or database data
  • Read and edit an existing virtual file
  • Create a new file through Mirage
  • Run pipelines in the Mirage shell

Files included (2)

  • SKILL.md1.0 KB
  • agents/openai.yaml184 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  1. Use the Mirage ls, glob, grep, or shell tool to discover mounted data.
  2. Use the Mirage read tool before modifying an existing file.
  3. Use edit for an existing file and write only for a new file.
  4. 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.
  5. Use shell 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Build an adapter that exposes API, database, or object storage data as files in Mirage. Covers Python or TypeScript implementation, mount configuration, and tests for reading, access restrictions, and supported changes.

  • Connect an API or database to Mirage
  • Implement file operations for a custom data source
  • Package a reusable Mirage adapter
strukto-ai/mirage3.7KUpdated Oct 22, 2026

See all skills by strukto-ai

Report a problem with this skill