# How to Install the Humanizer Skill Using npm: Complete Guide > Easily install the Humanizer skill using npm with our complete guide. Learn to add blader/humanizer locally or globally for enhanced functionality. Get started now! - Repository: [Siqi Chen/humanizer](https://github.com/blader/humanizer) - Tags: how-to-guide - Published: 2026-09-04 --- **Run `npx skills add blader/humanizer` to install the Humanizer skill via npm without global installation, or add `--global` for system-wide access.** Humanizer is an open-source skill distributed through the Skills CLI that enhances AI agent capabilities with natural language processing utilities. This guide explains how to install the Humanizer skill using npm directly from the `blader/humanizer` repository, covering local project setups, global installations, and agent-specific configurations. ## Prerequisites Before you install the Humanizer skill using npm, ensure you have: - **Node.js and npm** installed on your system (the `npx` command requires npm 5.2.0 or higher) - Access to a compatible AI agent that supports the Skills CLI architecture - Terminal or command-line access to execute the installation commands ## Installation Methods The Humanizer skill supports multiple installation scopes depending on whether you need project-specific functionality or system-wide availability. ### Local Project Installation To install the Humanizer skill for only the current project (recommended for development environments), omit the `--global` flag. This keeps the skill isolated to your working directory and avoids version conflicts across different projects. ```bash # Install Humanizer only for the current project npx skills add blader/humanizer ``` This command downloads the skill from the `blader/humanizer` package and configures it locally. ### Global System Installation For team environments or when you want the Humanizer skill available across all projects on your machine, use the `--global` flag. This installs the skill to your global npm configuration. ```bash # Install Humanizer globally (available to all projects) npx skills add blader/humanizer --global ``` Global installation ensures consistent behavior across multiple directories but requires administrator privileges on some systems. ### Agent-Specific Installation The Skills CLI supports targeting specific AI agents during installation. Use the `--agent` flag to attach the Humanizer skill to particular agents or all supported agents simultaneously. ```bash # Install and attach the skill to a specific agent npx skills add blader/humanizer --agent claude # Install and attach the skill to every supported agent npx skills add blader/humanizer --agent '*' ``` After executing any installation command, **reload your agents** (restart Claude Code, Claude Desktop, or other compatible interfaces) so they recognize and load the new skill. ## Understanding the Skill Structure The `blader/humanizer` repository organizes its components to support seamless npm distribution. When you install the Humanizer skill using npm, you are deploying these key files: - **[`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md)** – Contains the core skill definition, including pattern matchers, metadata, and text rewrite logic that powers the humanization features. - **[`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json)** – Declares the Claude plugin entry point and references [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) to integrate with Claude-specific interfaces. - **[`scripts/validate-package.py`](https://github.com/blader/humanizer/blob/main/scripts/validate-package.py)** – A helper script that validates package structure and version consistency before distribution. - **[`README.md`](https://github.com/blader/humanizer/blob/main/README.md)** – Documents the npm-based installation commands and usage instructions (lines 89-95). These files work together to ensure the skill packages correctly and registers with your agent's skill registry upon installation. ## Verifying the Installation After running the npm installation command, verify the Humanizer skill is properly registered: 1. Check your agent's skill registry or plugin manager for "Humanizer" or "blader/humanizer" 2. Test basic functionality by invoking humanization commands within your agent interface 3. Review the agent logs for successful skill loading confirmation If the skill does not appear immediately, confirm you have reloaded the agent completely, as skills are typically loaded at startup rather than dynamically. ## Summary - **Install locally** with `npx skills add blader/humanizer` to restrict the skill to your current project - **Install globally** by adding `--global` for system-wide availability across all projects - **Target specific agents** using `--agent ` or `--agent '*'` to control which AI interfaces receive the skill - **Always reload agents** after installation to activate the Humanizer skill in your environment - The skill definition resides in [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) while installation instructions live in [`README.md`](https://github.com/blader/humanizer/blob/main/README.md) within the `blader/humanizer` repository ## Frequently Asked Questions ### What is the difference between local and global installation of the Humanizer skill? Local installation binds the skill to your current working directory, making it available only within that specific project context. Global installation places the skill in your system's npm packages, making it accessible across all directories and projects on your machine. Local installation is preferred for avoiding version conflicts, while global installation simplifies access for frequently used development environments. ### Do I need to restart my agent after installing the Humanizer skill? Yes, you must reload or restart your AI agent after running the npm installation command. Agents typically load their skill registries at startup rather than dynamically checking for new additions. Restart Claude Code, Claude Desktop, or whichever compatible agent you are using to ensure the Humanizer skill registers and becomes available in your interface. ### Can I install the Humanizer skill without npm? No, the official installation method requires npm to execute the Skills CLI via `npx`. The `blader/humanizer` repository is distributed as an npm package designed for the Skills CLI ecosystem. While you could manually download the repository files, the supported and documented installation path requires `npx skills add blader/humanizer` as specified in the README.md. ### Where is the skill definition stored in the repository? The core skill logic resides in [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) at the repository root, which contains the pattern definitions, metadata, and rewrite rules. The [`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json) file points to this skill definition for Claude-specific integrations. Additionally, [`scripts/validate-package.py`](https://github.com/blader/humanizer/blob/main/scripts/validate-package.py) ensures the package structure remains valid before the npm publication process distributes these files to your local installation.