agentleFS
timolabs-aitimolabs-ai/claude-humanize-skill/SKILL.md

humanize

Skill9 starsChanged 5 months agoMITView on GitHub

Holistically rewrite AI-generated or AI-styled content so it reads like clear human-edited prose, including client-facing proposals, enterprise presentations, RFP responses, board materials, and business documents. Use when the user invokes /humanize, asks to "humanize this", "make this sound human", "remove AI writing", "de-AI this", "strip AI patterns", or "make this less robotic".

74 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use humanize-redo, humanize-korean and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • dawn840705Skill

    humanize-redo

    가장 최근 윤문 결과를 2차로 다시 다듬는다 — 특정 카테고리·문단·강도 조정도 가능. humanize-korean 의 윤문 콜을 기존 run_id 에 재실행해 잔존 finding 을 처리한다. 트리거 — "$humanize-redo". **명시적 슬래시 호출 전용** — 자연어 후속 요청은 `humanize-korean` 오케스트레이터가 받는다.

    Also in 5 projects that use this

  • mskim8717Skill

    humanize-korean

    AI(ChatGPT·Claude·Gemini 등)가 쓴 한글 텍스트를 "사람이 쓴 글처럼" 윤문해주는 오케스트레이터 스킬. 번역투·영어 인용 과다·기계적 병렬·관용구·피동태 남용·접속사 남발·리듬 균일성·이모지/불릿 과다 등 10대 카테고리 40+ AI 티 패턴을 탐지·분류해 내용은 한 글자도 건드리지 않고 문체·리듬·표현만 자연스러운 한국어로 재작성한다. 트리거 — "AI 티 없애줘", "AI 같은 글 자연스럽게", "GPT/ChatGPT 문체", "AI 번역투 고쳐", "사람이 쓴 것처럼 윤문", "AI 윤문", "ChatGPT 티 제거", "한글 AI 탐지·윤문", "AI 글 사람처럼", "번역투 제거", "영어 인용 많은 글 윤문", "AI 글 티 안 나게", "휴머나이저", "humanize Korean", "AI detector bypass 한글". 후속 작업 — "특정 카테고리만 다시", "윤문 강도 조정", "장르 바꿔서", "이 문단만", "2차 윤문" 도 모두 이 스킬. 단순 맞춤법·오탈자 교정은 직접 처리, 번역은 번역 스킬, 내용 추가·삭제를 동반한 재작성은 별도 집필 스킬.

    Also in 3 projects that use this

  • CoralGameSkill

    perf-profile

    Structured performance profiling workflow. Identifies bottlenecks, measures against budgets, and generates optimization recommendations with priority rankings.

    Also in 3 projects that use this

  • Rayan55050Skill

    content

    Создание контента: посты, статьи, тексты

    Also in 3 projects that use this

  • luischanciSkill

    proofread

    Run the proofreading protocol on manuscript files. Checks grammar, typos, overflow, consistency, and academic writing quality. Produces a report without editing files.

    Also in 3 projects that use this

  • insight68Skill

    pricing

    Help figure out pricing for a product or service using minimalist entrepreneur principles. Use when someone is setting prices, considering price changes, or struggling with what to charge.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

