SuperAPI AI 工具集

dym-humanizer-install-shell

通用与其它

查看项目

更新于 10-18 01:22

技能介绍

该技能页面说明如何用 shell 方式安装 Humanizer(同时也覆盖 Skills CLI 安装与手动复制)。Humanizer 本身只是一个 Markdown 提示词文件(SKILL.md),在放进 agent 的技能目录之前不会产生任何作用。这条安装路径面向所有支持 skill 的 agent,不限于 Claude Code。

【用途】 把 Humanizer 技能安装到项目级或用户级(全局)的技能目录,或手动只复制 SKILL.md 以保持项目干净。安装后会生成一个技能目录(例如 .claude/skills/humanizer/),按项目范围安装时还会在项目根目录生成 skills-lock.json,记录已安装版本的 source、sourceType 和 computedHash。

【前置要求】 需要 Node.js(用于运行 npx)。仓库没有构建步骤、没有 package.json、没有需要安装的依赖。除非你要修改这个技能本身,否则不需要 Python。

【使用方式】

  1. 为单个项目安装:在目标项目根目录(不是 humanizer 仓库内)运行: npx skills add blader/humanizer 已核实的 Claude Code 安装结果为:./.claude/skills/humanizer/ 与 ./skills-lock.json。

  2. 全局安装(所有项目): npx skills add blader/humanizer --global -g 是 --global 的简写;不加该标志则为项目级安装。

  3. 选择接收技能的 agent:

指定一个 agent

npx skills add blader/humanizer --agent claude-code

指定多个 agent

npx skills add blader/humanizer --agent claude-code cursor

所有 CLI 已知 agent

npx skills add blader/humanizer --agent '' --skill '' -y 使用 --agent '*' 时,CLI 会在 .agents/skills/humanizer/ 构建一份标准版本,再把各 agent 目录以符号链接指向该处。实际观察到的结构包括 .agents/skills/humanizer/(真实版本)以及 .claude/skills/humanizer -> ../../.agents/skills/humanizer 等链接。安装完成后需要重新加载 agent,技能才会出现。

  1. 查看与更新: npx skills ls(项目内技能) npx skills ls -g(全局技能) npx skills ls --json(机器可读、无颜色) npx skills update humanizer(更新到最新版)

  2. 卸载: npx skills remove humanizer --agent claude-code -y 已核实的陷阱:skills remove humanizer --agent '' -y 无法卸载,尽管 --help 写着 use '' for all agents;它会输出 ■ Invalid agents: * 并列出有效 agent,退出码为 0,文件仍然保留。卸载时必须逐个点名 agent。--agent '*' 只在 add 侧正常工作。

  3. 第二个陷阱:CLI 会复制整个仓库。 实际安装目录中不仅有 SKILL.md,还包括 README.md、AGENTS.md、LICENSE、agents/openai.yaml、scripts/validate-package.py、.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.github/workflows/validate.yml 等。若把技能目录提交进项目,会连带 CI 配置和工具脚本。想保持干净可手动只装一个文件: mkdir -p .claude/skills/humanizer curl -fsSL https://raw.githubusercontent.com/blader/humanizer/main/SKILL.md
    -o .claude/skills/humanizer/SKILL.md 这与 README 中“手动安装时把 SKILL.md 复制到 agent 的技能文件夹”的说明一致,也成立,因为 .claude-plugin/plugin.json 声明 "skills": ["./"],技能位于根目录,单个文件即可。

  4. Claude Desktop: 从 GitHub 下载仓库 ZIP 后作为技能上传。自 2.11.2 版本起可行,因为仓库已移除插件符号链接;此前 GitHub 源码 ZIP 包含符号链接,导致 Claude Desktop 加载失败(见 2.11.1 与 2.11.2 发布说明)。

【选择建议】 个人使用、所有项目:npx skills add blader/humanizer --global 团队使用、提交进仓库:curl 单个 SKILL.md(避免杂项文件) 同一台机器多个 agent:npx skills add blader/humanizer --agent '' --skill '' -y 只用 Claude Code:参见 02-install-claude-plugin.md

【适用场景与限制】 适用于支持 skill 的 agent 环境,尤其需要命令行批量安装或保持项目干净时。限制包括:需要 Node.js 才能用 npx;安装后必须重新加载 agent;卸载时不能使用 --agent '*';CLI 会复制整个仓库内容,手动安装则只取 SKILL.md。