✍️ Skill: humanizer-pro (v1.0.0)

Executive Summary

📋 The Conductor's Protocol

1. Draft Diagnostics: Identify "AI Smells" (uniform sentence length, generic phrasing, lack of specific examples).
2. Voice Calibration: Define the target persona, tone (Conversational, Professional, Provocative), and cultural context.
3. Sequential Activation:

   activate_skill(name="humanizer-pro")

   →

   activate_skill(name="marketing-expert")

   →

   activate_skill(name="docs-pro")

   .
4. Verification: Perform a "Read-Aloud" test and use advanced AI detectors to ensure the content feels authentic and original.

🛠️ Mandatory Protocols (2026 Standards)

1. Manual Lead-In (The Hook)

• Rule: Never use a raw AI-generated hook.
• Protocol: Start with a personal anecdote, a controversial opinion, or a highly specific data point that only a human expert would know.

2. Linguistic Pattern Breaking

• Rule: Avoid "Burstiness" and "Perplexity" uniformity.
• Protocol: Intentionally vary sentence lengths. Mix 5-word "punchy" sentences with 25-word "exploratory" sentences to create a human rhythm.

3. E-E-A-T Injection (The "I" Factor)

• Rule: Generic claims are forbidden.
• Protocol: Inject first-person perspective: "In my experience...", "When I audited the database...", "We found that...". Add screenshots, specific brand names, and niche references.

4. Empathy & Storytelling

• Rule: Don't just list features; solve a human problem.
• Protocol: Use the "Before-After-Bridge" framework to frame technical content within a relatable human narrative.

🚀 Show, Don't Just Tell (Implementation Patterns)

Robotic vs. Humanized (Refactoring)

Empathy-Led CTA

<!-- Instead of "Click here to buy" -->
**Stop wasting your weekends on manual documentation.** Join 500+ architects who reclaimed their Sundays by automating their C4 diagrams. [Start your free trial]

🛡️ The Do Not List (Anti-Patterns)

1. DO NOT use the word "Revolutionize", "Dive into", or "In the ever-evolving landscape". These are high-confidence AI markers.
2. DO NOT use perfectly balanced lists of 3. (Humans often use 2 or 4, or add an "And finally..." outlier).
3. DO NOT use "In conclusion" or "To summarize". Use "The Bottom Line" or "What this means for you".
4. DO NOT ignore cultural context. AI models are often "West-Centric" by default.
5. DO NOT hide your personality. If you're funny, be funny. If you're blunt, be blunt.

📂 Progressive Disclosure (Deep Dives)

• Linguistic Pattern Breaking: Burstiness, Perplexity, and Rhythm.
• E-E-A-T for Content Creators: Proving your expertise to humans and bots.
• Conversational Flow & Contractions: Writing like you talk.
• Storytelling for Technical Docs: Making READMEs engaging.

🛠️ Specialized Tools & Scripts

• scripts/burstiness-audit.py

  : Analyzes sentence length distribution to identify machine-like patterns.

• scripts/inject-eeat-placeholders.ts

  : Scans a draft and highlights areas where first-person experience or specific data is missing.

🎓 Learning Resources

• E-E-A-T Guidelines for 2026
• On Writing Well by William Zinsser
• The Art of Conversational Writing