用途：Skills CLI 用于在 Codex、Claude Code、Pi 等环境中发现、安装和管理智能体技能包，并可恢复锁文件、同步包内提供的技能。
主要能力与用法：先用 bunx skills list 查看项目作用域状态，用 bunx skills list -g 查看全局作用域；用 bunx skills find <query> 或 bunx skills add <source> --list 发现可用选项。安装时需明确作用域、所选技能与目标智能体。可用 --copy 切换复制模式，默认使用符号链接模式；--skill '' 表示来源中的全部技能，--all 展开为 --skill '' --agent '*' -y，可能意外重建共享的 ~/.agents/skills 安装。
本仓库约定：以 skill-registry.json 为权威分类，sjskills plan 表示已提交的项目意图，sjskills plan --global 表示固定的全局基线状态。该仓库优先使用 sjskills，其适配器显式面向 Codex 与 Claude Code，负责放置、状态、隔离与恢复。仅字节相同并不授予协调器所有权，托管更新与删除仅在当前内容与受信状态一致时进行。
限制与注意：不要为固定全局基线合成 Pi 目标，Pi 会读取共享根的副本；重新安装已发布技能前需先发布本地变更；带筛选的列出、移除、通用更新、锁文件恢复与同步前需参考对应文档；全局 apply 与恢复需经审查的滚动方案和显式授权，并需 --approved-plan 与 --approved-plan-sha256；已安装技能应视为可执行指令，避免不可信来源；用 chezmoi 管理 dotfiles 时避免对活动技能目录执行 chezmoi add。具体输入与安装位置以资料中的 references/cli.md、recipes 文档为准，未提供的细节暂不可考。