SynthOperator Humanizer: The Complete Operator's Manual

Welcome to the SynthOperator Humanizer deployment guide. This manual covers the step-by-step setup configurations to install and activate the 33-pattern humanization engine across web and local development environments.

---

01. Overview

The SynthOperator Humanizer uses 33 readability heuristics sourced from Wikipedia’s AI Cleanup guidelines to detect, isolate, and strip away stylistic tells and vocabulary overused by LLMs. By combining syntactic sentence variation, vocabulary filters, and style-matching rules, the Humanizer transforms predictable machine drafts into authentic, engaging text.

---

02. Requirements

• Claude.ai Account (Free or Pro/Max/Team tiers).
• Claude Code CLI installed globally via npm:

  npm install -g @anthropic-ai/claude-code
  

• The downloaded humanizer-v1.0.0 folder and humanizer-v1.0.0.zip package.

---

03. Installation for Claude Code (CLI)

Claude Code supports native user-scoped plugins. Follow the instructions for your operating system.

A. Windows Installation (PowerShell)

Method A — Automatic Script (Recommended)

1. Open PowerShell in the directory containing your downloaded files.
2. Run the installer script:

   powershell -ExecutionPolicy Bypass -File install-windows.ps1
   

3. The script verifies your claude installation, extracts the package to %LOCALAPPDATA%\SynthOperator\humanizer-source\, registers the local marketplace, and installs the plugin.

Method B — Manual Commands

1. Unzip humanizer-v1.0.0.zip to %LOCALAPPDATA%\SynthOperator\humanizer-source\.
2. Register the local marketplace:

   claude plugin marketplace add "$env:LOCALAPPDATA\SynthOperator\humanizer-source\humanizer" --scope user
   

3. Install the plugin:

   claude plugin install humanizer@synthoperator -s user
   

---

B. macOS / Linux Installation (Terminal)

Method A — Automatic Script (Recommended)

1. Open Terminal in the folder containing your downloaded files.
2. Grant executable permissions to the script and run it:

   chmod +x install-mac.sh
   ./install-mac.sh
   

3. The script extracts files to ~/Library/Application Support/SynthOperator/humanizer-source/ and runs the gcloud/claude commands to register and install the user-scoped plugin.

Method B — Manual Commands

1. Unzip humanizer-v1.0.0.zip into ~/Library/Application Support/SynthOperator/humanizer-source/.
2. Register the local marketplace:

   claude plugin marketplace add "~/Library/Application Support/SynthOperator/humanizer-source/humanizer" --scope user
   

3. Install the plugin:

   claude plugin install humanizer@synthoperator -s user
   

---

04. Installation for Claude.ai (Web)

Method 1 — Upload ZIP Plugin (Paid Tiers Only)

1. Log in to claude.ai.
2. Click on the Customize menu in the left sidebar.
3. Choose the Plugins tab.
4. Click Upload Plugin and select humanizer-v1.0.0.zip.
5. Claude will register the plugin schemas and enable it for all chats.

Method 2 — Manual Custom Skill (Free & Paid Tiers)

1. Log in to claude.ai.
2. Click on the Customize menu in the left sidebar.
3. Choose the Skills tab.
4. Click Add Skill or Upload Skill.
5. Upload the SKILL.md file from the extracted humanizer-v1.0.0 folder.

---

05. Voice Calibration Protocol

To make the rewrites sound exactly like your own voice rather than a generic clean text style, use the calibration syntax before passing your content:

Here's a sample of my writing for voice matching:
[paste 2-3 paragraphs of your own writing]

Now humanize this text:
[paste AI text to humanize]

What happens during calibration:

1. Metric Parsing: The engine measures your average sentence length, punctuation style (e.g., use of parentheses or lists), and vocabulary density.
2. Exclusion Filters: The tool aligns its 33 heuristic rules to match your writing patterns, preventing the rewrite from over-editing your preferred phrasing quirks.
3. Output Reconstruction: The text is rewritten to match the calibrated style metrics.

---

06. Troubleshooting & Commands

Verify Plugin Installation in Claude Code

To check if the plugin is successfully registered locally, execute:

claude plugin list --json

Verify that humanizer@synthoperator is listed with "scope": "user".

CLI Troubleshooting table

Issue	Cause	Solution
claude command not found	Node.js npm binaries not in PATH	Check Node installation or run npm install -g @anthropic-ai/claude-code.
Marketplace synthoperator not found	Registration failed	Re-run the claude plugin marketplace add command manually.
Missing updates / old rules	Cache out of sync	Run claude plugin marketplace update synthoperator then restart session.
Ad-hoc testing needed	Run without installing	Start the CLI with: claude --plugin-dir /path/to/humanizer-v1.0.0

---

07. Support & Licensing

• Support: Reach out to support@synthoperator.com for help with install scripts or configuration issues.
• License: Commercial derivative of the open-source MIT-licensed blader/humanizer by Siqi Chen. Under our EULA, redistribution, white-labeling, or resale is strictly prohibited.