How to Install Humanizer from the README.md: 3 Methods Explained

You can install Humanizer using the Skills CLI (npx skills add blader/humanizer), the Claude Code marketplace (/plugin install humanizer@humanizer), or by manually copying the SKILL.md file into your agent's skill directory.

Humanizer is an open-source AI skill distributed by blader/humanizer that rewrites AI-generated prose into human-like text. Since the entire package consists of a single Markdown file with embedded YAML metadata, you do not need to compile anything to install humanizer—you simply need to place the skill file where your agent can access it.

What Is Humanizer?

Humanizer lives entirely in SKILL.md at the repository root. This file contains both the system prompt and metadata (including metadata.version: "3.0.0") that drives the rewriting behavior. Because it is a plain-text Markdown skill, no runtime dependencies or build steps are required; the agent reads the instructions directly and exposes the /humanizer endpoint.

Prerequisites

Before you install humanizer, ensure you have one of the following:

• Node.js and npm (for the Skills CLI method)
• Claude Code 2.1.142 or later (for the marketplace method)
• Access to the agent's skill directory (for manual installation)

Method 1: Install Humanizer Using the Skills CLI

The Skills CLI is the fastest way to install humanizer for global or project-local use.

Global Installation

To make humanizer available across all your projects:

npx skills add blader/humanizer --global

Project-Local Installation

To install humanizer only in the current repository:

npx skills add blader/humanizer

Agent-Specific Installation

To target a specific agent (replace <agent> with the agent name):

npx skills add blader/humanizer --agent <agent>

Or target all agents with --agent '*'.

Method 2: Install Humanizer via Claude Code Marketplace

For Claude Code users, the plugin method registers the skill through the marketplace interface.

First, add the skill from the marketplace:

/plugin marketplace add blader/humanizer

Then install it by name:

/plugin install humanizer@humanizer

After installation, the skill is reachable at the /humanizer:humanizer endpoint according to the .claude-plugin/plugin.json manifest.

Method 3: Manual Installation by Copying SKILL.md

This universal method works for any agent capable of loading Markdown skills, including Claude Desktop.

1. Download or clone the repository:

   git clone https://github.com/blader/humanizer.git

2. Copy SKILL.md into your agent's skill folder (e.g., ~/.claude/skills/ for Claude Desktop).

This approach bypasses package managers entirely and relies on the metadata.version field in the YAML front-matter for version tracking.

How the Installation Works

When you install humanizer via the Skills CLI, the tool places SKILL.md under skills/humanizer/ in either the global skill store or the current project directory. The agent loads this file at runtime and exposes the /humanizer command.

The Claude marketplace install references the .claude-plugin/plugin.json manifest, which points back to SKILL.md and synchronizes version information with agents/openai.yaml. The scripts/validate-package.py script ensures consistency across these packaging files during development.

Because the skill is pure text, no compilation occurs; the agent simply parses the Markdown and uses the embedded instructions to rewrite AI-generated content.

Summary

• Skills CLI: Use npx skills add blader/humanizer --global for system-wide access or omit --global for project-only installation.
• Claude Code Marketplace: Run /plugin install humanizer@humanizer after adding from the marketplace.
• Manual Copy: Place SKILL.md directly into your agent's skill directory for universal compatibility.
• Humanizer requires no build step because it is a Markdown-based skill with YAML front-matter.

Frequently Asked Questions

Do I need to compile Humanizer before installing it?

No. Humanizer is distributed as a plain-text Markdown skill in SKILL.md. It contains no compiled code, so installation only requires copying the file or registering it with your agent's plugin system.

Where does the Skills CLI put the Humanizer files?

The CLI installs SKILL.md into a skills/humanizer/ directory either in your global skill store (with --global) or within the current project. The agent loads the skill from this location at runtime.

Can I install Humanizer for a specific AI agent only?

Yes. When using the Skills CLI, append --agent <name> to the install command to restrict the skill to a specific agent. You can also use --agent '*' to target all agents simultaneously.

What is the minimum Claude Code version required for the marketplace install?

Claude Code version 2.1.142 or later is required to install Humanizer via the marketplace plugin method, as specified in the repository's README.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}