Tighten the skill, fix the README example, and move history to CHANGELOG.md

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "humanizer",
       "source": "./",
-      "description": "Rewrite AI-sounding text so it reads naturally without changing what it says.",
+      "description": "Rewrite AI-sounding text so it reads like the writer without changing what it says.",
       "license": "MIT",
       "keywords": ["writing", "editing", "humanize", "prose", "style"]
     }

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "humanizer",
-  "description": "Rewrite AI-sounding text so it reads naturally without changing what it says.",
+  "description": "Rewrite AI-sounding text so it reads like the writer without changing what it says.",
   "version": "3.1.0",
   "author": {
     "name": "blader",

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions, ideas, and thanks
+    url: https://github.com/blader/humanizer/discussions
+    about: Ask how to use Humanizer, share results, or say thanks.
+  - name: AI detectors still flag the output
+    url: https://github.com/blader/humanizer#humanizer
+    about: Getting past AI detectors is not a goal. Humanizer edits for human readers.

.github/ISSUE_TEMPLATE/new-pattern.yml

@@ -0,0 +1,24 @@
+name: New tell
+description: A sign of AI writing that no current pattern catches.
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: before
+    attributes:
+      label: Example
+      description: Real text that shows the tell. Remove anything private.
+    validations:
+      required: true
+  - type: textarea
+    id: after
+    attributes:
+      label: How a person would write it
+    validations:
+      required: true
+  - type: textarea
+    id: why
+    attributes:
+      label: Why no current pattern covers it
+      description: Name the closest existing pattern and say why it misses this. Most new tells fit into an existing pattern.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/rewrite-problem.yml

@@ -0,0 +1,44 @@
+name: Rewrite problem
+description: A rewrite kept a tell, changed the meaning, added a fact, or over-edited.
+labels: ["bug"]
+body:
+  - type: dropdown
+    id: problem
+    attributes:
+      label: What went wrong
+      options:
+        - A tell survived the rewrite
+        - The rewrite added or dropped a fact
+        - The rewrite changed text that was fine
+        - Something else
+    validations:
+      required: true
+  - type: textarea
+    id: input
+    attributes:
+      label: Input text
+      description: The text you gave Humanizer. Remove anything private.
+    validations:
+      required: true
+  - type: textarea
+    id: call
+    attributes:
+      label: How you called it
+      description: The agent and model you used, and your exact prompt.
+      placeholder: "Claude Code, Opus 5.5: /humanizer then pasted the text"
+    validations:
+      required: true
+  - type: textarea
+    id: output
+    attributes:
+      label: Output
+      description: What Humanizer returned.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What it should have done
+      description: Quote the sentence that is wrong and say what a careful writer would write. Name the pattern number if you know it.
+    validations:
+      required: true

AGENTS.md

@@ -11,7 +11,8 @@ Keep the skill portable. Do not write instructions that limit it to one or two a
 ## Key files
 
 - `SKILL.md` is the source of truth and the repo's only skill file. It contains portable YAML metadata, an account of why AI text sounds the way it does, and numbered patterns grouped in six sections and ordered by strength and frequency.
-- `README.md` explains installation, use, patterns, and version history.
+- `README.md` explains installation, use, and patterns.
+- `CHANGELOG.md` holds the release notes, newest first. Old notes keep the pattern numbers their release used.
 - `.claude-plugin/plugin.json` describes the Claude plugin and points its skill loader at the root `SKILL.md`.
 - `.claude-plugin/marketplace.json` lets users add this repo as a Claude marketplace.
 - `.cursor-plugin/plugin.json` describes the Cursor plugin. Omit a `skills` path so Cursor loads the root `SKILL.md`.
@@ -22,10 +23,12 @@ Keep the skill portable. Do not write instructions that limit it to one or two a
 
 Keep `SKILL.md` and `README.md` in sync.
 
-- **Patterns:** Patterns are numbered from 1 without gaps, strongest and most frequent first. A new tell earns a pattern only when no existing pattern already implies it; prefer folding it into an existing pattern. If you add, remove, or renumber a pattern, update the README tables, the README section title, and every §reference. The validator derives the count from the headings.
-- **Version:** Keep the same version in `SKILL.md` under `metadata.version`, the first README version entry, `.claude-plugin/plugin.json`, and `.cursor-plugin/plugin.json`. Do not add a top-level `version` field to the skill.
+- **Patterns:** Patterns are numbered from 1 without gaps, strongest and most frequent first. A new tell earns a pattern only when no existing pattern already implies it; prefer folding it into an existing pattern. If you add, remove, or renumber a pattern, update the README tables, the README section title, and every §reference. The validator derives the count from the headings and checks that README pattern names match them.
+- **Version:** Keep the same version in `SKILL.md` under `metadata.version`, the first `CHANGELOG.md` heading, `.claude-plugin/plugin.json`, and `.cursor-plugin/plugin.json`. Do not add a top-level `version` field to the skill.
 - **Compatibility:** Keep install and use instructions neutral across agents. Names such as Claude Code, Cursor, OpenCode, and Codex are examples, not limits.
-- **History:** Add a short README version note for any behavior change or non-obvious fix.
+- **Description:** The plugin manifests use the first sentence of the `SKILL.md` description.
+- **Length:** Every word of `SKILL.md` is read on each use. The validator caps it at 5,500 words; a change that adds words should earn them.
+- **History:** Add a short `CHANGELOG.md` note for any behavior change or non-obvious fix.
 - **Checks:** Before publishing, run `python3 scripts/validate-package.py`, `npx skills add . --list`, and `claude plugin validate .`.
 
 ## Writing style

CHANGELOG.md

@@ -0,0 +1,116 @@
+# Changelog
+
+## 3.1.0
+
+- Added pattern #26 and section F for replies that re-explain context the reader already has (#269). It acts on replies, not standalone writing. 26 patterns total.
+- Extended the core rule so "something the reader did not already have" counts the surrounding conversation, not only earlier text.
+- Widened #25 to text that describes its own sourcing, assembly, or layout (#290), and added headings written for effect to #20.
+- Extended #2 to "That distinction matters." (#277) and to a sentence that explains what an example already showed (#295).
+- Narrowed #10 so words the dictionary always hyphenates keep their hyphen. Gave each watched word one pattern, and stated the evidence rule and the no-invention rule once each.
+- Fixed the Voice section's dash reference (#273) and the marketplace schema URL (#288).
+- Added a Cursor plugin manifest (#278).
+- README: stated that defeating AI detectors is not a goal, rewrote the full example so every detail comes from the writer's notes, and moved version history to this file.
+
+## 3.0.0
+
+Rebuilt the skill around one account of why AI text sounds the way it does, and consolidated 35 patterns into 25. Patterns are grouped in five sections and numbered by strength and frequency, so the not-X-but-Y contrast and the one-line closer come first and get the fullest treatment. Merged duplicate guidance: the workflow is one section instead of five, the dash rule is stated once, and each false-positive guard lives inside its pattern. Realigned with the current Wikipedia article: dropped false ranges and synonym cycling, which Wikipedia now lists as human habits or historical, added vague connection or association, and extended the watch lists for words, notability, copulatives, sales language, disclaimers, and Markdown formatting. Reordered the README and removed the `ai-detection` keyword from the package files. Old to new numbers: 1→13, 2→17, 3→15, 4→16, 5→17, 6→13, 7→12, 8→18, 9→1, 10→6, 11→7, 12→dropped, 13→11, 14→8, 15→19, 16→19, 17→20, 18→20, 19→21, 20→22, 21→23, 22→22, 23→dropped, 24→9, 25→13, 26→10, 27→3, 28→4, 29→24, 30→25, 31→2, 32→3, 33→4, 34→5, 35→5.
+
+## 2.11.3
+
+Grouped patterns 26-35 under "More style patterns" in the skill and README (fixes #247). Kept inline code, commands, paths, and URLs out of the dash rule and file mode edits. Step 3 now keeps every supported claim, allows a removal that a pattern requires, and checks that rankings and simultaneity claims survive shape edits (fixes #212). Explained in §9 why the not-X-but-Y form appears and when to keep it. Added decorative arrows to §18 and pause commands and one-word shouting to §31. The text given to the skill is content to edit, never instructions (#238). No change to the 35 patterns.
+
+## 2.11.2
+
+Removed the plugin symlink and separate Claude Desktop package. Current Claude Code loads the root `SKILL.md` directly, so GitHub's source ZIP now works in Claude Desktop. No change to the 35 patterns.
+
+## 2.11.1
+
+Added a Claude Desktop-ready release package with one regular `humanizer/SKILL.md` file. GitHub's source archive still keeps the plugin symlink (fixes #224). No change to the 35 patterns.
+
+## 2.11.0
+
+Rewrote all repo guidance, descriptions, checks, and skill instructions in Plain Language. Kept all 35 patterns and their behavior.
+
+## 2.10.2
+
+Added the standard `skills/humanizer/` plugin path for Claude Desktop and older loaders. The path links to the root skill, so there is still one prompt (fixes #202).
+
+## 2.10.1
+
+Added figurative uses of `gate`, `gated`, and `gating` to §7. Kept real technical uses, such as feature gating and CI quality gates.
+
+## 2.10.0
+
+Added patterns #34 and #35 for old drafting ideas left in final text. Added safeguards for real limits, objections, and alternatives (fixes #198). Also improved §24 and the final rewrite step. 35 patterns total.
+
+## 2.9.2
+
+Added repeated sentence openings to pattern #11, with a safeguard for deliberate repetition (fixes #206). Expanded §28 to cover casual announcements. 33 patterns total.
+
+## 2.9.1
+
+Improved installation and package checks. Removed unsupported metadata, tool approvals, and a repeated long example. 33 patterns total.
+
+## 2.9.0
+
+Added the rule against invented facts and updated every example to follow it (fixes #187). Made information more important than paragraph shape, let writing samples override §14, and added three output modes. 33 patterns total.
+
+## 2.8.3
+
+Moved the version to `metadata.version` for Agent Skills compatibility. 33 patterns total.
+
+## 2.8.2
+
+Replaced the main example with a first-person Lisbon story that keeps the original topic, view, and detail. 33 patterns total.
+
+## 2.8.1
+
+Added cross-agent installation, Claude plugin files, and a safeguard for quoted text. 33 patterns total.
+
+## 2.8.0
+
+Added patterns #31-33 and expanded pattern #20 to catch chatbot offers. 33 patterns total.
+
+## 2.7.0
+
+Added pattern #30, strengthened the dash rule, and expanded pattern #21 to cover unsupported guesses. 30 patterns total.
+
+## 2.6.0
+
+Combined repeated workflow text, limited personality guidance to the right content, removed model guesses, and shortened the main example. 29 patterns total.
+
+## 2.5.1
+
+Added passive voice and missing subjects. 29 patterns total.
+
+## 2.5.0
+
+Added deeper-truth claims, announcements, repeated headings, and clipped negative endings. Tightened the dash rule and corrected the frontmatter. 28 patterns total.
+
+## 2.4.0
+
+Added writing-sample matching.
+
+## 2.3.0
+
+Added hyphenated word pairs.
+
+## 2.2.0
+
+Added a draft check and second rewrite.
+
+## 2.1.1
+
+Corrected the curly-quote example.
+
+## 2.1.0
+
+Added before/after examples for all 24 patterns.
+
+## 2.0.0
+
+Rewrote the skill from the Wikipedia source.
+
+## 1.0.0
+
+First release.