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.