Skip to content

AgriciDaniel/claude-repurpose / skills/repurpose-medium

repurpose-medium

Verified

Generates Medium publication content from content atoms: long-form articles (1500-3000 words) with narrative arc, SEO-optimized titles and subtitles, tag and publication targeting, and canonical crosspost handling. Optimizes for Google indexing, read time, and publication submission. Sub-skill of the Content Repurposing Engine. Use when user says "medium", "medium article", "medium post", "medium story", or "repurpose for 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):

InputDescription
atomsFull list of content atoms with types and impact ratings
main_argumentOne-sentence thesis of the source content
target_audienceWho benefits from this content
primary_topicCategory or niche
voice_profileDetected or overridden brand voice
brief_modeIf 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

SpecValue
Article length1,500-3,000 words optimal (7-12 min read time)
Title60 characters max (SEO-optimized, keyword-rich)
Subtitle (kicker)140 characters max (expands on title, adds context)
TagsExactly 5 (first tag = primary topic)
ImagesInline, any aspect ratio, alt text REQUIRED
SEO valueHIGH -- Google indexes Medium articles, often ranks in top results
PaywallOptional (recommend based on content depth and value)
PublicationsCurated collections that boost distribution significantly
Reading timeDisplayed prominently, affects click-through rate
Best postingTuesday-Thursday 8-10 AM
FormattingFull 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)

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

    • Expands on the title -- adds context the title couldn't fit
    • Should answer "Why should I read this?" in one line
    • Include a secondary keyword if natural
    • Example title: "Why Most Content Strategies Fail"
    • Example subtitle: "And the simple framework that turned my 200-view posts into 20K-view articles"
  3. Opening hook (2-3 sentences)

    • Set the stakes immediately -- why does this matter RIGHT NOW?
    • Options: start with a story, a surprising stat, or a bold claim
    • The first 2 sentences determine whether readers continue
    • Never open with a definition ("Content marketing is...")
  4. Section 1: Context / Problem (300-500 words)

    • Why this topic matters now
    • Frame the gap: what most people get wrong or miss
    • Use insight and contrarian atoms to build tension
    • Include at least one specific example or data point
    • Header: descriptive H2, keyword-rich
  5. Section 2: Core Insight (400-700 words)

    • The main argument with supporting evidence
    • This is the centerpiece -- spend the most words here
    • Use the highest-impact atoms
    • Include a pull quote (the single most quotable line, formatted as blockquote)
    • Header: H2 that reveals the insight
  6. Section 3: Supporting Evidence (300-500 words)

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

    • Actionable steps the reader can take today
    • Draw from howto and actionable atoms
    • Numbered steps or bulleted checklist format
    • Each step should be specific and measurable
    • Header: action-oriented H2 ("How to Apply This Today")
  8. Closing (100-200 words)

    • Forward-looking statement or call-to-action
    • Do NOT summarize the whole article -- trust the reader
    • End with a thought-provoking line or a question
    • Optional: invite claps, follows, or responses
  9. Pull quotes (2-3 throughout)

    • Formatted as blockquotes (> quote text)
    • Place one every 500-800 words for visual rhythm
    • Choose lines that work as standalone insights
    • 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)

PositionStrategy
Tag 1 (primary)Broadest relevant topic (highest search volume)
Tag 2Specific niche within the topic
Tag 3Audience-related tag (e.g., "Startup", "Self Improvement")
Tag 4Format or methodology tag (e.g., "How To", "Case Study")
Tag 5Trending 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:

FieldDescription
Publication nameOfficial name as it appears on Medium
Follower tierSmall (<10K), Medium (10K-100K), Large (100K+)
Submission noteKey guidelines or requirements for submission
RelevanceWhy 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 TopicLikely Publications
TechnologyBetter Programming, Towards Data Science, The Startup
BusinessBetter Marketing, The Startup, Entrepreneur's Handbook
ProductivityBetter Humans, Personal Growth, Mind Cafe
Writing/ContentThe Writing Cooperative, Better Marketing
DesignUX Collective, Bootcamp, UX Planet
AI/MLTowards 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 canonical URL to [original source]"
  • Footer text: "Originally published at [source name + URL]"
  • Note: Medium's import tool automatically sets rel=canonical to avoid duplicate content penalties

If this is original content:

  • Note: "First published on Medium"
  • Suggest the user set up a custom domain or publication for branding
  • Optional: suggest crossposting TO their blog later with canonical pointing back to Medium

Crosspost Format

**Canonical source:** [Original URL or "Medium (original)"]
**Import method:** [Medium Import tool / Manual paste]
**Footer attribution:** [Text to include at bottom of article]
**SEO note:** [Canonical URL guidance]

Tone Rules

DoDo NOT
Write in first person ("I discovered", "In my experience")Use third person or passive voice
Tell stories and share genuine insightsWrite dry, encyclopedia-style content
Use conversational language with personalityUse academic jargon or corporate speak
Include specific numbers and evidenceMake vague, unsubstantiated claims
Build a narrative arc (tension, insight, resolution)Dump information in list format only
Use pull quotes for visual rhythmWrite unbroken walls of text
Acknowledge nuance and uncertaintySpeak in absolutes without evidence
Write headlines that work in Google searchWrite clickbait or misleading titles

Output Format

# [Article Title]
## [Subtitle / Kicker]

[Full article text with headers, pull quotes, and formatting]

---
**Reading time:** ~[X] min
**Tags:** [tag1], [tag2], [tag3], [tag4], [tag5]
**Suggested publications:** [publication1], [publication2]
**Paywall recommendation:** [Yes/No + reasoning]
**Best posting time:** Tuesday-Thursday 8-10 AM
**SEO notes:** [primary keyword, secondary keywords, title optimization]

Brief Mode

If --brief is active, produce only:

  • Title + subtitle
  • Opening 3 paragraphs (~500 words)
  • 5 tags
  • Skip full article, publication suggestions, and crosspost note

Error Handling

ConditionAction
Fewer than 5 atomsWrite shorter article (800-1,200 words); reduce to 3 sections
No stat or casestudy atomsUse narrative-driven structure; lean on insight and contrarian atoms
brief_mode is trueGenerate title + subtitle + opening only (500 words) + tags
Content too short for full articleFrame as a "thought piece" (800 words); note shorter read time
Promotional content detectedReframe as an insight story; strip product mentions, focus on lessons learned
Voice profile unclearDefault to conversational-authoritative; note in output header
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall