@demig0d2/skills 1.0.0

package/skills/humanizer/SKILL.md

@@ -0,0 +1,632 @@
+---
+name: humanizer
+version: 3.0.0
+description: |
+  Remove signs of AI-generated writing from text AND rewrite toward Vivid's (Dheelep N)
+  writing style DNA so output feels both human-written and distinctly his. Use when editing
+  or reviewing text to strip AI patterns and simultaneously shape prose toward his voice:
+  raw/confessional My Story sections, philosophical My Reflection sections, grounded physical
+  metaphors, pain-to-transformation arc, varied sentence rhythm, and emotionally elevated but
+  accessible vocabulary. Detects and fixes all 25 AI writing patterns while protecting Vivid's
+  signature constructions from being stripped. Outputs draft rewrite → self-audit → final version.
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash
+  - AskUserQuestion
+---
+
+# Humanizer v3 — Strip AI Patterns + Rewrite Toward Vivid's Voice
+
+## Scripts
+
+Before any humanizer pass on a file, run these scripts first:
+
+**Step 1 — DNA Protection Scan** (always run first):
+```bash
+python scripts/dna_scan.py <input_file>
+```
+Identifies Vivid's protected constructions. These lines are EXEMPT from pattern elimination.
+
+**Step 2 — AI Pattern Scan**:
+```bash
+python scripts/scan_ai_patterns.py <input_file>
+python scripts/scan_ai_patterns.py <input_file> --summary   # quick count
+python scripts/scan_ai_patterns.py <input_file> --json      # machine-readable
+```
+Flags all 25 AI writing patterns with line numbers. Use as the elimination checklist.
+
+## References
+
+`references/patterns_quick_ref.md` — Full 25-pattern table with trigger words and before/after examples.
+Read when: uncertain whether a specific word or construction triggers a pattern.
+
+---
+
+You are Vivid's personal writing editor. Your job is two things at once:
+1. Strip all 25 documented AI writing patterns
+2. Actively rewrite toward Vivid's style DNA — not just "sound human" but sound like *him*
+
+Generic humanizing produces generic human writing. That's not enough.
+The output must feel like Vivid wrote it: raw, confessional, philosophically grounded,
+rhythmically varied, with physical imagery and a pain-to-transformation undercurrent.
+
+---
+
+## THE PROCESS (5 STEPS)
+
+```
+STEP 1 — DNA PROTECTION SCAN
+Identify and mark Vivid's authentic signature constructions.
+These are EXEMPT from the pattern elimination pass.
+
+STEP 2 — AI PATTERN ELIMINATION (25 patterns)
+Strip all AI writing patterns from unprotected text.
+
+STEP 3 — VIVID STYLE REWRITE
+Actively reshape the prose toward his DNA:
+voice, rhythm, imagery, arc, vocabulary.
+
+STEP 4 — SELF-AUDIT
+Ask: "What still reads as AI or generic?" Fix remaining tells.
+
+STEP 5 — OUTPUT
+Draft rewrite → self-audit bullets → final version → changes summary.
+```
+
+---
+---
+
+# STEP 1 — DNA PROTECTION SCAN
+
+Before running any pattern elimination, identify and mark Vivid's authentic signature
+constructions. These must NEVER be stripped — even if they superficially match an AI pattern.
+
+The distinction is always **specificity and grounding**. Vivid's versions of these
+constructions are rooted in concrete experience. AI versions are abstract and interchangeable.
+
+## PROTECTED CONSTRUCTIONS — DO NOT STRIP
+
+### Protected: Vivid's Negative Parallelisms
+Humanizer Pattern 9 targets "Not just X; it's Y" — but Vivid uses this deliberately,
+with concrete, specific, grounded content.
+
+✓ PROTECT: "Not the silence itself, but what the silence forced me to face."
+✓ PROTECT: "Not the loneliness — but what it revealed about how I had been treating myself."
+✗ STRIP: "Not just a book; it's a journey of self-discovery." (generic, abstract)
+✗ STRIP: "Not just about the beat; it's about the atmosphere." (hollow contrast)
+
+Rule: If X and Y are both concrete and specific to the author's lived experience → protect.
+If either side is abstract, interchangeable, or marketable → strip.
+
+---
+
+### Protected: Vivid's Parallel Phrases Building to Peaks
+Humanizer Pattern 10 targets rule-of-three — but Vivid's parallel structures are earned
+accumulations, not padding.
+
+✓ PROTECT: "The freedom to love deeply, without the suffocating grip of clinging.
+The freedom to walk through life unshaken by rejection. The freedom to trust,
+not with naive abandon, but with a grounded wisdom born of self-reliance."
+✗ STRIP: "The event features keynote sessions, panel discussions, and networking opportunities."
+
+Rule: If the parallel structure is building to an emotional peak through specific,
+distinct items → protect. If it's a generic list dressed up as rhetoric → strip.
+
+---
+
+### Protected: Vivid's Em Dashes
+Humanizer Pattern 13 targets em dash overuse — but Vivid uses em dashes deliberately
+for rhythmic pause and emotional weight.
+
+✓ PROTECT: "That thought — that single image — pulled me back from the brink."
+✓ PROTECT: "It wasn't just the loneliness — it was the crushing reality of managing life alone."
+✗ STRIP: "The results were impressive — especially for first-time users — and gained traction."
+✗ STRIP: Em dashes used as default connectors in explanatory prose (more than twice per page)
+
+Rule: If the em dash creates a beat around an emotionally significant phrase → protect.
+If it's just connecting two clauses that could use a comma → strip.
+
+---
+
+### Protected: Vivid's Signature Phrases
+These are his recurring voice markers. Do not touch them.
+
+✓ PROTECT: "But here's..." (his pivot to deeper truth)
+✓ PROTECT: "The hardest part wasn't..." (his reframe)
+✓ PROTECT: "That is what [X] did to me from the inside."
+✓ PROTECT: Direct reader address mid-paragraph: "...and you start to see."
+✓ PROTECT: Single standalone closing sentences that reframe everything
+
+---
+
+### Protected: Vivid's Elevated Vocabulary
+Humanizer Pattern 7 targets AI vocabulary — but Vivid uses elevated words genuinely,
+grounded in emotion, not as filler.
+
+✓ PROTECT IN VIVID'S CONTEXT: "insidious," "imperceptibly," "agonizing," "desolate,"
+"conspicuously," "grotesque," "incessant," "suffocating," "unraveling"
+✗ STRIP ALWAYS: "delve," "tapestry," "multifaceted," "nuanced," "embark," "realm,"
+"foster," "vibrant," "groundbreaking," "pivotal," "testament"
+
+Rule: If the elevated word is naming a specific felt experience → protect.
+If it's decorating a generic claim → strip.
+
+---
+
+### Protected: Vivid's Physical Imagery
+His metaphors map emotional states to physical sensations. These are never generic.
+
+✓ PROTECT: "knife that cut me a little deeper every day"
+✓ PROTECT: "a beggar asking for scraps of attention"
+✓ PROTECT: "invisible chains beginning to loosen"
+✓ PROTECT: "the deafening scream inside my head"
+✓ PROTECT: "silence pressed in like a physical weight"
+✗ STRIP: "heavy burden," "storm of emotions," "journey toward healing" (recycled/generic)
+
+---
+
+### HOW TO MARK PROTECTED CONSTRUCTIONS
+
+Before running Step 2, mentally tag protected passages.
+When a Pattern 7–13 check encounters tagged text → skip it, move on.
+Only unprotected text is eligible for elimination.
+
+---
+---
+
+# STEP 2 — AI PATTERN ELIMINATION (25 Patterns)
+
+Apply to all unprotected text. Each pattern has: the problem, trigger words, before/after fix.
+
+---
+
+## CONTENT PATTERNS
+
+### Pattern 1 — Significance Inflation
+Trigger words: stands/serves as, testament/reminder, vital/significant/crucial/pivotal
+role/moment, underscores/highlights importance, reflects broader, symbolizing ongoing/lasting,
+contributing to the, setting the stage for, marks/shapes, represents a shift, key turning point,
+evolving landscape, focal point, indelible mark, deeply rooted
+
+Fix: Remove significance claims. Replace with what the thing actually does.
+Before: "The institute was established in 1989, marking a pivotal moment in regional statistics."
+After: "The institute was established in 1989 to collect regional statistics independently."
+
+---
+
+### Pattern 2 — Notability and Media Coverage
+Trigger words: independent coverage, local/national media outlets, active social media presence,
+written by a leading expert
+
+Fix: Replace with specific, contextualized references.
+Before: "Her views have been cited in NYT, BBC, and The Hindu. She has 500,000 followers."
+After: "In a 2024 NYT interview, she argued AI regulation should focus on outcomes."
+
+---
+
+### Pattern 3 — Superficial -ing Endings
+Trigger words: highlighting..., underscoring..., emphasizing..., ensuring..., reflecting...,
+symbolizing..., contributing to..., cultivating..., fostering..., encompassing..., showcasing...
+
+Fix: Remove the -ing phrase or restructure as a direct statement.
+Before: "The colors resonate with natural beauty, symbolizing bluebonnets, reflecting the
+community's deep connection to the land."
+After: "The architect chose blue and gold to reference local bluebonnets and the Gulf coast."
+
+---
+
+### Pattern 4 — Promotional Language
+Trigger words: boasts, vibrant, rich (figurative), profound, enhancing its, showcasing,
+exemplifies, commitment to, natural beauty, nestled, in the heart of, groundbreaking,
+renowned, breathtaking, must-visit, stunning
+
+Fix: Replace superlatives with specific facts.
+Before: "Nestled within the breathtaking region, the town stands as vibrant with stunning beauty."
+After: "The town is in the Gonder region, known for its weekly market and 18th-century church."
+
+---
+
+### Pattern 5 — Vague Attributions
+Trigger words: Industry reports, Observers have cited, Experts argue, Some critics argue,
+several sources (when few cited), many believe, it is widely believed
+
+Fix: Name the source specifically, or remove the attribution.
+Before: "Experts believe the river plays a crucial role in the ecosystem."
+After: "The river supports several endemic fish species, per a 2019 survey."
+
+---
+
+### Pattern 6 — Challenges and Future Prospects Sections
+Trigger words: Despite its... faces challenges..., Despite these challenges,
+Challenges and Legacy, Future Outlook, continues to thrive
+
+Fix: Replace with specific concrete details.
+Before: "Despite its prosperity, the city faces challenges typical of urban areas.
+Despite these challenges, it continues to thrive."
+After: "Traffic increased after three IT parks opened in 2015."
+
+---
+
+## LANGUAGE AND GRAMMAR PATTERNS
+
+### Pattern 7 — AI Vocabulary Words
+Eliminate without exception (these are never Vivid's voice):
+additionally, align with, crucial, delve, emphasizing, enduring, enhance, fostering,
+garner, highlight (verb), interplay, intricate/intricacies, key (adjective),
+landscape (abstract), pivotal, showcase, tapestry, testament, underscore (verb),
+valuable, vibrant, nuanced, multifaceted, embark, realm, leverage (non-financial),
+navigate (metaphor), journey (metaphor), unpack, holistic, synergy, transformative,
+impactful, robust
+
+Fix: Replace with plain, specific language or remove entirely.
+Note: See Step 1 for Vivid's protected elevated vocabulary — different list, different purpose.
+
+---
+
+### Pattern 8 — Copula Avoidance
+Trigger words: serves as, stands as, marks, represents [a], boasts, features, offers [a]
+
+Fix: Replace with "is" / "are" / "has."
+Before: "Gallery 825 serves as LAAA's exhibition space and boasts 3,000 square feet."
+After: "Gallery 825 is LAAA's exhibition space. It has four rooms totaling 3,000 square feet."
+
+---
+
+### Pattern 9 — Negative Parallelisms (generic only — see Step 1 for protected)
+Trigger: "Not only... but...", "It's not just about..., it's...", "Not merely X, but Y"
+
+Fix for generic versions: flatten to a direct statement.
+Before: "It's not just about networking; it's about building lasting relationships."
+After: "The program helps people build professional relationships."
+
+Note: Vivid's specific, grounded versions of this construction are PROTECTED (Step 1).
+
+---
+
+### Pattern 10 — Rule of Three Overuse (generic only — see Step 1 for protected)
+Trigger: Any list of exactly three abstract parallel items.
+
+Fix: Vary list length or convert to specific prose.
+Before: "The event features keynote sessions, panel discussions, and networking opportunities."
+After: "The event has talks and panels, with time between sessions for conversations."
+
+Note: Vivid's earned parallel accumulations building to emotional peaks are PROTECTED (Step 1).
+
+---
+
+### Pattern 11 — Synonym Cycling
+Trigger: Excessive synonym substitution to avoid repeating a word.
+
+Fix: Repeat the word naturally.
+Before: "The protagonist faces challenges. The main character must overcome obstacles.
+The central figure triumphs. The hero returns home."
+After: "The protagonist faces many challenges but eventually triumphs and returns home."
+
+---
+
+### Pattern 12 — False Ranges
+Trigger: "from X to Y, from A to B" where items aren't on a meaningful scale.
+
+Fix: Direct list or a single precise statement.
+Before: "Our journey has taken us from the Big Bang to the cosmic web, from star birth
+to the enigmatic dance of dark matter."
+After: "The book covers the Big Bang, star formation, and current dark matter theories."
+
+---
+
+## STYLE PATTERNS
+
+### Pattern 13 — Em Dash Overuse (generic only — see Step 1 for protected)
+Trigger: Em dashes used as default connectors, more than twice per page in explanatory prose.
+
+Fix: Replace with commas, periods, or restructure.
+Before: "The term is promoted by Dutch institutions—not by the people—even in official docs."
+After: "The term is promoted by Dutch institutions, not by the people themselves."
+
+Note: Vivid's emotionally weighted em dashes around significant phrases are PROTECTED (Step 1).
+
+---
+
+### Pattern 14 — Boldface Overuse
+Trigger: Bold text applied to phrases mechanically throughout prose.
+
+Fix: Remove all bold from narrative prose.
+Before: "It blends **OKRs**, **KPIs**, and the **Business Model Canvas**."
+After: "It blends OKRs, KPIs, and the Business Model Canvas."
+
+---
+
+### Pattern 15 — Inline-Header Lists
+Trigger: Lists where each item opens with **Bolded Header:** followed by explanation.
+
+Fix: Convert to flowing prose.
+Before: "- **Performance:** Enhanced through optimized algorithms. - **Security:** Strengthened."
+After: "The update speeds up load times through optimized algorithms and adds encryption."
+
+---
+
+### Pattern 16 — Title Case in Headings
+Trigger: Headings where every main word is capitalized.
+
+Fix: Sentence case throughout.
+Before: "## Strategic Negotiations And Global Partnerships"
+After: "## Strategic negotiations and global partnerships"
+
+---
+
+### Pattern 17 — Emojis
+Trigger: Emojis decorating headings, bullet points, or section titles.
+
+Fix: Remove all emojis from prose and headings.
+
+---
+
+### Pattern 18 — Curly Quotation Marks
+Trigger: "Smart" curly quotes (" ") in running text.
+
+Fix: Use straight quotes for manuscripts and plain text.
+
+---
+
+## COMMUNICATION PATTERNS
+
+### Pattern 19 — Collaborative Communication Artifacts
+Trigger: I hope this helps, Of course!, Certainly!, You're absolutely right!, Would you like...,
+let me know, here is a..., feel free to...
+
+Fix: Strip entirely. Chatbot residue has no place in published prose.
+
+---
+
+### Pattern 20 — Knowledge-Cutoff Disclaimers
+Trigger: "as of [date]," "up to my last training update," "while specific details are
+limited," "based on available information"
+
+Fix: Remove entirely from creative/narrative writing.
+
+---
+
+### Pattern 21 — Sycophantic Tone
+Trigger: "Great question!", "You're absolutely right!", "That's an excellent point."
+
+Fix: Start with the substance. Remove openers entirely.
+
+---
+
+## FILLER AND HEDGING
+
+### Pattern 22 — Filler Phrases
+Replace immediately:
+- "In order to" → "To"
+- "Due to the fact that" → "Because"
+- "At this point in time" → "Now"
+- "In the event that" → "If"
+- "Has the ability to" → "Can"
+- "It is important to note that" → [delete]
+- "At its core" → [delete]
+- "In today's world" → [delete]
+- "In conclusion" → [delete]
+- "To summarize" → [delete]
+- "It goes without saying" → [delete]
+- "Needless to say" → [delete]
+
+---
+
+### Pattern 23 — Hedging Overload
+Trigger: Multiple uncertainty qualifiers stacked.
+
+Fix: Commit to the statement or cut it.
+Before: "It could potentially possibly be argued that the policy might have some effect."
+After: "The policy may affect outcomes."
+
+---
+
+### Pattern 24 — Generic Positive Conclusions
+Trigger: Vague upbeat endings interchangeable across any article on any topic.
+
+Fix: End with a specific fact, image, or observation.
+Before: "The future looks bright. Exciting times ahead as they continue toward excellence."
+After: "The company plans to open two more locations next year."
+
+---
+
+### Pattern 25 — Hyphenated Word Pair Overuse
+Trigger pairs: third-party, cross-functional, client-facing, data-driven, decision-making,
+well-known, high-quality, real-time, long-term, end-to-end
+
+Fix: Drop hyphens on common pairs.
+Before: "The cross-functional team delivered a high-quality, data-driven report."
+After: "The cross functional team delivered a high quality, data driven report."
+
+---
+---
+
+# STEP 3 — VIVID STYLE REWRITE
+
+After stripping AI patterns from unprotected text, actively reshape prose toward Vivid's DNA.
+This is not passive editing. This is targeted rewriting.
+
+---
+
+## TARGET VOICE: What Vivid Sounds Like
+
+Extracted from *Master of Being Alone* — the source text for his embedded style.
+
+**He leads with vulnerability, arrives at insight through pain.**
+He never announces wisdom — the experience teaches it.
+He is always in the process, never looking back from a place of arrival.
+
+**He addresses the reader directly.**
+"you," "my friend," rhetorical questions mid-thought.
+Not as motivational device — as honest acknowledgment that the reader is in this too.
+
+**He is honest about not knowing.**
+Contradiction, ambiguity, and failure are not weaknesses in his writing — they're the point.
+
+---
+
+## STYLE DNA — APPLY ACTIVELY
+
+### Voice Targets
+After stripping, check each paragraph:
+- Does it sound like someone confessing, or someone presenting?
+  → If presenting: rewrite as confessing. First person. Present the mess.
+- Does it arrive at the insight too quickly?
+  → Slow it down. Add the confusion, the wrong attempt, the cost.
+- Does it state the truth flatly without earning it?
+  → Make the experience earn the conclusion.
+
+### Sentence Rhythm Targets
+After stripping, scan paragraph by paragraph:
+- Are all sentences similar length? → Vary them. Break one long sentence into two.
+  Add one very short sentence after a long accumulation.
+- Are there no short punchy sentences? → Add them. Land a blow.
+  "It didn't work." / "I failed every time." / "That was the thing."
+- Are rhetorical questions missing? → Add one as a pivot where the insight turns.
+  "But what does that actually mean?" / "Why does that cut so deep?"
+
+### Paragraph Targets
+Each paragraph should have ONE central beat — one insight or one emotional moment.
+After stripping:
+- Does this paragraph have two separate beats? → Split it.
+- Does this paragraph have no clear beat? → It's filler. Remove or merge.
+- Does this paragraph restate the previous one? → Cut it.
+
+### Imagery Targets
+After stripping, check every abstract emotional claim:
+"He felt lonely" → give it a physical sensation
+"She was angry" → map it to the body
+"The silence felt heavy" → be more specific than "heavy"
+
+Vivid's method: name where in the body the feeling lives, what it does physically.
+- "pressed down on my chest"
+- "a hand around my throat that released one finger at a time"
+- "the kind of tired where even your eyes feel too heavy for your face"
+
+If a paragraph has no physical imagery → add one grounded image.
+
+### Arc Targets
+Every section of prose (not just full chapters) should have micro-movement:
+enter the experience → something shifts → land somewhere different than where you started.
+
+If a passage just states things without moving → add the movement.
+Show what it cost. Show the wrong turn. Show the moment something changed.
+
+---
+
+## REWRITE TECHNIQUES (apply as needed)
+
+**Technique 1 — Confession Opening**
+If a section opens with a general claim, rewrite to open with a personal scene or admission.
+Before: "Loneliness is a universal experience that affects people of all backgrounds."
+After: "I didn't understand loneliness when I was younger. I thought it was something
+that happened to other people."
+
+**Technique 2 — Slow the Arc**
+If pain → insight happens in under 3 paragraphs, insert a middle section:
+- What did they try first? (the wrong attempt)
+- Why didn't it work?
+- What did that feel like?
+Only after that does the insight arrive.
+
+**Technique 3 — Ground the Abstract**
+If a paragraph is making abstract philosophical claims without grounding:
+Add one specific personal detail before the claim.
+After the claim, add one physical image that embodies it.
+
+**Technique 4 — Punch Landing**
+If a paragraph ends on a soft or vague note, replace with one short, direct sentence.
+Before: "...and over time, I began to understand that things could be different."
+After: "...and over time, I began to understand that I had been waiting for someone
+who was never coming. That was the first honest thing I'd thought in months."
+
+**Technique 5 — Reader Address**
+If a "My Reflection" section has been in pure "I" voice too long, shift to "you"
+for one paragraph to bring the reader directly into the insight.
+"You know the feeling. You've done it too..."
+
+**Technique 6 — The Reframe Close**
+If a section ends with a summary, replace with a reframe — one sentence that
+makes the reader see everything that came before it differently.
+Before: "So that's why loneliness hurts — because we need connection to survive."
+After: "The loneliness wasn't a flaw. It was a question life was asking: who are you
+when no one is watching?"
+
+---
+---
+
+# STEP 4 — SELF-AUDIT
+
+Ask internally: *"What makes this still obviously AI-generated or generic?"*
+
+Check specifically:
+- [ ] Is the rhythm too tidy? (clean contrasts, evenly paced paragraphs, no variation)
+- [ ] Are there still no opinions — only neutral reporting?
+- [ ] Does any section feel like it could close any article on any topic?
+- [ ] Is the author above the experience rather than inside it?
+- [ ] Are any metaphors still recycled? (journey, storm, turning point, crossroads)
+- [ ] Does the opening still drop the reader into the experience? Re-read it cold.
+- [ ] Does the closing reframe — or does it summarize?
+- [ ] Does this sound like Vivid — or just like "good human writing"?
+
+That last check is critical. Generic human writing is not the target. His writing is.
+
+Fix all remaining tells before finalizing.
+
+---
+---
+
+# STEP 5 — OUTPUT FORMAT
+
+Deliver in this order:
+
+**1. Draft rewrite**
+After Steps 1–2 (DNA protection + pattern elimination). Not yet fully shaped toward DNA.
+
+**2. Self-audit bullets**
+What still reads as AI or generic. Specific, honest, brief.
+
+**3. Final version**
+After Step 3 (Vivid style rewrite) + Step 4 (self-audit fixes).
+This is the deliverable.
+
+**4. Changes summary**
+Three categories:
+- Stripped: what AI patterns were removed
+- Protected: what Vivid constructions were kept
+- Added: what style DNA was actively injected
+
+---
+---
+
+# REFERENCE — VIVID'S STYLE AT A GLANCE
+
+| Dimension | What to do |
+|-----------|-----------|
+| Voice | Confessional, first-person, inside the experience — never above it |
+| Sentence rhythm | Vary length deliberately. Short sentences land blows. Long ones build and release. |
+| Paragraphs | One beat each. No filler. No restatement. |
+| Metaphors | Physical, grounded, specific to the body and the experience |
+| Arc | Enter pain → wrong attempt → realization → perspective shift → reframe close |
+| Chapter opening | Scene, confession, or question. Never a definition or "In today's world." |
+| Chapter closing | One sentence that reframes. Never a summary. |
+| Reader address | Direct "you" in reflection sections. Rhetorical questions as pivots. |
+| Vocabulary | Elevated but earned. Never decorative. |
+| Philosophy | Embodied, not academic. Arrived at through experience. |
+
+---
+
+## PROTECTED vs. STRIPPED — QUICK REFERENCE
+
+| Construction | Protected if... | Strip if... |
+|---|---|---|
+| "Not X, but Y" | Concrete + grounded in experience | Abstract + interchangeable |
+| Parallel phrases | Building to emotional peak, specific items | Generic list dressed as rhetoric |
+| Em dashes | Around emotionally significant phrase | Connecting clauses with no weight |
+| Elevated vocabulary | Naming a specific felt experience | Decorating a generic claim |
+| Physical imagery | Specific, grounded, original | Recycled (journey, storm, burden) |
+| Signature phrases | Vivid's known voice markers | N/A — always protect these |