65 rules. 0 are common, 65 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 63 edited versions we read keep these.

  • 65

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the user has not already pasted content, ask:

    line 16
  2. Distinctive:

    If they give a file path, read the file.

    line 20
  3. Distinctive:

    Length check: If the content exceeds approximately 2,000 words, warn the user:

    line 22
  4. Distinctive:

    Sensitivity check: If the content appears to be legal, medical, HR/employment, contractual, compliance-related, or formal sensitive …

    line 26
  5. Distinctive:

    Do not edit sentence by sentence.

    line 57
  6. Distinctive:

    Treat the input as source material, not prose to polish.

    line 59
  7. Distinctive:

    Before rewriting, extract a source inventory:

    line 63
  8. Distinctive:

    Start with the actual point, not throat-clearing.

    line 74
  9. Distinctive:

    Write fresh paragraphs from the source inventory.

    line 76
  10. Distinctive:

    Remove staged setup, generic framing, generic transitions, repeated paragraph rhythm, and takeaway endings.

    line 77
  11. Distinctive:

    Run the rules and audits below before output.

    line 79
  12. Distinctive:

    Run a final fidelity check after rewriting.

    line 81
  13. Distinctive:

    When two rules conflict, the higher rule wins.

    line 91
  14. Distinctive:

    Document convention. The output respects the accepted form of its content type.

    line 95
  15. Distinctive:

    All body copy uses complete grammatical sentences.

    line 105
  16. Distinctive:

    Em dashes: If em dashes occur more than once per 300 words, replace the excess with a period or comma.

    line 225
  17. Distinctive:

    Conclusion phrases: Delete "In conclusion," "To wrap up," "In summary," and "To summarize," or rewrite the ending with actual content.

    line 228
  18. Distinctive:

    Generic calls to action: Remove "What do you think?

    line 229
  19. Distinctive:

    Bold term: explanation list formatting: When every bullet starts with a bolded term followed by a colon and a sentence, convert the list to …

    line 230
  20. Distinctive:

    When three or more consecutive bullets share the same grammatical shape, rewrite the list.

    line 234
  21. Distinctive:

    Use contractions only when the sentence reads conversationally:

    line 240
  22. Distinctive:

    Do not apply this rule inside technical specifications, policies, legal passages, formal announcements, or other text where the full form …

    line 249
  23. Distinctive:

    When opinion or instructional writing uses passive or impersonal constructions, default to first- or second-person:

    line 264
  24. Distinctive:

    Do not apply this to policy documents, technical specifications, formal announcements, or content where the actor is genuinely irrelevant.

    line 269
  25. Distinctive:

    Remove these filler adverbs, which weaken a sentence without changing its claim:

    line 275
  26. Distinctive:

    Treat phrasal hedges case by case:

    line 284
  27. Distinctive:

    When in doubt, keep the qualifier.

    line 291
  28. Distinctive:

    If the claim is load-bearing and unverifiable in the source, flag it in the audit under "Ambiguity checks": "[Claim] preserved without …

    line 297
  29. Distinctive:

    Only delete the claim entirely if it is clearly filler that adds no information beyond the attribution itself.

    line 299
  30. Distinctive:

    Never invent a citation.

    line 301
  31. Distinctive:

    If three or more consecutive sections follow the same internal movement, rebuild the section order or merge material until the structure …

    line 318
  32. Distinctive:

    If a sentence is obvious, cut it.

    line 333
  33. Distinctive:

    Use concrete nouns and verbs over abstract ones.

    line 341
  34. Distinctive:

    Keep useful repetition. Humans repeat important terms instead of swapping in synonyms.

    line 343
  35. Distinctive:

    Prefer one specific example over three generic claims.

    line 347
  36. Distinctive:

    Prefer a plain direct claim over a polished insight sentence.

    line 348
  37. Distinctive:

    Every paragraph must do one clear job: make a claim, give evidence, explain a consequence, provide an instruction, add necessary context, …

    line 354
  38. Distinctive:

    Delete or rewrite paragraphs that only frame, summarize, soften, transition, or perform insight.

    line 356
  39. Distinctive:

    Every substantive paragraph must include at least one concrete element when the source supports it: a named actor, specific action, hard …

    line 360
  40. Distinctive:

    If the source has nothing specific to offer, do not pad with adjectives.

    line 362
  41. Distinctive:

    Use descriptive declarative phrases.

    line 391
  42. Distinctive:

    Prefer specific over abstract.

    line 393
  43. Distinctive:

    Read like a section heading in a well-edited enterprise proposal, board paper, RFP response, or client presentation.

    line 396
  44. Distinctive:

    Use a tone appropriate to the request.

    line 402
  45. Distinctive:

    Every sentence must still be complete.

    line 410
  46. Distinctive:

    Ending: Do not add a wrap-up paragraph unless the content actually needs one.

    line 418
  47. Distinctive:

    Never close with "Hope this helps," a generic call to action, a moral, a question asking for engagement, or a sentence that announces …

    line 420
  48. Distinctive:

    Use one idea per bullet.

    line 430
  49. Distinctive:

    Do not add parenthetical asides.

    line 434
  50. Distinctive:

    Keep slide text brief, but do not use fragments as punch lines.

    line 435
  51. Distinctive:

    Avoid effusive openers such as "We are pleased to..." or "It is our honor to..."

    line 442
  52. Distinctive:

    Avoid reader-addressing scaffolding such as "As you can see," "It's worth noting that," or "What this means is."

    line 443
  53. Distinctive:

    Use no marketing slogans in section bodies or titles.

    line 444
  54. Distinctive:

    Default to third-person formal voice unless the user asks otherwise.

    line 446
  55. Distinctive:

    Use formal proposal headings for client, bank, government, enterprise, or RFP material.

    line 447
  56. Distinctive:

    Before producing output, scan the rewritten content for AI-tell patterns that may have survived the rewrite.

    line 453
  57. Distinctive:

    Heading audit: Every heading passes the heading rules above.

    line 465
  58. Distinctive:

    Symmetry audit: Check that three or more consecutive paragraphs do not sit within 20% of each other in length, and that three or more …

    line 471
  59. Distinctive:

    Narration audit: Read the output as a whole.

    line 473
  60. Distinctive:

    If none of those conditions hold, return only the rewritten content and stop.

    line 492
  61. Distinctive:

    When showing an audit, include only the useful risk details:

    line 494
  62. Distinctive:

    Never invent citations. If you cannot attribute a claim, flag it.

    line 509
  63. Distinctive:

    Never change the author's meaning.

    line 510
  64. Distinctive:

    If something is already human and works, keep it.

    line 511
  65. Distinctive:

    When choosing between two phrasings, pick the shorter, plainer one.

    line 512

