# Can I Use Humanizer as a Claude Desktop Plugin? Complete Setup Guide > Yes, use Humanizer as a Claude Desktop plugin. Upload SKILL.md directly to Skills. No external dependencies or complex setup required. Get started easily. - Repository: [Siqi Chen/humanizer](https://github.com/blader/humanizer) - Tags: how-to-guide - Published: 2026-09-04 --- **Yes, you can use Humanizer as a Claude Desktop plugin by uploading the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file directly to the Skills pane, which requires no external dependencies, runtime code, or complex configuration.** The blader/humanizer repository delivers a plain-text Markdown skill designed specifically for Claude Desktop integration. Because the tool consists entirely of the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file containing 35 rewrite patterns, you can install it immediately without worrying about environment variables, package managers, or code execution permissions. ## How Humanizer Works in Claude Desktop Humanizer operates as a **zero-dependency skill** that processes text through predefined linguistic patterns. The repository root contains [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md), which Claude Desktop reads directly to understand the skill's behavior and command structure. Unlike traditional plugins that require executable code, Humanizer functions entirely within Claude's context window. The [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file includes YAML front-matter defining the skill metadata and numbered instructions that guide the model's rewriting behavior. This architecture makes the repository fully compatible with Claude Desktop's skill system as of the recent update that removed the separate Claude Desktop package in favor of direct [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) loading. ## Step-by-Step Installation Guide Setting up Humanizer as a Claude Desktop plugin involves downloading the repository and importing the skill file. ### Download the Repository First, obtain the skill files from the blader/humanizer GitHub repository. You can download the entire repository as a ZIP archive or clone it locally. ```bash # Option 1: Download ZIP via browser # Visit: https://github.com/blader/humanizer/archive/refs/heads/main.zip # Option 2: Clone with Git git clone https://github.com/blader/humanizer.git ``` Extract the ZIP file if downloaded via browser. The archive contains [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) at the root level, along with optional plugin metadata in the `.claude-plugin/` directory. ### Upload the SKILL.md File Once you have the repository locally, import the skill into Claude Desktop: 1. Open Claude Desktop and navigate to the **Skills** pane 2. Click **Add skill** 3. Select **Upload file** and choose the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file from the extracted folder (or select the entire extracted folder) 4. Claude Desktop will parse the YAML front-matter and load the 35 rewrite patterns automatically The skill immediately appears in your available skills list without requiring additional installation steps. ## Using the Humanizer Command After installation, invoke the skill using the command defined in the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) metadata: ```text /humanizer ``` Or use the fully qualified command: ```text /humanizer:humanizer ``` Follow the command with the text you want to process. Claude will apply the 35 humanization patterns defined in the skill prompt to rewrite the input according to natural language best practices. ## Alternative: Claude Plugin Marketplace Installation While the direct [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) upload is the primary method, the repository also includes optional Claude Plugin metadata for marketplace integration. To install via the Claude Plugin system, use the plugin management commands: ```bash /plugin marketplace add blader/humanizer /plugin install humanizer@humanizer ``` This method utilizes the metadata files located in [`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json) and [`.claude-plugin/marketplace.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/marketplace.json). After marketplace installation, invoke the skill using `/humanizer:humanizer` as with the direct upload method. ## Core Files and Their Purpose Understanding the repository structure helps clarify why Humanizer works seamlessly as a Claude Desktop plugin. ### SKILL.md The [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file serves as the **entire runtime** of the application. Located at the repository root, this file contains: - YAML front-matter defining the skill name, version, and entry command - 35 numbered linguistic patterns for text humanization - Execution instructions that Claude follows when processing requests Because Claude Desktop skills read Markdown files directly, no compilation or build step is necessary. The README explicitly confirms that uploading the ZIP containing this file functions as a complete skill installation. ### Plugin Metadata Files The `.claude-plugin/` directory contains optional configuration for the Claude Plugin ecosystem: - [`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json): Defines plugin metadata including name, version, and entry points for the marketplace system - [`.claude-plugin/marketplace.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/marketplace.json): Enables discovery via the `/plugin marketplace` command These files support the alternative installation method but are not required when uploading [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) directly to Claude Desktop. ### Validation Scripts The repository includes [`scripts/validate-package.py`](https://github.com/blader/humanizer/blob/main/scripts/validate-package.py), which runs during CI to ensure that skill files remain synchronized. While users do not need to execute this script for installation, its presence confirms that the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) patterns match the documented behavior in the README. ## Summary - **Humanizer requires zero runtime dependencies** and functions entirely through the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) Markdown file - **Installation requires only downloading** the repository and uploading [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) to Claude Desktop's Skills pane - **The repository root structure** supports both direct skill uploads and optional Claude Plugin marketplace installation via [`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json) - **Recent versions** eliminated separate packaging, confirming that the root [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) is the canonical installation method for Claude Desktop - **Invoke the skill** using `/humanizer` or `/humanizer:humanizer` to access the 35 text rewriting patterns ## Frequently Asked Questions ### Do I need to install Python or Node.js to use Humanizer in Claude Desktop? No. Humanizer operates entirely within Claude's context window using the patterns defined in [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md). The repository contains no executable code requiring Python, Node.js, or any other runtime. You only need to upload the Markdown skill file to Claude Desktop. ### What is the difference between uploading SKILL.md and using the Claude Plugin marketplace? Uploading [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) directly installs the skill immediately using Claude Desktop's native skill system, while the marketplace method uses the metadata in [`.claude-plugin/plugin.json`](https://github.com/blader/humanizer/blob/main/.claude-plugin/plugin.json) to register the plugin through Claude's plugin management commands. Both methods access the same 35 patterns, but direct upload is faster and requires no command-line interaction. ### Can I modify the humanization patterns? Yes. Because [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) is a plain-text Markdown file, you can edit the 35 numbered patterns directly before uploading. However, modifying the file means you are using a custom version rather than the official blader/humanizer skill. The [`scripts/validate-package.py`](https://github.com/blader/humanizer/blob/main/scripts/validate-package.py) file in the repository validates pattern consistency during development, though end users do not need to run it. ### Why was the separate Claude Desktop package removed? According to the repository's version history, the maintainers removed the separate Claude Desktop package because Claude Desktop can now load the root [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file directly. This simplification reduces maintenance overhead and ensures users always receive the latest patterns without waiting for separate package updates.