From ba996913aaeec3661348f8a255c03468ee40340f Mon Sep 17 00:00:00 2001
From: Cheney Zhang <chen.zhang@zilliz.com>
Date: Wed, 6 May 2026 03:55:54 +0000
Subject: [PATCH] Add MFS skill install check

Signed-off-by: Cheney Zhang <chen.zhang@zilliz.com>
---
 skills/mfs/SKILL.md                        | 16 ++++++++++++++--
 skills/mfs/references/command-reference.md | 19 +++++++++++++++++++
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/skills/mfs/SKILL.md b/skills/mfs/SKILL.md
index dfe6914..a8512ff 100644
--- a/skills/mfs/SKILL.md
+++ b/skills/mfs/SKILL.md
@@ -32,12 +32,24 @@ snippet without context.
 
 ## First Checks
 
-Before relying on MFS, check that the command exists:
+Before relying on MFS, check that the command exists and is the expected CLI:
 
 ```bash
-mfs --help
+mfs --version
 ```
 
+If `mfs` is not found, the PyPI package name is `mfs-cli` and the installed
+command is `mfs`:
+
+```bash
+uv tool install mfs-cli
+```
+
+After installing, run `mfs --version` again. If installing tools is outside the
+current task or requires user approval, report that MFS is not available and
+continue with native shell tools such as `grep`, `find`, `rg` when available,
+and normal file reads.
+
 If the target folder may not be indexed, inspect status or ask before running a
 large indexing job:
 
diff --git a/skills/mfs/references/command-reference.md b/skills/mfs/references/command-reference.md
index 6eae7d0..b5e4adf 100644
--- a/skills/mfs/references/command-reference.md
+++ b/skills/mfs/references/command-reference.md
@@ -4,6 +4,25 @@ This reference focuses on command usage for agents. Prefer scoped commands over
 global commands when the task gives a path. Use `--json` when another tool will
 parse the output.
 
+## Availability Check
+
+Before using MFS, verify that the command is installed:
+
+```bash
+mfs --version
+```
+
+If the command is missing, install the published CLI package when setup is part
+of the task:
+
+```bash
+uv tool install mfs-cli
+```
+
+The PyPI package name is `mfs-cli`; the installed command is `mfs`. If
+installation is not appropriate, fall back to native shell tools and normal file
+reads.
+
 ## Command Map
 
 | Need | Command |