pmai-humanize

Rewrites Chinese documents to remove AI-style phrasing, jargon, and verbosity.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-humanize-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-humanize
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/humanize
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-humanize-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Chinese product documents often read like machine output: padded sentences, buzzwords like 赋能 and 闭环, decorative bolding, and "not X but Y" rhetorical patterns that force readers to decode meaning. This Skill detects and fixes those expression-level problems so documents read plainly, without touching facts or structure. ## Core Features & Use Cases - Three working modes: annotate problems only (detect), produce a full rewrite with a change summary (rewrite, default), or edit the file in place (edit). - Four-category pattern scan: checks verbosity, AI-flavored phrasing, jargon, and vague writing against a graded pattern catalog in references/patterns.md, with P0/P1/P2 severity levels. - Optional independent cold read: when a codex environment exists, runs a separate-context critique pass to catch residual AI tone and unintended meaning changes. - Use Case: A PM pastes a PRD section full of "拉通 / 抓手 / 不是简单的X而是Y" phrasing and asks to 说人话; the Skill returns a plain-language rewrite with a list of what changed and a second self-review pass. ## Quick Start Paste a paragraph of Chinese product text or give a file path and ask to polish it and remove the AI tone, optionally specifying annotate, rewrite, or edit mode.

Frequently Asked Questions about pmai-humanize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove AI-sounding phrasing from Chinese documents?

Run the rewrite mode, which scans text against a four-category pattern catalog covering verbosity, AI-style phrasing, jargon, and vague wording. It returns a full rewrite with a change summary and a second self-review pass to catch residual machine tone.

How to polish a PRD without changing its meaning?

Use this Skill's rewrite mode, which only adjusts expression and explicitly preserves facts, numbers, conclusions, and constraints. If a change might alter meaning, it flags the spot and asks instead of deciding on its own.

What is the difference between annotate, rewrite, and edit modes?

Annotate only lists problems with severity and fix directions without changing text. Rewrite produces a full revised draft with a change summary and is the default. Edit modifies the file directly when you provide a path and explicitly ask for in-place changes.

Does it keep technical terms like RBAC or SLA?

Yes. Precise terms needed for security, permission, or performance contracts are kept and given a business explanation on first use. Only unexplained jargon and engineering slang in ordinary product descriptions get replaced with everyday wording.

When should I not use this text polishing skill?

Do not use it when the real problem is document structure or missing content such as absent rules, scope, or evidence. Those cases route to spec-writing or doc-writing skills; this one only adjusts expression, never reorganizes or supplements content.