Initial commit

2025-11-30 08:50:11 +08:00
commit c4f83f0004
6 changed files with 677 additions and 0 deletions
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "article-title-optimizer",
+  "description": "Optimizes article titles for search engines.",
+  "version": "0.0.0-2025.11.28",
+  "author": {
+    "name": "Tim Green",
+    "email": "rawveg@gmail.com"
+  },
+  "skills": [
+    "./skills/article-title-optimizer"
+  ]
+}
--- a/README.md
+++ b/README.md
@@ -0,0 +1,3 @@
+# article-title-optimizer
+
+Optimizes article titles for search engines.
--- a/plugin.lock.json
+++ b/plugin.lock.json
@@ -0,0 +1,52 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:rawveg/skillsforge-marketplace:article-title-optimizer",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "0a94f11c417e5d72690ac8c80bcc6d0e0e179294",
+    "treeHash": "ee864bd784be4922963716afa8d772d2334e1af94c9b8dd6fb19552555f3fcd2",
+    "generatedAt": "2025-11-28T10:27:50.199767Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "article-title-optimizer",
+    "description": "Optimizes article titles for search engines."
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "bb05ce52777e9e55493eb9a280a715249e482e20714fed4b424023b1c275fa14"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "4f83991a3acd511b85c52ee3d3844d4fc14a12efef97dd1739c3d3bb1d6490dd"
+      },
+      {
+        "path": "skills/article-title-optimizer/plugin.json",
+        "sha256": "d855e3de823f2146018f59bcfe224fc45d32bbf9317aa17f314073d7442592b9"
+      },
+      {
+        "path": "skills/article-title-optimizer/SKILL.md",
+        "sha256": "1a6f17ca70ab7abb82e5f79cc7cfbbbd0e0cdd17a0ffc83c5c63cc6079574a3e"
+      },
+      {
+        "path": "skills/article-title-optimizer/references/title_best_practices.md",
+        "sha256": "1a8b3c295b1f385fb5868ab2153e4415b2b288afaed2d1ab13b52b6d7f393e55"
+      }
+    ],
+    "dirSha256": "ee864bd784be4922963716afa8d772d2334e1af94c9b8dd6fb19552555f3fcd2"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}
--- a/skills/article-title-optimizer/SKILL.md
+++ b/skills/article-title-optimizer/SKILL.md
@@ -0,0 +1,283 @@
+---
+name: article-title-optimizer
+description: This skill analyzes article content in-depth and generates optimized, marketable titles in the format 'Title: Subtitle' (10-12 words maximum). The skill should be used when users request title optimization, title generation, or title improvement for articles, blog posts, or written content. It generates 5 title candidates using proven formulas, evaluates them against success criteria (clickability, SEO, clarity, emotional impact, memorability, shareability), and replaces the article's title with the winning candidate.
+---
+
+# Article Title Optimizer
+
+## Overview
+
+This skill transforms article titles into marketable, attention-grabbing headlines that follow the `<Title>: <Subtitle>` format while maintaining accuracy and avoiding deception. The skill analyzes article content deeply, generates five diverse title candidates using proven copywriting formulas, evaluates each against weighted success criteria, and automatically replaces the original title with the optimal choice.
+
+## Workflow
+
+Follow this sequential process to optimize article titles:
+
+### Step 1: Read and Analyze the Article
+
+Read the article file provided by the user to understand:
+- **Core thesis or argument**: What is the main point or claim?
+- **Key findings or insights**: What are the most important takeaways?
+- **Primary audience**: Who is this written for? (Technical experts, general public, professionals, etc.)
+- **Emotional tone**: Is it serious, provocative, optimistic, cautionary, analytical?
+- **Main keywords**: What terms are central to the topic and likely search queries?
+- **Article type**: Technical/professional, general interest, news, opinion/commentary, how-to guide
+
+**Example analysis for a healthcare AI article:**
+- Core thesis: AI in radiology has transformative potential but faces serious challenges around bias, transparency, and equity
+- Key findings: AI systems show bias against underserved populations, black-box nature creates trust issues, most benefits accrue to wealthy institutions
+- Primary audience: Healthcare professionals, policymakers, tech-aware general readers
+- Emotional tone: Serious, cautionary, balanced
+- Main keywords: AI, radiology, bias, healthcare equity, transparency, trust
+- Article type: Long-form analysis/commentary on emerging technology
+
+### Step 2: Research Title Best Practices
+
+Before generating candidates, review `references/title_best_practices.md` which contains:
+- Proven title formulas (question, how-to, problem-solution, contrarian, etc.)
+- Success criteria and evaluation framework
+- Common pitfalls to avoid
+- Industry-specific considerations
+- Before/after examples
+
+If needed, use web search to research:
+- Current trends in article title writing for the specific industry
+- Successful titles in similar topic areas
+- SEO best practices for the article's subject matter
+- Audience preferences for the content type
+
+**Note**: Research should inform title generation but titles must remain authentic to the article content.
+
+### Step 3: Generate 5 Title Candidates
+
+Create five diverse title candidates using different formulas from the reference guide. Each title must:
+- Follow the `<Title>: <Subtitle>` format
+- Be 10-12 words maximum (total for both parts)
+- Accurately represent the article content
+- Use different approaches/formulas to provide variety
+- Avoid deception, clickbait, or misleading claims
+
+**CRITICAL CONSTRAINTS - All titles must comply:**
+1. **No AI-generated tropes**: Avoid obvious AI writing patterns, especially "Algorithm/Algorithmic/Algorithms", "Black-Box/Black Box", and clichéd phrasing like "The X Will See You Now", "Welcome to the Age of X", "The Rise of X"
+2. **No apostrophes**: Do not use apostrophes anywhere in the title (not "don't", "can't", "it's", "AI's", etc.)
+3. **No question marks in Title segment**: Question marks create visually awkward ?: combinations when rendered. Questions may be used in the Subtitle segment only, or rephrase as statements.
+
+**Example candidates for healthcare AI article:**
+
+1. **Statement Format**: "Medical AI and Trust: Why Bias Threatens Healthcare Equity"
+2. **Problem-Solution Format**: "Opaque AI in Healthcare: Why Explainability Matters Now"
+3. **Contrarian Format**: "AI Will Not Replace Radiologists: But Everything Changes"
+4. **Impact Format**: "When Medical AI Fails Minorities: The Data Representation Crisis"
+5. **Examination Format**: "Navigating Healthcare AI: Trust, Bias, and the Path Forward"
+
+### Step 4: Evaluate Each Candidate Against Success Criteria
+
+Score each title candidate (1-10 scale) across six weighted criteria:
+
+1. **Clickability (25% weight)**: Attention-grabbing power, curiosity gap, use of power words
+   - High: Creates strong curiosity, specific and compelling
+   - Low: Generic, boring, or too vague
+
+2. **SEO Effectiveness (20% weight)**: Search optimization and discoverability
+   - Keyword placement in first 3-5 words
+   - Length 50-60 characters ideal
+   - Natural language, not keyword-stuffed
+
+3. **Clarity/Informativeness (20% weight)**: How well title communicates content
+   - High: Reader knows exactly what to expect
+   - Low: Vague, confusing, or misleading
+
+4. **Emotional Impact (15% weight)**: Emotional resonance and engagement
+   - Curiosity, surprise, urgency, relevance to reader concerns
+
+5. **Memorability (10% weight)**: Likelihood to stick in mind
+   - Distinctive phrasing, rhythmic flow, concrete language
+
+6. **Social Shareability (10% weight)**: Likelihood to be shared
+   - Identity expression, conversation starter, platform fit
+
+**Example evaluation for Candidate 1:**
+- Clickability: 8/10 (trust and bias angle creates curiosity)
+- SEO: 8/10 (strong keywords "Medical AI", "Trust", "Bias" well-placed)
+- Clarity: 9/10 (very clear what article covers)
+- Emotional Impact: 7/10 (trust and equity concerns resonate)
+- Memorability: 7/10 (clear and direct phrasing)
+- Shareability: 8/10 (addresses question many people have about AI)
+- **Weighted Score**: (8×0.25) + (8×0.20) + (9×0.20) + (7×0.15) + (7×0.10) + (8×0.10) = **8.05**
+
+### Step 5: Analyze and Select the Winner
+
+After scoring all five candidates:
+
+1. **Calculate weighted scores** for each candidate
+2. **Identify top 2-3 performers** based on quantitative scores
+3. **Apply qualitative judgment** considering:
+   - Best fit for article tone and audience
+   - Authenticity to content
+   - No red flags (deception, offense, plagiarism)
+   - Overall "feel" when reading aloud
+
+4. **Select the winning title** that:
+   - Has the highest overall score OR
+   - Scores highly and best represents the article's unique angle
+   - Passes all ethical/quality checks
+
+**Example selection rationale:**
+"After evaluation, Candidate 2 ('Opaque AI in Healthcare: Why Explainability Matters Now') scores highest with 8.3/10. It combines strong clickability (the 'Opaque' descriptor is clear and evocative), excellent clarity about the core issue, and solid SEO with well-placed keywords. While Candidate 1 scored well on clarity and Candidate 5 had good structure, Candidate 2 provides the best balance across all criteria. It avoids AI-generated tropes like 'Black-Box' or 'Algorithm', uses fresh language, and authentically represents the article without relying on clichéd phrasing."
+
+### Step 6: Replace the Title in the Article
+
+Use the Edit tool to replace the article's current title and ensure that you:-
+- Find and replace the first H1 heading in the markdown file
+- Preserve all other content
+- Confirm successful replacement
+
+### Step 7: Present Results to User
+
+Provide the user with:
+1. **The winning title** and brief explanation of why it was chosen
+2. **All five candidates** with their scores (optional but recommended for transparency)
+3. **Confirmation** that the title has been replaced in the file
+4. **Key insights** from the evaluation (what made the winner stand out)
+
+**Example output format:**
+
+```
+✓ Article title optimized successfully!
+
+Winning Title (Score: 8.3/10):
+"Opaque AI in Healthcare: Why Explainability Matters Now"
+
+Why this title won:
+- Highest overall score across all criteria
+- Fresh "Opaque" descriptor avoids overused "Black-Box" trope
+- Clear communication of article scope (AI + healthcare + transparency)
+- Strong SEO with well-placed keywords
+- Excellent balance of curiosity and clarity
+- Avoids AI-generated tropes and clichéd phrasing
+
+All candidates evaluated:
+1. "Medical AI and Trust: Why Bias Threatens Healthcare Equity" (8.0/10)
+2. "Opaque AI in Healthcare: Why Explainability Matters Now" (8.3/10) ← WINNER
+3. "AI Will Not Replace Radiologists: But Everything Changes" (7.6/10)
+4. "When Medical AI Fails Minorities: The Data Representation Crisis" (7.9/10)
+5. "Navigating Healthcare AI: Trust, Bias, and the Path Forward" (7.7/10)
+
+The title has been updated in: /path/to/article.md
+```
+
+## Key Principles
+
+### Accuracy Over Attraction
+While the goal is creating marketable titles, accuracy is non-negotiable:
+- Never misrepresent article content
+- Avoid clickbait or deceptive techniques
+- Ensure promises in title are delivered in content
+- Be specific, not vague
+
+### Format Compliance
+All titles must follow `<Title>: <Subtitle>` structure with strict constraints:
+- **Title (main)**: Hook the reader, create curiosity
+- **Subtitle**: Clarify, provide context, set expectations
+- **Total length**: 10-12 words maximum
+- **Balance**: Neither part should dominate excessively
+
+**Mandatory Constraints:**
+1. **No AI-generated tropes**: Never use "Algorithm/Algorithmic/Algorithms", "Black-Box/Black Box", or clichéd AI-content phrasing like "The X Will See You Now", "Welcome to the Age of X", "The Rise of X", "X: A Game Changer"
+2. **No apostrophes**: Avoid contractions and possessives (use "do not" instead of "don't", "AI of the future" instead of "AI's future")
+3. **No question marks in Title segment**: Questions create awkward ?: visual combinations. Use questions only in Subtitle, or rephrase as statements
+
+### Diverse Candidate Generation
+Generate candidates using different formulas to ensure variety:
+- Question format (question must be in Subtitle segment only, or use statement form)
+- How-to format
+- Problem-solution format
+- Contrarian/provocative format
+- Future/trend format
+- Emotional hook format
+- Unexpected juxtaposition
+
+Avoid generating five variations of the same approach. Remember: all candidates must comply with the three mandatory constraints (no AI tropes, no apostrophes, no question marks in Title segment).
+
+### Evidence-Based Selection
+Base the winning title selection on:
+- **Quantitative scores** across six weighted criteria
+- **Qualitative judgment** about fit and authenticity
+- **Ethical checks** for deception, offense, or plagiarism
+- **Alignment** with article tone and target audience
+
+Document the reasoning for transparency.
+
+## Common Scenarios
+
+### Scenario 1: Technical Article for Expert Audience
+**User request**: "Optimize the title for this technical paper on neural network architectures"
+**Approach**:
+- Prioritize clarity and precision over clever wordplay
+- Use correct technical terminology
+- Emphasize novelty or practical benefit
+- Example: "Transformer Attention Mechanisms: Scaling Efficiency in Large Models"
+
+### Scenario 2: General Interest Article
+**User request**: "Make this article about climate change more engaging"
+**Approach**:
+- Avoid jargon, use accessible language
+- Emphasize human impact and relevance
+- Create emotional connection
+- Example: "Why Your City Will Flood: Climate Change Comes Home"
+
+### Scenario 3: How-To Guide
+**User request**: "Create a better title for this tutorial"
+**Approach**:
+- Use action-oriented language
+- Make the benefit clear
+- Be specific about what readers will learn
+- Example: "Master API Testing: Build Robust Tests in 30 Minutes"
+
+### Scenario 4: Opinion/Commentary
+**User request**: "This opinion piece needs a stronger title"
+**Approach**:
+- Signal the viewpoint clearly
+- Be provocative within reason
+- Create discussion-worthy angle
+- Example: "The Silicon Valley AI Ethics Problem: Why Self-Regulation Failed"
+
+## Troubleshooting
+
+### Issue: All Candidates Score Very Similarly
+**Solution**: Revisit generation step and create more diverse candidates using different formulas. Ensure variety in approach (question vs. statement, provocative vs. informative, etc.)
+
+### Issue: No Candidates Meet Quality Bar
+**Solution**: Return to article analysis. May have misunderstood core thesis or audience. Re-read article sections and regenerate candidates based on deeper understanding.
+
+### Issue: User Rejects Winning Title
+**Solution**: Ask for specific feedback about what doesn't work. Use that input to either:
+- Select the second-place candidate if it addresses concerns
+- Generate new candidates with adjusted focus
+- Revise winning title while maintaining structure
+
+### Issue: Title Length Exceeds 12 Words
+**Solution**: Edit for conciseness:
+- Remove filler words (very, really, actually, etc.)
+- Use more concise phrasing
+- Combine or eliminate redundant concepts
+- Ensure both title and subtitle are pulling weight
+
+## Resources
+
+### references/title_best_practices.md
+Comprehensive guide containing:
+- Proven title formulas with examples
+- Detailed success criteria and evaluation framework
+- Common pitfalls to avoid
+- Industry-specific considerations
+- Before/after transformation examples
+
+**When to reference**: Always review this before generating candidates to ensure adherence to best practices and proper use of formulas.
+
+### scripts/replace_title.py
+Python script that replaces the first H1 heading in a markdown file with the new optimized title.
+
+**Usage**: `python3 scripts/replace_title.py <article_path> "<new_title>"`
+
+**When to use**: After selecting the winning title in Step 6 to automatically update the article file.
--- a/skills/article-title-optimizer/plugin.json
+++ b/skills/article-title-optimizer/plugin.json
@@ -0,0 +1,15 @@
+{
+  "name": "article-title-optimizer",
+  "description": "Optimizes article titles for SEO.",
+  "version": "1.0.2",
+  "author": {
+    "name": "Tim Green",
+    "email": "rawveg@gmail.com"
+  },
+  "homepage": "https://github.com/rawveg/claude-skills-marketplace",
+  "repository": "https://github.com/rawveg/claude-skills-marketplace",
+  "license": "MIT",
+  "keywords": ["article-title-optimizer", "SEO", "Claude Code"],
+  "category": "productivity",
+  "strict": false
+}
--- a/skills/article-title-optimizer/references/title_best_practices.md
+++ b/skills/article-title-optimizer/references/title_best_practices.md
@@ -0,0 +1,312 @@
+# Article Title Best Practices
+
+This reference document provides comprehensive guidance on creating effective, marketable article titles that attract readers while maintaining integrity and accuracy.
+
+## Core Principles
+
+### 1. Length Guidelines
+- **Optimal length**: 6-12 words (50-70 characters)
+- **Maximum for SEO**: 60 characters (Google truncates beyond this in search results)
+- **Readability**: Shorter titles are easier to scan and remember
+- **Social media**: Twitter displays ~70 characters, so aim for this as absolute maximum
+
+### 2. Title-Subtitle Format
+The format `<Title>: <Subtitle>` provides structure and allows for both attention-grabbing and informative elements:
+- **Title (main)**: Hook the reader, create curiosity, emotional impact
+- **Subtitle**: Clarify, provide context, set expectations
+- **Balance**: Neither part should dominate; aim for roughly equal weight
+
+### 3. Clarity vs. Curiosity Balance
+- **Too clear**: Boring, no reason to click ("An Article About AI in Healthcare")
+- **Too vague**: Clickbait, loses trust ("You Will Not Believe What Happened Next")
+- **Sweet spot**: Intriguing yet informative ("The Hidden Bias in Medical AI")
+
+## MANDATORY CONSTRAINTS
+
+**ALL generated titles must comply with these three critical constraints:**
+
+### 1. No AI-Generated Tropes
+Avoid obvious AI writing patterns, clichéd phrasing, and overused terminology that signals robotic or formulaic content:
+- **NEVER use**: "Algorithm", "Algorithms", "Algorithmic", "Black-Box", "Black Box"
+- **AVOID**: Predictable AI-content patterns like "The X Will See You Now", "Welcome to the Age of X", "The Rise of X", "X: A Game Changer", "X is a Game Changer"
+- **Why**: These words and phrases have become clichéd markers of AI-generated content and reduce authenticity and reader engagement
+- **Instead**: Use fresh, specific language that authentically describes the actual content without relying on tech-writing clichés
+- **Examples**:
+  - ❌ "The Algorithm Will See You Now"
+  - ❌ "The Machine Will See You Now" (trope phrasing)
+  - ❌ "Black-Box AI in Healthcare"
+  - ✓ "Opaque AI in Healthcare: Why Explainability Matters Now"
+  - ❌ "When Algorithms Fail Minorities"
+  - ✓ "Medical AI Fails Minorities: The Data Representation Crisis"
+
+### 2. No Apostrophes
+Do not use apostrophes anywhere in the title for contractions or possessives:
+- **NEVER use**: "don't", "can't", "won't", "it's", "AI's", "doctor's", "reader's", etc.
+- **Why**: Apostrophes create visual clutter and complicate parsing
+- **Instead use**: Full forms or rephrase to avoid possessives
+- **Examples**:
+  - ❌ "Why AI Won't Replace Doctors"
+  - ✓ "Why AI Will Not Replace Doctors"
+  - ❌ "The Doctor's AI Dilemma"
+  - ✓ "The AI Dilemma for Doctors"
+  - ❌ "It's Time to Regulate AI"
+  - ✓ "The Time to Regulate AI"
+
+### 3. No Question Marks in Title Segment
+Question marks in the Title segment create visually awkward ?: combinations when rendered:
+- **NEVER use**: Question marks before the colon in Title segment
+- **Allowed**: Questions in the Subtitle segment (after the colon)
+- **Why**: The ?: punctuation combination is visually jarring and breaks reading flow
+- **Instead**: Use questions in Subtitle, or rephrase Title as statement
+- **Examples**:
+  - ❌ "Can AI Be Trusted?: The Bias Problem"
+  - ✓ "Medical AI and Trust: Can We Fix the Bias Problem"
+  - ✓ "The Trust Problem in Medical AI: Why Bias Matters"
+  - ❌ "Why Do Systems Fail?: Understanding Root Causes"
+  - ✓ "When Systems Fail: Why It Happens and How to Prevent It"
+
+**Validation Checklist:**
+Before finalizing any title, verify:
+- [ ] Does NOT contain "algorithm" or variants
+- [ ] Does NOT contain any apostrophes
+- [ ] Does NOT have question mark in Title segment (before colon)
+- [ ] Follows `<Title>: <Subtitle>` format
+- [ ] Is 10-12 words total maximum
+
+## Proven Title Formulas
+
+### Formula 1: Question Format
+- "[Statement]: Why Does [Problem] Happen"
+- Example: "Medical AI Fails Minorities: Why Data Representation Matters"
+- **Strengths**: Engages reader's curiosity, promises answers
+- **Use when**: Article explores causes or explanations
+- **Note**: Question must be in Subtitle segment to avoid awkward ?: combination
+
+### Formula 2: Number/List Format
+- "[Number] [Topic]: [Outcome/Benefit]"
+- Example: "5 Hidden Biases in AI: What Every Doctor Should Know"
+- **Strengths**: Specific, scannable, sets clear expectations
+- **Use when**: Article has discrete points or steps
+
+### Formula 3: Contrarian/Provocative Format
+- "[Common Belief] Is Wrong: [Reality]"
+- Example: "AI Will Replace Radiologists Is Wrong: Here Is Why"
+- **Strengths**: Challenges assumptions, creates cognitive dissonance
+- **Use when**: Article debunks myths or presents unexpected findings
+
+### Formula 4: How-To Format
+- "How to [Achieve Goal]: [Method/Approach]"
+- Example: "How to Detect AI Bias: A Guide for Radiologists"
+- **Strengths**: Practical, action-oriented, promises value
+- **Use when**: Article provides actionable advice
+
+### Formula 5: The Future/Trend Format
+- "The Future of [Topic]: [Key Insight]"
+- Example: "The Future of Medical Diagnosis: Human-AI Partnership"
+- **Strengths**: Forward-looking, authoritative, positions reader ahead of curve
+- **Use when**: Article explores emerging trends or predictions
+
+### Formula 6: Problem-Solution Format
+- "[Problem]: [Solution/Approach]"
+- Example: "Opaque AI in Medicine: The Push for Explainability"
+- **Strengths**: Clear value proposition, addresses reader pain points
+- **Use when**: Article presents solutions to known problems
+
+### Formula 7: Unexpected Juxtaposition
+- "[A] Meets [B]: [Outcome]"
+- Example: "When AI Meets Ethics: The Healthcare Dilemma"
+- **Strengths**: Creates intrigue through contrast
+- **Use when**: Article explores intersection of distinct concepts
+
+### Formula 8: Emotional Hook
+- "The [Emotion] Truth About [Topic]: [Insight]"
+- Example: "The Uncomfortable Truth About Medical AI: Widespread Bias"
+- **Strengths**: Emotional engagement, honesty signal
+- **Use when**: Article addresses difficult or controversial topics
+
+## Success Criteria & Evaluation Framework
+
+### 1. Clickability (Weight: 25%)
+**Measures**: Likelihood to grab attention and generate clicks
+- **High**: Creates curiosity gap, uses power words, specific numbers
+- **Medium**: Informative but not particularly compelling
+- **Low**: Generic, vague, or boring
+- **Power words**: Hidden, Secret, Proven, Ultimate, Essential, Critical, Surprising, Shocking (use sparingly)
+
+### 2. SEO Effectiveness (Weight: 20%)
+**Measures**: Search engine optimization and discoverability
+- **Keyword placement**: Primary keyword in first 3-5 words
+- **Length**: 50-60 characters ideal for search results
+- **Natural language**: Readable, not keyword-stuffed
+- **Search intent match**: Title matches what people actually search for
+
+### 3. Clarity/Informativeness (Weight: 20%)
+**Measures**: How well title communicates article content
+- **High**: Reader knows exactly what to expect
+- **Medium**: General idea but some ambiguity
+- **Low**: Vague, misleading, or confusing
+- **Test**: Can someone unfamiliar with the topic understand the subject?
+
+### 4. Emotional Impact (Weight: 15%)
+**Measures**: Emotional resonance and engagement
+- **Curiosity**: Creates information gap that compels reading
+- **Surprise**: Challenges assumptions or presents unexpected angles
+- **Urgency**: Suggests timely or critical information
+- **Relevance**: Connects to reader's concerns or interests
+
+### 5. Memorability (Weight: 10%)
+**Measures**: Likelihood to stick in reader's mind
+- **Distinctive**: Unique phrasing, not generic
+- **Rhythmic**: Flows well when read aloud
+- **Concrete**: Uses specific, vivid language over abstractions
+- **Punchy**: Short, impactful words over lengthy descriptions
+
+### 6. Social Shareability (Weight: 10%)
+**Measures**: Likelihood to be shared on social media
+- **Identity expression**: Sharing signals something about the sharer
+- **Conversation starter**: Likely to generate discussion
+- **Platform fit**: Works across Twitter, LinkedIn, Facebook
+- **Screenshot-worthy**: Looks good in social media cards
+
+## Common Pitfalls to Avoid
+
+### 1. Clickbait
+- **What it is**: Misleading or exaggerated titles that don't deliver on promise
+- **Why avoid**: Erodes trust, damages credibility, high bounce rates
+- **Examples**: "You Won't Believe...", "Doctors Hate This...", "One Weird Trick..."
+
+### 2. Keyword Stuffing
+- **What it is**: Cramming multiple keywords unnaturally
+- **Why avoid**: Hurts readability, looks spammy, SEO penalties
+- **Example**: "AI Medical Healthcare Diagnosis Technology Algorithm Machine Learning"
+
+### 3. Vagueness
+- **What it is**: Titles so general they could apply to thousands of articles
+- **Why avoid**: No differentiation, no reason to click
+- **Examples**: "Thoughts on AI", "Understanding Healthcare", "Technology and Medicine"
+
+### 4. Over-promising
+- **What it is**: Titles that promise more than article delivers
+- **Why avoid**: Reader disappointment, credibility loss
+- **Examples**: "The Complete Guide to AI" (for a 2000-word article), "Everything You Need to Know About..."
+
+### 5. Jargon Overload
+- **What it is**: Technical terms that alienate general audience
+- **Why avoid**: Limits reach, confuses readers, reduces engagement
+- **Example**: "Convolutional Neural Networks in Radiological Pathognomonic Feature Extraction"
+- **Better**: "How AI Learns to Spot Disease in Medical Images"
+
+### 6. Being Too Clever
+- **What it is**: Puns, wordplay, or references that obscure meaning
+- **Why avoid**: Doesn't translate across audiences, SEO issues, confusion
+- **Balance**: Clever is fine if it doesn't sacrifice clarity
+
+## Industry-Specific Considerations
+
+### Technical/Professional Articles
+- **Audience**: Experts want specificity and accuracy
+- **Approach**: Be precise, use correct terminology, highlight novelty
+- **Example**: "Explainable AI in Radiology: Bridging the Trust Gap"
+
+### General Interest/Popular Science
+- **Audience**: Lay readers need accessible language
+- **Approach**: Use analogies, avoid jargon, emphasize impact
+- **Example**: "AI Doctors and Trust: Can We Fix the Bias Problem"
+
+### News/Current Events
+- **Audience**: Want timely, relevant information
+- **Approach**: Emphasize newness, implications, urgency
+- **Example**: "New FDA Rules Change AI in Medicine: What to Know"
+
+### Opinion/Commentary
+- **Audience**: Seek perspectives and analysis
+- **Approach**: Signal viewpoint, be provocative (within reason)
+- **Example**: "AI Will Not Replace Radiologists: But They Should Worry"
+
+## Testing & Validation
+
+### A/B Testing Questions
+When choosing between title candidates, ask:
+1. **Thumb-stopping power**: Would this make me pause while scrolling?
+2. **Value proposition**: Is the benefit of reading clear?
+3. **Audience fit**: Does this speak to my target reader?
+4. **Authenticity**: Does this accurately represent the article?
+5. **Differentiation**: How does this stand out from similar articles?
+
+### Red Flags
+Reject titles that:
+- Are deceptive or misleading
+- Contain factual errors
+- Use offensive language
+- Perpetuate stereotypes
+- Are too similar to existing popular articles (plagiarism risk)
+
+## Examples: Before & After
+
+### Example 1: Technical Article
+**Before**: "A Comprehensive Analysis of Algorithmic Bias in Artificial Intelligence Systems Applied to Medical Imaging with Specific Focus on Radiological Diagnoses"
+- **Problems**: Way too long (21 words), jargon-heavy, no hook
+**After**: "Hidden Bias in Medical AI: How Systems Fail Minorities"
+- **Improvements**: Concise (8 words), accessible language, emotional hook, clear problem
+
+### Example 2: General Interest
+**Before**: "Things to Consider About AI"
+- **Problems**: Vague, generic, no value proposition
+**After**: "Medical AI and Racism: The Troubling Truth About Bias"
+- **Improvements**: Provocative topic, specific focus, emotional engagement, clear subject
+
+### Example 3: How-To Article
+**Before**: "Guide to Understanding AI in Healthcare Settings"
+- **Problems**: Generic, passive, no urgency
+**After**: "How Doctors Should Question AI: A Practical Guide"
+- **Improvements**: Specific audience, action-oriented, practical value
+
+### Example 4: News/Analysis
+**Before**: "New Developments in Medical Technology Regulation"
+- **Problems**: Boring, no specifics, no angle
+**After**: "New FDA AI Rules: What Changes for Patients and Doctors"
+- **Improvements**: Specific event, clear stakeholders, practical relevance
+
+## Recommended Workflow
+
+When generating article titles:
+
+1. **Analyze article content** deeply - identify:
+   - Core thesis/argument
+   - Key findings or insights
+   - Primary audience
+   - Emotional tone
+   - Main keywords
+
+2. **Generate diverse candidates** using different formulas:
+   - Question format
+   - How-to format
+   - Problem-solution format
+   - Contrarian format
+   - Future/trend format
+
+3. **Evaluate each candidate** against all six criteria:
+   - Clickability (25%)
+   - SEO effectiveness (20%)
+   - Clarity/informativeness (20%)
+   - Emotional impact (15%)
+   - Memorability (10%)
+   - Social shareability (10%)
+
+4. **Score systematically**:
+   - Rate each criterion 1-10
+   - Apply weights
+   - Calculate weighted average
+   - Consider qualitative factors
+
+5. **Select winner** based on:
+   - Highest overall score
+   - Best fit for article tone and audience
+   - Authentic representation of content
+   - No red flags or ethical concerns
+
+6. **Validate** by asking:
+   - Would I click this?
+   - Does it deliver on the promise?
+   - Will readers share it?
+   - Does it stand out?