human-voice

Human Voice Plugin

A Claude Code plugin that detects AI-generated writing patterns and builds voice profiles through adaptive interviews and computational stylistics.

Experimental. This project is a research prototype. The scoring pipeline, dimension mapping, and NLP analysis have not been validated against external benchmarks or peer-reviewed psychometric standards. The voice profiles it produces are plausible but unproven. Treat the output as a starting point for editorial guidance, not as a validated instrument. The question bank, scoring weights, and dimension definitions will change as the system matures. Use it, break it, report what does not work.

Features

• Multi-tier pattern detection: Character, language, structural, and voice analysis
• Automated character fixes: Auto-fix em dashes, smart quotes, emojis
• Proactive review: Agent triggers after content creation/editing
• Interactive setup: Configuration wizard for project-specific settings
• Configurable: Customize file types, directories, and detection tiers

Installation

From GitHub

claude plugin install zircote/human-voice

Manual Installation

Clone and add to Claude Code:

git clone https://github.com/zircote/human-voice.git
claude --plugin-dir /path/to/human-voice

Or copy to your project's .claude-plugin/ directory.

Prerequisites

• Claude Code CLI
• Node.js 18+ (for validation scripts)

Components

Component	Name	Purpose
Skill	human-voice	Core detection patterns and writing guidelines
Command	/human-voice:voice-setup	Interactive configuration wizard
Command	/human-voice:voice-review [path]	Analyze content for AI patterns
Command	/human-voice:voice-fix [path]	Auto-fix character-level issues
Agent	voice-reviewer	Proactive content review after edits

Usage

Quick Start

# Set up configuration for your project
/human-voice:voice-setup

# Review content for AI patterns
/human-voice:voice-review docs

# Auto-fix character issues
/human-voice:voice-fix docs --dry-run

Skill Triggers

The skill loads automatically when you say:

• "review for AI patterns"
• "make this sound human"
• "check for AI writing"
• "ai slop detection"
• "fix AI voice"
• "improve writing voice"

Commands

Set up configuration:

/human-voice:voice-setup

Detects project structure, content directories, and creates config.json with your preferences.

Review content for AI patterns:

/human-voice:voice-review docs           # review specific directory
/human-voice:voice-review content/blog   # review specific path
/human-voice:voice-review                # auto-detects content directories

Auto-fix character issues:

/human-voice:voice-fix docs              # apply fixes to directory
/human-voice:voice-fix --dry-run docs    # preview changes first
/human-voice:voice-fix                   # auto-detect and fix

Agent

The voice-reviewer agent triggers:

• Proactively: After Write/Edit operations on .md/.mdx files
• On request: When you ask to review content voice

Detection Tiers

Tier 1: Character Patterns (Automated)

Character	Unicode	Replacement
Em dash (--)	U+2014	Period, comma, colon
En dash (-)	U+2013	Hyphen
Smart quotes	U+201C/D, U+2018/9	Straight quotes
Ellipsis (...)	U+2026	Three periods
Emojis	Various	Remove

Tier 2: Language Patterns (Manual)

• Buzzwords: delve, realm, pivotal, harness, revolutionize, seamlessly
• Hedging: "it's worth noting", "generally speaking", "arguably"
• Filler: "in order to", "due to the fact", "at this point in time"

Tier 3: Structural Patterns

• List addiction (everything as bullets)
• Rule of three overuse
• "From X to Y" constructions
• Monotonous sentence structure

Tier 4: Voice Patterns

• Passive voice overuse
• Generic analogies
• Meta-commentary ("In this article...")
• Perfect grammar with shallow insights

Configuration