repurpose-medium

Medium Article Generator

Produce a long-form article, tag and publication suggestions, and crosspost note from the content atoms provided by the orchestrator.

Inputs

Received from the parent agent (repurpose-broadcast):

| Input | Description | |-------|-------------| | atoms | Full list of content atoms with types and impact ratings | | main_argument | One-sentence thesis of the source content | | target_audience | Who benefits from this content | | primary_topic | Category or niche | | voice_profile | Detected or overridden brand voice | | brief_mode | If true, produce title + subtitle + opening only (500 words) |

References

Load before generating:

• references/platform-specs.md -- Medium specs, article length targets, SEO weight
• references/hook-formulas.md -- title formulas, opening hooks, narrative structures
• references/voice-adaptation.md -- Medium tone rules (authoritative, conversational, storytelling)
• references/engagement-benchmarks.md -- read time targets, clap benchmarks

Platform Rules

| Spec | Value | |------|-------| | Article length | 1,500-3,000 words optimal (7-12 min read time) | | Title | 60 characters max (SEO-optimized, keyword-rich) | | Subtitle (kicker) | 140 characters max (expands on title, adds context) | | Tags | Exactly 5 (first tag = primary topic) | | Images | Inline, any aspect ratio, alt text REQUIRED | | SEO value | HIGH -- Google indexes Medium articles, often ranks in top results | | Paywall | Optional (recommend based on content depth and value) | | Publications | Curated collections that boost distribution significantly | | Reading time | Displayed prominently, affects click-through rate | | Best posting | Tuesday-Thursday 8-10 AM | | Formatting | Full markdown, pull quotes, code blocks, headers, images |

Core Principle

Medium is a PUBLICATION platform, not social media. Articles should feel like magazine pieces -- structured, edited, with a narrative arc. Google ranks Medium articles highly, so SEO matters in titles, headers, and first paragraphs. Write for depth, personality, and lasting value. Information dumps get skimmed; narrative gets read.

Output 1: Article

File: medium/article.md

Length: 1,500-3,000 words (7-12 min read time).

Article Structure

1. Title (60 chars max)
2. Keyword-rich for Google indexing
3. Curiosity-driven or value-driven (never clickbait)
4. Formulas:
5. "How [Specific Action] [Achieved Specific Result]"
6. "The [Adjective] Truth About [Topic] Nobody Talks About"
7. "[Number] Lessons From [Experience] That Changed How I [Outcome]"
8. "Why [Common Belief] Is Wrong (And What to Do Instead)"
9. Test: would you click this in Google search results?

1. Subtitle / Kicker (140 chars max)
2. Expands on the title -- adds context the title couldn't fit
3. Should answer "Why should I read this?" in one line
4. Include a secondary keyword if natural
5. Example title: "Why Most Content Strategies Fail"
6. Example subtitle: "And the simple framework that turned my 200-view posts into 20K-view articles"

1. Opening hook (2-3 sentences)
2. Set the stakes immediately -- why does this matter RIGHT NOW?
3. Options: start with a story, a surprising stat, or a bold claim
4. The first 2 sentences determine whether readers continue
5. Never open with a definition ("Content marketing is...")

1. Section 1: Context / Problem (300-500 words)
2. Why this topic matters now
3. Frame the gap: what most people get wrong or miss
4. Use insight and contrarian atoms to build tension
5. Include at least one specific example or data point
6. Header: descriptive H2, keyword-rich

1. Section 2: Core Insight (400-700 words)
2. The main argument with supporting evidence
3. This is the centerpiece -- spend the most words here
4. Use the highest-impact atoms
5. Include a pull quote (the single most quotable line, formatted as blockquote)
6. Header: H2 that reveals the insight

1. Section 3: Supporting Evidence (300-500 words)
2. Stats, case studies, examples drawn from atoms
3. If stat or casestudy atoms exist, expand them with context
4. Use subheadings (H3) if covering multiple supporting points
5. Specific numbers always beat vague claims

1. Section 4: Practical Application (300-500 words)
2. Actionable steps the reader can take today
3. Draw from howto and actionable atoms
4. Numbered steps or bulleted checklist format
5. Each step should be specific and measurable
6. Header: action-oriented H2 ("How to Apply This Today")

1. Closing (100-200 words)
2. Forward-looking statement or call-to-action
3. Do NOT summarize the whole article -- trust the reader
4. End with a thought-provoking line or a question
5. Optional: invite claps, follows, or responses

1. Pull quotes (2-3 throughout)
2. Formatted as blockquotes (> quote text)
3. Place one every 500-800 words for visual rhythm
4. Choose lines that work as standalone insights
5. These also serve as highlight-worthy text for Medium's highlight feature

SEO Optimization

• Title: primary keyword in first 3 words when possible
• First paragraph: include primary keyword naturally within first 100 words
• Headers (H2/H3): include secondary keywords
• Alt text: describe every image for accessibility and SEO
• Internal links: reference other Medium articles if relevant
• Meta description: subtitle serves as meta description on Google

Formatting Rules

• Short paragraphs (2-4 sentences max)
• Generous whitespace between sections
• Bold key phrases for scanners (2-3 per section)
• Use H2 for main sections, H3 for subsections
• Code blocks for any technical content
• Bulleted/numbered lists for actionable content
• Pull quotes for visual breaks and emphasis

Output 2: Tags + Publication Suggestions

File: medium/tags-publications.md

Tags (exactly 5)

| Position | Strategy | |----------|----------| | Tag 1 (primary) | Broadest relevant topic (highest search volume) | | Tag 2 | Specific niche within the topic | | Tag 3 | Audience-related tag (e.g., "Startup", "Self Improvement") | | Tag 4 | Format or methodology tag (e.g., "How To", "Case Study") | | Tag 5 | Trending or timely tag if applicable |

The first tag carries the most weight for Medium's distribution algorithm. Choose the broadest relevant topic with the highest search volume.

Publication Suggestions (2-3)

For each publication, provide:

| Field | Description | |-------|-------------| | Publication name | Official name as it appears on Medium | | Follower tier | Small (<10K), Medium (10K-100K), Large (100K+) | | Submission note | Key guidelines or requirements for submission | | Relevance | Why this content fits the publication's focus (1 sentence) |

Publication selection criteria:

1. Topic alignment -- the publication actively covers this subject
2. Size sweet spot -- medium publications (10K-100K) accept more submissions
3. Acceptance rate -- larger publications are more selective; suggest a mix
4. Audience overlap -- the publication's readership matches the target audience

Common publications by content type:

| Content Topic | Likely Publications | |---------------|---------------------| | Technology | Better Programming, Towards Data Science, The Startup | | Business | Better Marketing, The Startup, Entrepreneur's Handbook | | Productivity | Better Humans, Personal Growth, Mind Cafe | | Writing/Content | The Writing Cooperative, Better Marketing | | Design | UX Collective, Bootcamp, UX Planet | | AI/ML | Towards Data Science, Towards AI, AI in Plain English |

Output 3: Crosspost Note

File: medium/crosspost-note.md

Handle canonical URL attribution to protect SEO.

If content was originally published elsewhere:

• Include canonical URL import note: "Use Medium's Import tool (medium.com/p/import) to set the canonic