How Humanizer Version 3.0.0 Consolidated 35 Patterns into 25: A Technical Breakdown
Humanizer version 3.0.0 reduced its pattern library from 35 "3-S" patterns to 25 "2-S" patterns by merging duplicate guidance, removing obsolete tells, and reorganizing the section layout to align with Wikipedia's "Signs of AI writing" article.
The blader/humanizer repository underwent a significant architectural reorganization in version 3.0.0, collapsing its original three-section structure into a more streamlined two-section format. This consolidation eliminated redundant workflow guidance and obsolete detection patterns while introducing new watch lists for copulatives, sales language, and Markdown formatting. The changes affect the core SKILL.md file, version metadata, and pattern numbering scheme used throughout the codebase.
Why Consolidate 35 Patterns into 25?
The consolidation from 35 to 25 patterns was driven by three primary objectives: reducing redundancy in the guidance, tightening the editorial workflow, and maintaining alignment with the authoritative Wikipedia "Signs of AI writing" article. According to the version history in README.md (lines 171-172), the previous "3-S" (three-section) layout created navigation depth issues and scattered related rules across multiple headings.
By collapsing five separate workflow sections into a single "How to work" block and merging overlapping detection tells, the skill became more maintainable for contributors and more efficient for users applying the patterns to AI-generated text.
Architectural Changes in Version 3.0.0
Section Layout: From 3-S to 2-S Structure
The most visible change in Humanizer version 3.0.0 is the shift from a three-section to a two-section layout. As implemented in SKILL.md (lines 10-31), the skill now organizes patterns under A. Staging instead of stating and B. Rhythm by rule, supplemented by dedicated sections for Inflation, Formatting, and Leftovers.
This reorganization places related patterns adjacent to one another, reducing the cognitive load when navigating between staging techniques and rhythmic adjustments. The previous structure separated these concepts into three distinct buckets, forcing users to cross-reference between sections.
Merged and Removed Patterns
The consolidation process eliminated specific obsolete patterns that no longer matched current AI detection signatures documented on Wikipedia. Key removals include:
- False ranges – eliminated as a distinct pattern
- Synonym cycling – removed from the active pattern list
- Scattered dash rules – unified into a single entry (Pattern 8)
The workflow guidance, originally fragmented across five separate sections in the 35-pattern version, was merged into a consolidated "How to work" block within the 25-pattern structure. This unified block appears in SKILL.md alongside Pattern 8, providing a single reference point for operational instructions rather than distributing them throughout the document.
New Pattern Additions
While reducing the total count, version 3.0.0 introduced several new detection categories to address emerging AI writing characteristics:
- Vague connection or association – a new pattern targeting ambiguous relational language
- Expanded word-watch lists – additional monitoring for specific lexical markers
- Notability and copulatives – detection of "to be" verb overuse and unsupported significance claims
- Sales language and disclaimers – identification of promotional or liability-shielding phrases
- Markdown formatting – watches for structural formatting tells common in AI outputs
These additions are documented in the version notes within README.md, reflecting the skill's evolution to match current AI text generation patterns despite the net reduction in total pattern count.
Pattern Renumbering Strategy
Humanizer 3.0.0 implemented a comprehensive renumbering scheme to accommodate the consolidated structure. The mapping follows specific translation rules, such as old Pattern 1 mapping to new Pattern 13, and old Pattern 2 mapping to new Pattern 17. This renumbering is fully documented in the README's version history, ensuring that external references and documentation can be accurately updated to point to the correct pattern in the new 25-item sequence.
File Structure and Metadata Updates
The consolidation required synchronized updates across multiple repository files. In SKILL.md, the metadata.version field was updated to "3.0.0" to reflect the new pattern set. The .claude-plugin/plugin.json file received a corresponding version bump in its version field.
Additionally, the ai-detection keyword was eliminated from package files to avoid confusion with external automated detection tools, clarifying that Humanizer functions as an editorial skill rather than an algorithmic detector.
The validation logic in scripts/validate-package.py was updated to check consistency against the new 25-pattern count rather than the previous 35-pattern standard, ensuring that future contributions maintain the consolidated structure.
Implementation Examples
To apply the consolidated 25-pattern set in Claude Desktop or compatible environments:
/humanizer
[Paste AI-generated text here]
# The skill will now evaluate against the 25 unified patterns
# (Staging instead of stating, Rhythm by rule, Inflation, Formatting, Leftovers)
Installation via the command line uses the updated package version:
# Install version 3.0.0 with consolidated patterns
npx skills add blader/humanizer --global
For Claude Desktop configuration:
/plugin marketplace add blader/humanizer
/plugin install humanizer@humanizer
Summary
- Humanizer version 3.0.0 reduced the pattern library from 35 "3-S" patterns to 25 "2-S" patterns to eliminate redundancy and improve navigation.
- Section layout shifted from three sections to two main sections (Staging and Rhythm) plus auxiliary categories, as documented in
SKILL.mdlines 10-31. - Obsolete patterns including "false ranges" and "synonym cycling" were removed, while new watches for vague connections, copulatives, and Markdown formatting were added.
- Workflow guidance was consolidated from five scattered sections into a single "How to work" block, and dash rules were unified under Pattern 8.
- Pattern renumbering maps old identifiers to new ones (e.g., old 1→new 13) to preserve external reference integrity.
- Metadata synchronization updated version strings in
SKILL.md,.claude-plugin/plugin.json, andREADME.mdwhile removing theai-detectionkeyword.
Frequently Asked Questions
What is the difference between "3-S" and "2-S" patterns in Humanizer?
The "3-S" designation refers to the original three-section layout (Staging, Rhythm, Inflation) used in versions prior to 3.0.0, while "2-S" refers to the consolidated two-section structure introduced in version 3.0.0, comprising A. Staging instead of stating and B. Rhythm by rule, plus auxiliary sections for Inflation, Formatting, and Leftovers. This change reduced the pattern count from 35 to 25 while improving logical grouping.
Which specific patterns were removed in Humanizer 3.0.0?
Version 3.0.0 removed patterns for "false ranges" and "synonym cycling" because these tells no longer aligned with the current Wikipedia "Signs of AI writing" article. Additionally, duplicate workflow guidance that was previously split across five separate sections was merged into a single "How to work" block, and scattered dash rules were consolidated into Pattern 8.
How do I update my references to the new pattern numbers?
According to the version history in README.md (lines 171-172), Humanizer 3.0.0 provides a mapping table that translates old pattern numbers to new ones. For example, old Pattern 1 corresponds to new Pattern 13, and old Pattern 2 maps to new Pattern 17. External documentation and prompts referencing specific pattern numbers should be updated using this mapping to ensure they point to the correct guidance in the 25-pattern structure.
Why was the ai-detection keyword removed from the package?
The ai-detection keyword was eliminated from README.md and related package files in version 3.0.0 to prevent confusion with external automated detection tools. The maintainers clarified that Humanizer operates as an editorial skill for manual text refinement rather than an algorithmic detection system, making the previous keyword potentially misleading regarding the tool's intended use case.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →