# Where Are the Humanizer 25 Patterns Documented? Official Source Guide

> Find the official documentation for the 25 Humanizer patterns in the blader/humanizer repository's README and SKILL files. Discover the rhythm by rule section for patterns 6-11.

- Repository: [Siqi Chen/humanizer](https://github.com/blader/humanizer)
- Tags: documentation
- Published: 2026-09-10

---

**The Humanizer 25 patterns are documented in the [`README.md`](https://github.com/blader/humanizer/blob/main/README.md) and [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) files within the `blader/humanizer` repository, specifically under the "B. Rhythm by rule" section that catalogs patterns 6 through 11 of the second set.**

The `blader/humanizer` repository provides a structured framework for identifying and correcting common writing issues through deterministic linguistic rules. Locating where the Humanizer 25 patterns are documented is critical for developers integrating these constraints into AI agents or editorial pipelines.

## Primary Documentation Locations

The authoritative sources for the pattern library reside in two markdown files at the repository root. Each serves a distinct purpose in the documentation hierarchy.

### README.md – High-Level Reference

In [`README.md`](https://github.com/blader/humanizer/blob/main/README.md), the patterns appear under the heading **"B. Rhythm by rule"**. This section presents a condensed table format listing patterns 6 through 11, with each row displaying the pattern number, descriptive name, and example before/after text. According to the source code, this file functions as the quick-reference guide for the 2S (second-set) patterns, providing immediate visual scanning for users.

### SKILL.md – Full Implementation Details

The [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file contains the complete skill prompt that agents load at runtime. Beginning at line 35, the **"B. Rhythm by rule"** section provides exhaustive definitions for the same patterns 6-11, including watch-phrases, problem statements, and detailed remediation strategies. This file serves as the implementation source for the Humanizer pattern engine, containing the exact logic interpreters use to identify violations.

## The 2S Pattern Set: Rhythm by Rule

The documentation organizes the library into sets, with the "2S" designation referring to the second-set patterns focusing specifically on rhythm-by-rule corrections. These patterns address structural flow issues in prose.

### Pattern Structure and Examples

Each pattern in the 2S set follows a consistent documentation format across both files. As implemented in [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md), pattern definitions include a numbered header, watch phrases, problem descriptions, and corrected examples.

#### Pattern 8: Dashes as the Universal Connector

Pattern 8 demonstrates the standard documentation structure found in the source files:

```markdown

### 8. Dashes as the universal connector

**Watch for:** — or – used as a connector
**Problem:** Dashes let the writer skip choosing how two clauses relate.
**Before:**
> The new policy — announced without warning — affects thousands of workers.
**After:**
> The new policy, announced without warning, affects thousands of workers.

```

The same format applies to the remaining second-set patterns:
- **Pattern 6:** Forced triads
- **Pattern 7:** Repeated sentence openings  
- **Pattern 9:** Stacked qualifiers
- **Pattern 10:** Hyphenated pairs everywhere
- **Pattern 11:** Passive voice and missing subjects

## Summary

- The `blader/humanizer` repository maintains authoritative pattern documentation in [`README.md`](https://github.com/blader/humanizer/blob/main/README.md) and [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md).
- The **"B. Rhythm by rule"** section catalogs the second-set patterns (6-11) of the complete Humanizer library.
- [`README.md`](https://github.com/blader/humanizer/blob/main/README.md) provides high-level overview tables suitable for quick reference.
- [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) provides full definitions starting at line 35, including watch-phrases and remediation logic.
- All patterns follow a standardized format with before/after text examples and explicit problem statements.

## Frequently Asked Questions

### What are the 25 patterns in Humanizer?

The Humanizer framework organizes writing improvement rules into categorized pattern sets. According to the source documentation in `blader/humanizer`, the library includes the "2S" or second-set patterns (6-11) covering rhythm-by-rule corrections, with documentation suggesting these are part of a larger comprehensive collection targeting 25 distinct linguistic anti-patterns.

### How do I access the full pattern definitions for implementation?

Navigate to the [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) file in the root of the `blader/humanizer` repository. The complete definitions begin at line 35 under the "B. Rhythm by rule" section, providing the exact syntax, watch-phrases, and correction logic used by the Humanizer agent at runtime.

### What is the difference between README.md and SKILL.md pattern documentation?

[`README.md`](https://github.com/blader/humanizer/blob/main/README.md) offers a high-level overview table suitable for quick human reference and repository browsing, while [`SKILL.md`](https://github.com/blader/humanizer/blob/main/SKILL.md) contains the actual prompt text loaded by the Humanizer agent, including detailed watch-phrases and remediation examples required for automated pattern detection.

### Which specific patterns are included in the documented 2S set?

The documented second set includes patterns 6 through 11: Forced triads, Repeated sentence openings, Dashes as the universal connector, Stacked qualifiers, Hyphenated pairs everywhere, and Passive voice with missing subjects.