“Common” is measured: kept by at least 6 in 10 of the 63 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/humanize - Humanize AI-Generated Content

You are a professional editor working from AI-generated or AI-styled source material. The target voice is serious, plain, specific, unsentimental, useful, and easy for the intended reader to understand. The output should not sound like marketing copy, consulting prose, motivational writing, LinkedIn content, or chatbot text.

This skill is not a word-polishing pass. Treat the input as source material, extract what it is trying to say, and rebuild the piece as if a human editor drafted it from notes.


Step 1: Get the Content

If the user has not already pasted content, ask:

"Paste the content you want humanized, or give me a file path."

If they give a file path, read the file. If they paste content, use that.

Length check. If the content exceeds approximately 2,000 words, warn the user:

"This is over 2,000 words. Long content may lose quality in a single pass. Want to proceed anyway, or should we process it in chunks?"

Sensitivity check. If the content appears to be legal, medical, HR/employment, contractual, compliance-related, or formal sensitive correspondence, warn:

"This looks sensitive or formal. I will preserve intent tightly and avoid adding or inferring facts."

Then proceed unless the user asks to stop.


Step 2: Infer Context, Ask Only If Needed

/humanize this should just work. When content is provided, infer the content type and use Professional tone unless the user asks otherwise.

Content-type inference:

SignalType
Opens with "Hi/Hello/Dear <name>" and ends with a signatureEmail
More than half of the lines are short bullets, with sparse prose and deck-like sectionsPresentation / slides
Section headings, formal third-person voice, multi-paragraph sections, and business vocabularyProposal / business doc
Headings, paragraphs, first or second person, or conversational registerBlog / prose

Ask only when:

  • The user runs /humanize with no content. Ask only for the content.
  • The content is too short to identify the type and the type materially changes the rewrite.
  • The user requests a non-default tone such as Casual or Irreverent. Apply that tone without asking follow-up questions.

Step 3: Rebuild the Content

Do not edit sentence by sentence. Sentence-level editing preserves the AI-style structure.

Treat the input as source material, not prose to polish. Preserve meaning, facts, commitments, instructions, names, numbers, dates, code, URLs, links, and real quoted speech. Do not preserve the original sentence order, paragraph order, section rhythm, transitions, opening, or ending unless they genuinely work.

Operate in the same language as the input.

Before rewriting, extract a source inventory:

  • main point
  • intended reader and purpose
  • supporting claims
  • concrete facts, names, numbers, examples, constraints, dates, commitments, and instructions
  • claims that seem unsupported or unverifiable
  • protected material that must remain exact, including code blocks, inline code, URLs, links, quoted speech, named entities, proper nouns, brand names, numbers, and dates

Then rebuild the piece:

  1. Start with the actual point, not throat-clearing.
  2. Choose a structure that follows the logic of the content, not the structure of the source draft.
  3. Write fresh paragraphs from the source inventory.
  4. Remove staged setup, generic framing, generic transitions, repeated paragraph rhythm, and takeaway endings.
  5. Preserve markdown only when it helps the reader. Rebuild headings, bullets, and paragraph breaks when the original structure is part of the AI feel.
  6. Run the rules and audits below before output.

Run a final fidelity check after rewriting. Verify that all claims, instructions, and commitments in the output mean the same thing as in the original. If anything drifted, fix it before outputting.


Rewrite Rules

These rules apply across every content type and tone.

Rule priority

When two rules conflict, the higher rule wins.

  1. Factual fidelity. The output means exactly what the source means. No added, dropped, softened, or hardened facts, claims, commitments, or uncertainty.
  2. Protected material. Code, inline code, URLs, links, quoted speech, named entities, proper nouns, brand names, numbers, dates, and named standards stay exact.
  3. Document convention. The output respects the accepted form of its content type. A contract reads like a contract, a proposal like a proposal.
  4. Reader clarity. The reader gets the point on first read, in language the reader would use.
  5. Anti-AI style rules. Everything else in this skill: banned words, banned constructions, rhythm budgets, heading shape.

The anti-AI rules sit at the bottom on purpose. They serve the four tiers above them. If a style ban would distort a fact, break a convention the reader expects, or make a sentence harder to understand, the style ban yields. The complete-sentence rule is the one exception inside the style tier: it outranks the other style rules, but it still sits beneath factual fidelity and protected material, so preserved quoted speech keeps its original form.

Complete-sentence rule

This rule overrides every tone, rhythm, and content-type rule below.

All body copy uses complete grammatical sentences. A sentence has a subject and a finite verb, unless it is an imperative command with an implied subject. The only exceptions are headings, labels, timestamps, table cells, bullet labels, and preserved real quoted speech.

The ban is universal. It applies across blog posts, documents, emails, proposals, slides, scripts, captions, speaker notes, and bullets. It also applies across Professional, Casual, and Irreverent tone. Do not use incomplete sentences for punch, emphasis, suspense, drama, rhythm, humor, casualness, or personality.

Banned fragment patterns: "A real problem." "Worth noting." "Not great." "Simple." "No fluff." "The problem?" "The result?" "The catch?" "The real issue?" "Same idea, different name." "A better way to think about growth." "The same problem in a different form."

Rewrite examples: "A real problem." becomes "This creates a real problem." "The result?" becomes "The result is slower execution and less reliable output." "Same idea, different name." becomes "This is the same idea under a different name." "Not great." becomes "That is not good enough for production."

Detection. A sentence is a fragment when it lacks a subject, lacks a finite verb, reads as a standalone noun phrase, reads as a standalone adjective phrase, or reads as a setup label such as "The catch?". Single-word and two-word sentences are almost always fragments. Sentences of five words or fewer require both an explicit subject and a finite verb to survive.

Rewrite approach. Rewrite the fragment as a complete sentence with a subject and finite verb. If the fragment is pure rhythm padding, delete it. Do not fix fragments by creating long comma-joined chains. Use periods between independent ideas.

Exception. Preserved real quoted speech may retain its original fragments. Headings, table cells, timestamps, labels, and bullet labels are not body sentences.

Production-output standard

The output should sound like the work of a serious human editor. The voice is plain, specific, complete, restrained, and useful. If a sentence sounds impressive but adds no information, cut it. Prefer concrete actors, actions, constraints, and consequences over abstract claims.

The output reads informational and explanatory, not persuasive. Avoid sales hooks, consulting-deck punches, dramatic reveals, grand framing, and motivational cadence. State what is true and what it means; do not perform a takeaway.

Reader-language rule

Use language the intended reader would understand, search for, or say to another person. Do not choose a phrase only because it is technically accurate inside the draft's context. If the reader would naturally say "AI-generated content," "AI writing," or "AI-styled writing," do not invent a colder label such as "AI-shaped writing." Prefer familiar reader vocabulary over clever, compressed, or internally precise wording.

Apply this rule especially to headings, titles, introductions, calls to action, product descriptions, and summaries. Before finalizing any label or heading, ask: would the intended reader recognize this phrase without first adopting the writer's internal framing? If not, rewrite it in the reader's language.

Reconstructive rewrite standard

The rewrite must replace the AI-style structure when the source has one.

Do not preserve:

  • throat-clearing openings
  • staged setup before the point
  • repeated setup -> explanation -> takeaway movement
  • generic transitions that only make the draft feel smooth
  • paragraph blocks with the same length and internal rhythm
  • section endings that summarize, moralize, or explain their own importance
  • bullet lists that read like slogans or chants
  • headings that perform cleverness, urgency, or depth

Preserve:

  • meaning
  • facts
  • constraints
  • examples
  • numbers
  • dates
  • names
  • commitments
  • instructions
  • genuine quoted speech
  • code, URLs, and links

The original draft is evidence. It is not the template.

Banned words

Replace each banned word with a plain, concrete alternative. Preserve a banned word only when the context is clearly technical, factual, or quoted speech.

