用途：为人类读者（新加入仓库的人、维护者）打印本仓库已安装技能的索引，按每个技能声明的 family 分组，列出调用名和描述首句。该技能纯信息性，不参与代理路由。
主要能力：每次运行都从实时 SKILL.md frontmatter 生成索引，没有需要同步的缓存副本；覆盖三种安装形态并标注每条来源：固定快照（.agents/skills/ 及其旁路，调用名 /magpie-<skill>）、框架检出（仓库自身 skills/，调用名 /magpie-<skill>）、市场插件（脚本所在插件缓存及同级插件，调用名 /<plugin>:<skill>）。按“实际输入的名字”去重，family 取自 frontmatter 声明而非名称前缀，未声明 family 的归入 other。
使用方式：先静默执行预检命令 PYTHONPATH=.apache-magpie-local python3 -m setup_preflight --skill <name> --hash <surface_hash> [--requires <file>]...，verdict 为 ok 则静默继续；为 action 时按 rules 处理；命令完全无法运行不得视为通过。随后运行捆绑脚本并原样呈现输出：python3 .claude/skills/magpie-list-skills/scripts/list_skills.py；可加 --verbose 让每条描述独占缩进行，或加 --root /path/to/repo 检查其他仓库。市场安装例外，需用该技能报告的 base directory 构造命令：python3 <base directory>/scripts/list_skills.py。
适用场景：新人了解仓库有哪些技能、维护者核对可用技能清单。
限制：只读，绝不编辑、创建或删除文件，仅读取上述安装目录下的 SKILL.md；输出必须逐字呈现，不得改写、概括或重排；需要 Python 3.11+，脚本仅用标准库；不得无人值守运行 /magpie-setup adopt。其余细节暂未提供。