用途：skill-map 用于在本机范围内定位技能（skill）的安装位置与交叉引用，支持发现重复安装、交叉依赖、外部引用和未解析引用。它只负责定位与交叉引用，不负责校验技能，校验可交给 skill-doctor，冲突与整合评估可交给 skill-harmonization。
主要能力：支持 --root（可重复，默认 ~）和 --portfolio-root（解析到 Git 根，并扫描该仓库及 ~/.agents/skills、~/.claude/skills，与 --root 互斥）；--skill 限定单个技能名（可重复）；--format text|json|dot 选择报告格式；--include-catalog-sources、--include-self、--include-snippets、--show-skipped 控制扫描与输出细节。JSON 和 DOT 输出保持字节有效、不加装饰。每条边包含类型、来源（declared 或 inferred）、标识符、source、target、path、line。技能记录包含 skill_sha256 与 tree_sha256。portfolio JSON 额外包含仓库根、用户根存在性、暴露路径、目录名、安装/目录类型、适用客户端、符号链接信息等。
使用方式：需 PATH 中存在 ai-skillet 1.0.0 或更新版本，然后运行 ai-skillet map，并把每个解析出的选项及其值作为独立参数追加。被其他命令或智能体消费时用 --format json；比较仓库技能与用户安装的 Codex/Claude 暴露时用 --portfolio-root <repo> --format json，不要额外加更宽的家目录根。需要图形或 Graphviz 输入时用 --format dot。仅在解释、审计或修改忽略策略时阅读 references/ignore-policy.md。
适用场景：审计本地技能安装分布、查找重复与依赖关系、生成依赖图、对比仓库组合与用户安装暴露。
限制：不校验技能；默认广泛扫描会排除标准智能体家目录与目录源检出；不会扫描 macOS 受保护路径（如 ~/Library、~/.Trash）；无效声明字段会导致带路径的错误并停止；--skill 过滤无匹配时写入 stderr 警告并返回空报告。缺失事实：具体支持的平台与版本细节资料未提供。