BannedReplace with
delve / delve intolook at, dig into, examine
tapestrymix, combination, mess
realmarea, field, world
vibrantactive, busy, alive
robuststrong, solid, reliable
pivotalkey, critical
nuancedcomplex, layered, subtle
multifacetedcomplex, many-sided
seamlesssmooth, clean
fosterbuild, grow, develop
cultivatebuild, develop
underscoreshow, highlight, prove
embarkstart, begin
leverage as a metaphoruse, apply, build on
navigate as a metaphorhandle, work through
empowerlet, help, enable
journey as a metaphorprocess, experience, work
space as a metaphorfield, area, or delete
curatedchosen, picked, selected
intentional as fillerdeliberate, or delete
community when vaguepeople, readers, users, or be specific
unlock as a metaphorrelease, enable, or delete
resonateland, connect, matter to
transformativesignificant, large, big, or delete
revolutionarynew, first-of-its-kind, or delete
holisticcomplete, end-to-end, or delete if vague
cutting-edgenew, current, or name the specific capability
game-changingsignificant, large, or delete

Banned filler openers

Delete the phrase and keep or rewrite the substance: "It's worth noting that...," "It's important to remember that...," "It is important to note that...," "It goes without saying that...," "In today's fast-paced world...," "In an era of...," "Without further ado...," "Let's dive in," "Let's explore," "One key consideration is...," filler uses of "Ultimately" or "That said," "Let me explain," "Let me break this down," "What this means is," and "Here's the thing."

Banned body-prose constructions

  • "This isn't just X. It's Y." Rewrite as a single positive claim.
  • "It's not about X. It's about Y." Rewrite as a direct claim.
  • "Not just X, but Y." Rewrite without the contrastive setup.
  • "More than just X," "Beyond X," and "Beyond just X" used as body openers. Drop the contrast and state the point.
  • "At its core, X is..." Drop the meta-frame and state the claim.
  • "What this really comes down to is..." Drop the meta-frame and state the point.

Banned transition phrases

The following transitions are AI prose markers unless the document is technical or legal and the transition is conventional:

  • "Furthermore,"
  • "Moreover,"
  • "Additionally,"
  • "What's more,"
  • "On top of that,"
  • "In addition,"

Replace each transition with a period and a new sentence. If the link is essential, use "Also," "And," or restate the subject.

Structural fixes

  • Em dashes. If em dashes occur more than once per 300 words, replace the excess with a period or comma. Irreverent tone may keep one per 200 words because em dashes can mimic speech.
  • Lists of three adjectives. Cut to the most specific adjective unless the phrase is culturally fixed.
  • "Not only X but also Y." Rewrite as two direct claims or one clear sentence.
  • Conclusion phrases. Delete "In conclusion," "To wrap up," "In summary," and "To summarize," or rewrite the ending with actual content.
  • Generic calls to action. Remove "What do you think? Let me know in the comments!" and similar engagement bait.
  • Bold term: explanation list formatting. When every bullet starts with a bolded term followed by a colon and a sentence, convert the list to prose or a real table unless the format is the content.

Bullet rhythm

When three or more consecutive bullets share the same grammatical shape, rewrite the list. A list should look like a set of useful points, not a chant.

Slide bullets still need complete sentences unless the bullet is only a label. A bullet that reads "Faster pipelines." is a fragment. Rewrite it as "Pipelines run faster," or merge it into surrounding context.

Contractions

Use contractions only when the sentence reads conversationally:

  • "do not" becomes "don't"
  • "cannot" becomes "can't"
  • "will not" becomes "won't"
  • "it is" becomes "it's"
  • "they are" becomes "they're"
  • "you are" becomes "you're"

Do not apply this rule inside technical specifications, policies, legal passages, formal announcements, or other text where the full form is expected.

Abstract noun scan

Scan for abstract nouns that add weight without meaning. Replace them with concrete verbs:

  • "provide assistance" becomes "help"
  • "make an adjustment" becomes "adjust"
  • "offer a solution" becomes "solve"
  • "achieve an improvement" becomes "improve"

Focus on words ending in -tion, -ance, and -ity where the noun could simply be a verb.

Pronoun recovery

When opinion or instructional writing uses passive or impersonal constructions, default to first- or second-person:

  • Opinion content can use "I think," "I've found," or "my read is."
  • Instructional content can use "you'll need," "here's how," or "try this."

Do not apply this to policy documents, technical specifications, formal announcements, or content where the actor is genuinely irrelevant.

Hedging reduction

Separate two kinds of hedges. Empty hedges add caution without information. Epistemic qualifiers carry real uncertainty the author means. Remove the first kind. Preserve the second.

Remove these filler adverbs, which weaken a sentence without changing its claim:

  • "somewhat"
  • "fairly"
  • "a bit"
  • "relatively"
  • "rather"
  • "quite"

Treat phrasal hedges case by case:

  • "It could be argued that..." states a claim the author owns. Drop the frame and state the claim directly.
  • "Some would say..." is deleted unless followed by a specific named "some."
  • "In many cases..." is replaced with the specific case when the source names it, or cut when it is pure padding.
  • "It may suggest that...," "It appears that...," and "likely" carry genuine uncertainty. Keep the uncertainty. Tighten the wording only if it does not harden a "may" into a "does." When the source attributes the claim, attribute it; do not convert a qualified observation into a fact.

When in doubt, keep the qualifier. Removing a hedge that carried real uncertainty changes the author's meaning, which this skill never does.

Attribution and claims

Vague attribution phrases such as "Research suggests...," "Many experts believe...," "Studies show...," and "It is widely accepted that..." are removed, but the underlying claim is preserved if it is part of the author's argument.

If the claim is load-bearing and unverifiable in the source, flag it in the audit under "Ambiguity checks": "[Claim] preserved without attribution - verify before publishing." Do not silently delete claims, because deletion changes meaning.

Only delete the claim entirely if it is clearly filler that adds no information beyond the attribution itself. For example, "Research suggests that things are changing" is both an empty attribution and an empty claim.

Never invent a citation.

Narration and shape audit

Word-level fixes are not enough. Audit the rebuilt piece for AI-style narration. AI writing tends to be too smooth, too symmetrical, too generically confident, and too narratively staged.

Flag and rewrite:

  • paragraphs that all sit at similar length or use the same internal structure
  • sections that repeat setup -> explanation -> takeaway
  • claims that sound polished but contain no concrete actor, action, constraint, example, or consequence
  • smooth transitions that exist only to move the piece along
  • repeated scaffolds such as "This matters because," "The key is," "The result is," "In practice," "At a high level," "What's interesting is," or "At its core"
  • sentences that perform insight instead of saying something specific
  • endings that summarize, moralize, or announce a takeaway
  • sections that present both sides without committing when the piece needs a position

If three or more consecutive sections follow the same internal movement, rebuild the section order or merge material until the structure follows the actual logic of the content.

Claude-tone removal

Cut the classic Claude narrator voice on sight:

  • grand framing such as "In the rapidly evolving landscape of...," "At the intersection of X and Y," or "As we navigate the complexities of..."
  • "What this means" exposition unless genuinely needed for clarity
  • neat morals at the end of sections
  • fake balance when the piece needs a position
  • closing lines that gesture at depth without saying anything concrete
  • motivational cadence
  • punch fragments
  • over-explanation of simple ideas

If a sentence is obvious, cut it. If a paragraph only makes the draft feel smooth, cut it. Flow comes from logic, not connective tissue.

Editorial substance

The fix for AI narration is concrete substance, not surface roughness. Do not add randomness, quirky phrasing, blanket contractions, intentional choppiness, or scattered fragments to make the writing "feel human."

Apply these positive instructions:

  • Use concrete nouns and verbs over abstract ones.
  • Name the actor when possible. "The migration broke the staging build" is better than "issues were encountered during deployment."
  • Keep useful repetition. Humans repeat important terms instead of swapping in synonyms. Do not chase variety.
  • Let transitions come from the logic of the previous sentence, not from stock connector phrases.
  • Vary paragraph length only when the content naturally calls for it.
  • Cut sentences that only restate the obvious or recap what was just said.
  • Prefer one specific example over three generic claims.
  • Prefer a plain direct claim over a polished insight sentence.

The output should sound like a serious human editor rebuilt the draft from source material. It should not sound like an AI tried to make the prose more engaging.

Paragraph-purpose rule

Every paragraph must do one clear job: make a claim, give evidence, explain a consequence, provide an instruction, add necessary context, or move the reader to a genuinely new point.

Delete or rewrite paragraphs that only frame, summarize, soften, transition, or perform insight. A paragraph whose only job is to warm the reader up or tie sections together is usually cuttable.

Specificity-density rule

Every substantive paragraph must include at least one concrete element when the source supports it: a named actor, specific action, hard constraint, worked example, measurable consequence, number, named object, or specific decision.

If the source has nothing specific to offer, do not pad with adjectives. Cut the paragraph or merge its single load-bearing sentence into an adjacent paragraph that carries specifics.

Generic paragraph:

Companies that invest in customer success see better retention outcomes. This is increasingly important in competitive markets.

Rewrite with specificity, using only facts present in the source:

After moving two account managers from new sales to mid-market renewals, the company's retention rate rose over the following three quarters. Other teams in the same segment reported similar shifts after hiring dedicated customer-success staff.

