Skip to content

Rewrite Humanizer in Plain Language - #223

Merged
blader merged 1 commit into
mainfrom
agent/plain-language-humanizer
Aug 17, 2026
Merged

Rewrite Humanizer in Plain Language#223
blader merged 1 commit into
mainfrom
agent/plain-language-humanizer

Conversation

@blader

@blader blader commented Aug 17, 2026

Copy link
Copy Markdown
Owner

What changed

  • Rewrote SKILL.md in Plain Language and shortened it by about 750 words.
  • Rewrote the README, repo guidance, agent metadata, plugin descriptions, workflow labels, and validation messages.
  • Added a Plain Language contract to AGENTS.md and made the package validator check it.
  • Bumped the package to v2.11.0.

What stayed the same

  • All 35 patterns keep the same numbers and behavior.
  • All 88 lines of before-and-after examples are unchanged.
  • Commands, paths, URLs, schema fields, quotations, and the MIT license are unchanged.
  • The root SKILL.md remains the only prompt authority.

Why

Humanizer should model the clear writing it asks other agents to produce. The new wording leads with the main point, uses common words and active voice, keeps sentences short, and explains necessary technical ideas.

Checks

  • python3 scripts/validate-package.py
  • Plain Language policy rejection test
  • python3 .../skill-creator/scripts/quick_validate.py .
  • npx --yes skills add . --list
  • claude plugin validate .
  • JSON and YAML parsing
  • Pattern sequence and README table parity
  • Exact before-and-after example comparison against main
  • git diff --check

@blader
blader marked this pull request as ready for review August 17, 2026 10:04
@blader
blader merged commit 43c9767 into main Aug 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant