khazix-skills 怎么安装？Claude Code/Codex 技能包使用教程

最常见的安装失败不是 GitHub 打不开，而是把整个仓库复制到一个旧目录，重开 Claude Code 或 Codex 后仍找不到任何 Skill。khazix-skills 的每个子目录都是独立技能包，安装前先决定“装哪一个、给谁用、在哪些项目生效”，路径才不会越修越乱。

先选作用范围，再发安装请求

仓库给出的最短路径，是把下面这句话交给支持 Skills 的 Agent：

帮我安装这个 skill：https://github.com/KKKKhazix/khazix-skills/tree/main/<skill-name>

把占位符换成真实目录名，例如 neat-freak、hv-analysis 或 aihot。不要只贴仓库根地址后说“全装”，否则 Agent 可能复制多余文件，也可能无法判断各平台的个人级目录。

一次安装应当走完四个动作

1. 审阅。先读取目标目录的 SKILL.md，再检查有没有脚本、依赖和写文件动作。若 Agent 直接执行未知脚本，没有给出目标位置，先停下。
2. 定位。确认当前平台与作用范围。Claude Code 个人级和项目级目录不同，Codex 也有自己的发现规则。
3. 复制。只把目标 Skill 的完整目录写入对应位置，保留它的 references、scripts 和 assets。只复制一份 SKILL.md，会让带转换脚本的技能变成半成品。
4. 重载。安装完成后开启新会话或让客户端重新发现 Skills。目录存在但列表里没有，多数是会话尚未刷新。

Claude Code 与 Codex 不要照抄同一条路径

Claude Code 当前文档把个人 Skill 放在 ~/.claude/skills/<name>/SKILL.md，项目 Skill 放在 .claude/skills/<name>/SKILL.md。新建一个此前不存在的顶层目录后，通常需要重启 Claude Code，已有目录里的文件变化则能在会话中被监测。

khazix-skills 的路径速查仍把 Codex 全局目录写为 ~/.codex/skills。当前 Codex 文档已列出个人级 $HOME/.agents/skills、仓库级 $REPO_ROOT/.agents/skills，并建议用 $skill-installer 从外部仓库下载 Skill。两套说明发生冲突时，优先让当前 Codex 的安装器决定位置，不要为了迁就旧速查表再建一层目录。

在 Codex 里这样下达会更稳

$skill-installer
请从这个目录安装单个 Skill：
https://github.com/KKKKhazix/khazix-skills/tree/main/neat-freak
先告诉我将写入哪个范围，不要覆盖同名 Skill。

如果只想让团队在当前仓库使用，则明确要求安装到仓库级发现路径；如果想跨项目使用，再选个人级。安装器报告存在同名 Skill 时，不要直接覆盖，先比较版本和内容。两个同名包同时被发现，选择器里可能都会出现，执行时更难确认读到哪一份。

安装后做两个验证

1. 让 Agent 列出当前可用 Skills，确认目标名称和文件路径。
2. 发一个最小任务。neat-freak 可用“检查当前项目文档是否需要同步”；aihot 可问“过去 24 小时 AI 圈的五条重点”；hv-analysis 先用一个明确研究对象试跑准备阶段。

列表没有名称，先检查目录层级和会话刷新；名称存在却不执行，检查 description 是否匹配任务；执行一半缺脚本，回头补齐整个子目录。做到这三层排查，比反复重装整个仓库更快。