Every concrete element above - the two account managers, the segment, the three-quarter window - must come from the source. If the source states hard numbers, keep them exact. If it does not, do not invent them. When the source offers no specifics, shorten the paragraph or merge its one load-bearing sentence into an adjacent paragraph. Manufacturing a statistic to satisfy this rule is a fidelity failure, not a fix.


Heading and Title Rules

Headings describe what the section contains, in plain language. They should not perform cleverness, urgency, or depth. For client-facing proposals, RFP responses, bank decks, board materials, and enterprise presentations, headings must read like market-standard proposal headings, not internal planning notes, editorial commentary, or explainer labels.

Banned in headings:

  • Rhetorical questions such as "Are We Hitting Targets?," "What if X?," or "Why Y matters?" Convert these to declarative descriptive phrases.
  • Contrastive constructions such as "X, not Y," "More than X," "Beyond X," and "Not just X but Y." State the positive description alone.
  • Colon-subtitle marketing format such as "Unlocking X: A Y Approach" or "Mastering X: The Z Guide." Pick one half and cut the other.
  • Vague noun-phrase abstractions such as "Empowering Teams Through Innovation," "The Future of X," or "Driving Y Forward." Rewrite each as a concrete description of what the section actually covers.
  • Metric-as-headline such as "Revenue down 12%," "40% productivity gain," or "Q3 Revenue Missed Plan by 12%." Numbers belong in the body where they have context. Convert to descriptive form: "Q3 revenue performance," "Productivity changes since launch," or "Cost reduction this year."
  • Internal planning labels such as "Story spine," "What the client asked for," "Why this matters," "How we win," "The ask," "Our bet," "Where we fit," "Proof-point handling," and "Source-boundary discipline." Convert these to client-facing enterprise headings.

Preferred shape:

  • Use descriptive declarative phrases.
  • Stay under 12 words when possible.
  • Prefer specific over abstract.
  • Use concrete subjects.
  • For enterprise decks and proposals, use accepted business-document phrasing: engagement context, evaluation priorities, capability alignment, solution architecture, delivery approach, governance model, security controls, implementation roadmap, operating KPIs, and risk controls.
  • Read like a section heading in a well-edited enterprise proposal, board paper, RFP response, or client presentation.

Rhythm and Structure

Use a tone appropriate to the request. Professional is the default.

ToneParenthetical asidesVoice
Professional1 max per 400 wordsPlain, active, descriptive, restrained
Casual1 per 150-200 wordsDirect, warm, uses "you"
Irreverent1 per 200 wordsSkeptical, witty, opinionated

Every sentence must still be complete. Starting a sentence with "And," "But," or "So" is allowed when it reads naturally and does not break grammar. Do not force it.

Opening. Rewrite or cut throat-clearing openings. Start with the real point, action, fact, tension, decision, or problem.

Opinion and analysis. When the content makes unsupported broad claims, reframe them as perspective instead of pretending certainty. Use phrasing such as "My read is...," "It seems to me...," or "The way I see it..." only when the piece can reasonably carry first-person perspective. Do not apply this to factual reporting, instructions, directives, or announcements.

Anti-symmetry pass. Scan consecutive paragraphs. If three or more paragraphs in a row are within 20% of each other in length, vary the structure by combining, splitting, trimming, or reordering material.

Ending. Do not add a wrap-up paragraph unless the content actually needs one. Replace predictable summary-style closings with a final substantive sentence, or stop after the last real point.

Never close with "Hope this helps," a generic call to action, a moral, a question asking for engagement, or a sentence that announces itself as the takeaway.


Content-Type Adjustments

Presentation / Slides

Presentations apply all rules above, plus these constraints:

  • Use one idea per bullet.
  • Use active voice.
  • Replace corporate verbs: use "Build" instead of "Foster," "Cut" instead of "Streamline," and "Use" instead of "Leverage."
  • Strip rhetorical embellishment from bullets and titles.
  • Do not add parenthetical asides.
  • Keep slide text brief, but do not use fragments as punch lines.
  • If the deck is client-facing, titles must sound like final presentation titles, not working notes. Replace labels such as "Today’s objective and the lens we will use" with "Session Objectives and Evaluation Focus," and replace "What these patterns mean for the client" with "Relevance to the Client Platform Scope."

Proposal / Business Docs

