imMamdouhaboammar/writing-style-hack

Writing Style Hack — Universal Multi-Agent Writing Guide

Train and guide any AI agent (Claude Code, Google Antigravity, Gemini CLI, OpenAI Codex, Cursor, OpenCode) to write with an authentic human voice, compelling hooks, and platform-native formats.

---

⚡ Dynamic Skill Routing & Hierarchy

Always follow the two-tier skill hierarchy:

1. Foundational Copywriting Engine: Applies to ALL writing regardless of format.
2. Platform-Specific Overrides: Platform rules always supersede foundational rules when they conflict.

                    ┌─────────────────────────────────┐
                    │      Incoming User Prompt       │
                    └────────────────┬────────────────┘
                                     │
                                     ▼
                    ┌─────────────────────────────────┐
                    │  Foundational Copywriting Core  │
                    │   (Clarity, Specificity, Voice) │
                    └────────────────┬────────────────┘
                                     │
           ┌─────────────────────────┼─────────────────────────┐
           ▼                         ▼                         ▼
 ┌──────────────────┐      ┌──────────────────┐      ┌──────────────────┐
 │   Newsletters    │      │    X (Twitter)   │      │     LinkedIn     │
 │ Narrative hooks, │      │ 5 viral hook     │      │ B2B leadership,  │
 │ vulnerability &  │      │ formulas, short  │      │ announcements,   │
 │ section beats    │      │ vs long-form     │      │ hiring & insight │
 └─────────┬────────┘      └─────────┬────────┘      └─────────┬────────┘
           │                         │                         │
           └─────────────────────────┼─────────────────────────┘
                                     ▼
                           ┌──────────────────┐
                           │     YouTube      │
                           │ Outlines, 3 title│
                           │ & thumbnail sets │
                           └─────────┬────────┘
                                     │
                                     ▼
                    ┌─────────────────────────────────┐
                    │  Verified High-Converting Copy  │
                    └─────────────────────────────────┘

---

1. Foundational Copywriting Principles

Every piece of content must respect these 4 core tenets:

1. Clarity over Cleverness: If forced to choose between creative wordplay and crystal-clear understanding, choose clear every single time.
2. Benefits over Features: Focus on the tangible transformation or outcome for the reader, never mere capability descriptions.
3. Specificity over Vagueness: Concrete numbers, timeframes, and metrics beat abstract assertions. ("Saves 3 hours every week" beats "saves valuable time").
4. Customer Language over Corporate Jargon: Write the way smart practitioners speak over coffee. Banish buzzwords.

Prohibited Vocabulary & Buzzwords

• Never write: "utilize", "facilitate", "commence", "streamline", "optimize", "leverage", "synergy", "revolutionize", "game-changer", "delve", "tapestry", "testament".
• Replace with: "use", "help", "start", "improve", "cut", "show", "build".

Voice & Cadence Rules

• Active Voice: Write "We engineered this system" instead of "This system was engineered".
• Ruthless Trimming: Strip weak qualifiers ("very", "really", "just", "actually", "literally").
• Short Paragraphs: 1–3 sentences per paragraph maximum. Use single-sentence paragraphs to punctuate critical takeaways.
• CTA Formula: [Action Verb] + [What They Get] + [Qualifier].
  • ✅ Good: "Start My Free Trial", "Get the Complete Checklist", "Join 10,000+ Subscribers".
  • ❌ Bad: "Submit", "Click Here", "Learn More".

---

2. Platform-Specific Specialists

A. Newsletter Specialist (Newsletters/)

• Core File: Newsletters/newsletter-writer-skill.md
• Winning Examples: Newsletters/Successful Posts/
• Voice: Conversational, intimate, vulnerably authentic. Share honest doubts, failures, and personal anecdotes.
• Structural Blueprint:
  1. Opening Hook: Bold statement, personal pivot, or provocative setup.
  2. The Shift: Contrast the old way vs the new reality.
  3. What I Built / What I Found: Concrete evidence, screenshots, or metrics.
  4. The Lesson / Framework: Actionable step-by-step breakdown.
  5. The Invitation: Low-friction conversational call to action.

B. X / Twitter Specialist (X/)

• Core File: X/x-writer-skill.md
• Winning Examples: X/Successful Posts/
• Two Formats:
  • Short-Form: Hook (<280 chars) + value bullets + single punchy CTA.
  • Long-Form Breakdown: Deep-dive teardown with modular headers and step-by-step code/architecture.
• 5 Proven Hook Formulas:
  1. Pain Point: "Motion graphics were always the hardest part of making videos for me..."
  2. Contrarian: "I'm a Carnegie Mellon trained engineer, but I still chose to use Lovable to build this."
  3. Scale / Numbers: "I cut our spend by 98%." / "216x difference. Same app. Same demo. Different hook."
  4. "Wait, what?": "how is this legal" (Generated 10.2M views).
  5. Bold Claim: "The Swarm Has Arrived. This is the first time I've seen the architecture work in practice."

C. LinkedIn Specialist (Linkedin Successful Posts/)

• Core File: Linkedin Successful Posts/linkedin-writer-skill.md
• Winning Examples: Linkedin Successful Posts/Successful Posts/
• Audience: B2B executives, founders, hiring managers, and ambitious builders.
• 4 Proven Archetypes:
  1. Thought Leadership / Industry Shift: Challenge status quo with reasoned thesis.
  2. Product Announcement: Lead with customer transformation, followed by numbered feature-benefit pairs.
  3. Hiring & Scaling: Transparent constraints, exciting mission, real numbers.
  4. Behind-the-Scenes / "Show Your Work": Transparent operating lessons.
• Layout Rule: Double line-breaks between ideas for effortless mobile scanning.

D. YouTube Outline Specialist (Youtube posts/)

• Core File: Youtube posts/youtube-outline-skill.md
• Winning Examples: Youtube posts/Successful Scripts/
• Deliverables Required for Every Request:
  1. Video Outline: Hook (0:00-1:00) → Promise → Setup (1:00-3:00) → Core Content (80%) → Conclusion & Tease.
  2. 3 Click-Worthy Title Options: Varied hooks (intrigue, extreme outcome, contrarian).
  3. 3 Thumbnail Concepts: Visual descriptions pairing with the title options.

---

3. Step-by-Step Generation Workflow

When generating content under this skill:

1. Classify Platform: Determine if the output is Newsletter, X, LinkedIn, YouTube, or General Copy.
2. Select Archetype & Hook: Choose one of the verified hook formulas matching the topic.
3. Draft with Progressive Disclosure:
   • Deliver strongest value in the opening 20%.
   • Inject specific numbers, names, or real benchmarks.
   • Maintain conversational cadence (1–3 sentences per paragraph).
4. Enforce Formatting: Double spacing, scannable subheadings, punchy bullet points.
5. Quality Review Checklist:
   • No corporate buzzwords or AI filler phrases.
   • Benefits stated before features.
   • Actionable CTA present.
   • Tone calibrated to the target platform.