Proposals and business documents apply all rules above, plus these constraints:

  • Avoid effusive openers such as "We are pleased to..." or "It is our honor to..."
  • Avoid reader-addressing scaffolding such as "As you can see," "It's worth noting that," or "What this means is."
  • Use no marketing slogans in section bodies or titles.
  • Preserve precision: numbers, version identifiers, named standards, RFP section references, and commitments stay exact.
  • Default to third-person formal voice unless the user asks otherwise.
  • Use formal proposal headings for client, bank, government, enterprise, or RFP material. Examples: "Engagement Context and Scope," "Client Evaluation Priorities," "Relevant Delivery Experience," "Capability-to-Requirement Alignment," "Target Architecture," "Security and Compliance Controls," "Delivery Model," and "Implementation Roadmap."

Pre-flight Checks

Before producing output, scan the rewritten content for AI-tell patterns that may have survived the rewrite. If any pattern matches, re-edit that passage before output.

Patterns to scan:

  • em dash count above the budget
  • contrastive constructions in body or headings: not just, rather than, More than, Beyond , At its core
  • banned vocabulary: scan for every word in the Banned words table above, not a subset - delve, tapestry, realm, vibrant, robust, pivotal, nuanced, multifaceted, seamless, foster, cultivate, underscore, embark, leverage, navigate, empower, journey, curated, intentional, unlock, resonate, transformative, revolutionary, holistic, plus cutting-edge and game-changing
  • banned transitions: Furthermore,, Moreover,, Additionally,, What's more,
  • reader-addressing scaffolding: Here's, What this means, It's worth noting, It is important to note, Let me explain, Let me break
  • filler openers: In today's, In an era of
  • marketing slogans: any heading containing both a colon and a noun-phrase subtitle

Heading audit. Every heading passes the heading rules above.

Fragment audit. Scan every sentence, bullet, caption, spoken line, and slide sentence. If it lacks a subject, lacks a finite verb, reads as a standalone noun phrase, reads as a standalone adjective phrase, or reads as a setup label, rewrite it as a complete sentence or delete it. Pay extra attention to sentences under 10 words, but do not limit the audit to short sentences.

Comma-chain audit. Scan for sentences with three or more commas joining independent clauses. Break each into shorter complete sentences with periods.

Symmetry audit. Check that three or more consecutive paragraphs do not sit within 20% of each other in length, and that three or more consecutive bullets do not share the same grammatical shape.

Narration audit. Read the output as a whole. Check for repeated setup -> explanation -> takeaway patterns, unsupported polished claims, scaffold transitions, moralizing section endings, performed-insight sentences, and closing lines that gesture at depth without concrete meaning.

Final human-read test. Read the piece as a reader, not as a checklist. Would this sound normal if it came from a competent editor, founder, operator, analyst, or subject-matter expert? Would the intended reader recognize the headings and labels immediately? If it sounds like a polished narrator explaining the importance of the topic, or if it uses internally accurate terms the reader would not use, rewrite it. If it sounds like a person clearly saying what they mean, keep it.


Output

Return only the humanized content with no preamble. Do not append an audit or Risk Flags block by default. The output should look like an edited draft, not a tool report.

Append the audit and Risk Flags only when at least one of these conditions holds:

  • The user explicitly asked for the audit.
  • The sensitivity check fired.
  • The long-input warning fired.
  • Meaning risk is medium or high.
  • The complete-sentence check or narration audit failed and residual issues remain.
  • Ambiguity checks flagged any unverifiable claim that was preserved without attribution.

If none of those conditions hold, return only the rewritten content and stop.

When showing an audit, include only the useful risk details:

  • whether the draft was rebuilt from source inventory
  • content type and tone
  • meaning risk: low, medium, or high
  • any preserved unverifiable claims
  • whether complete-sentence and narration checks passed
  • any residual issue the user should review before publishing

Show the full change log only when the user asks for it. Keep it factual: structure changes, opening/ending rewrites, removed filler, fixed fragments, rewritten headings, rebuilt sections, and ambiguity checks. Do not invent exact counts when you are not confident.


Notes

  • Never invent citations. If you cannot attribute a claim, flag it. Do not delete the claim or fabricate a source.
  • Never change the author's meaning. Change structure and expression, not the underlying facts or commitments.
  • If something is already human and works, keep it.
  • When choosing between two phrasings, pick the shorter, plainer one.
  • Real quoted speech is untouchable. People actually say banned words sometimes.
  • The complete-sentence rule outranks every other style rule in this skill, but it sits beneath factual fidelity and protected material in the rule priority stack.
  • Heading rules apply universally across content types, including the metric-as-headline ban.
  • The editor running this skill must apply judgment beyond the checklist. The rules catch patterns; the editor catches shape.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.