"Create a Medium article
Topic: [topic]
Target audience: [audience]
Length: [5-10 min read]
Tags: [tag1, tag2, tag3]"
SEO Optimization
text
"Optimize Medium article for [keyword]"
"Generate 5 headline candidates"
"Suggest tags for maximum reach"
Publication Submission
text
"Submit [article] to [Publication name]"
"List popular Tech Publications"
"Draft a pitch email for [Publication]"
Content Repurposing
text
"Convert this [blog post / Twitter thread / YouTube script] into a Medium article"
"Break this long article into a 3-part series"
"Create a listicle version of this tutorial"
Engagement Boosting
text
"Write a compelling hook for this article"
"Add storytelling elements to this technical post"
"Create a strong CTA for the conclusion"
"Suggest 3 subheadings that improve scannability"
Analytics & Performance
text
"Analyze why this article underperformed"
"Suggest improvements for [article URL] based on engagement data"
"What's the ideal posting time for [topic]?"
📐 Article Structure
Ideal Format
text
Title (SEO + Curiosity-driven)
Subtitle (Clear benefit statement)
Featured Image (custom or high-quality stock)
---
## Introduction (Hook) — 100-150 words
- Problem statement / Empathy / Personal story
- Value proposition for the reader
- Article overview (what they'll learn)
## Main Content Sections — 800-1,500 words
### H2 Heading 1
- Paragraph (3-4 sentences)
- Bullet points / Lists
- Code blocks (when applicable)
- Quotes / Statistics / Data visualizations
### H2 Heading 2
- Real-world examples
- Screenshots / Diagrams
- Step-by-step instructions
### H2 Heading 3
...
## Conclusion — 100-200 words
- Key points summary (3-5 takeaways)
- Personal reflection or opinion
- CTA (Follow / Clap / Comment request)
---
Related Article Links (2-3 of your own articles)
Optimal Article Length
Type
Words
Read Time
Best For
Short-form
500–800
2-3 min
Quick tips, opinions
Standard
1,000–1,500
5-7 min
Tutorials, how-tos
Long-form
2,000–3,000
8-12 min
In-depth guides, analysis
Deep dive
3,000+
12+ min
Comprehensive research
Sweet spot: 1,000–1,800 words (5-7 min read) — best engagement-to-effort ratio.
Headline Formulas
Number + Benefit
"7 Python Tricks That Will Make You Code 10x Faster"
"5 Morning Habits That Changed My Life (Backed by Science)"
How To
"How I Made $10,000 on Medium in 3 Months (Step-by-Step)"
"How to Learn Any Programming Language in 30 Days"
List Format
"The Only 3 Books You Need to Read About AI"
"10 Things I Wish I Knew Before Becoming a Developer"
Contrarian / Controversial
"Why I Stopped Using React (And What I Use Instead)"
"The Productivity Advice You Should Ignore"
Personal Story
"I Quit My $150K Job to Write on Medium — Here's What Happened"
"What 500 Days of Writing Taught Me About Success"
Question Format
"Is Python Really the Best Language for Data Science?"
"Why Do So Many Developers Burn Out?"
Publication Strategy
Popular Publications
Publication
Followers
Genre
Towards Data Science
700k+
Data / AI
Better Programming
200k+
Code
The Startup
800k+
Business
Better Marketing
100k+
Marketing
UX Collective
400k+
Design / UX
JavaScript in Plain English
200k+
JavaScript
Level Up Coding
300k+
Programming
The Writing Cooperative
150k+
Writing
Submission Tips
Read the publication's guidelines thoroughly
Analyze the tone and style of existing articles
Start with shorter articles for the first submission
Build a relationship with editors
Follow the publication's formatting requirements
Include proper attribution for images and data
SEO Optimization
Keyword Placement
Title (required — include primary keyword)
Subtitle (secondary keyword or benefit)
First 100 words (natural keyword inclusion)
H2 headings (related keywords)
Image alt text (descriptive, keyword-rich)
Tags (select 3–5 relevant tags)
Internal & External Links
Link to your own past articles (keeps readers on your profile)
Add a "Related Articles" section at the end
Connect series articles with navigation links
Include 1–2 authoritative external sources for credibility
Medium-Specific SEO
Medium articles rank well on Google — optimize for search intent
Use the canonical link feature if cross-posting from your blog
Kicker (the small text above your title) improves click-through rate
Choose a custom URL slug — keep it short and keyword-focused
Monetization Tactics
Direct Revenue
Partner Program earnings — read-time based income from member reads
Referred memberships — earn a portion when readers sign up via your link
Boost nominations — boosted articles get significantly more distribution
Indirect Revenue
Build an email list — convert Medium readers to newsletter subscribers
Affiliate links — include relevant product/tool recommendations (disclose!)
Freelance leads — use articles as a portfolio to attract clients
Course / product launches — warm up audience through free content
Consulting — establish expertise in a niche and offer consulting services
Growth Strategy
Early Stage (0–100 followers)
2–3 articles per week
Comment genuinely on other articles
Share on social media (Twitter/X, LinkedIn, Reddit)
Submit to Publications
Engage with other writers in your niche
Use all 5 available tags per article
Mid Stage (100–1,000 followers)
1–2 articles per week (focus on quality over quantity)
Build an email list (link in bio + article CTAs)
Create series articles (keeps readers coming back)
Cross-promote with other writers
Experiment with different formats (listicles, tutorials, opinion pieces)
Track analytics and double down on what works
Mature Stage (1,000+ followers)
Maintain a consistent publishing schedule
Build a community (respond to every comment)
Experiment with member-only (paid) articles
Expand to external platforms (Substack, personal blog)
Create a content calendar
Mentor newer writers (builds goodwill and network)
Diversify income streams beyond Medium
Advanced Tips
Writing Habits
Write every day, even if you don't publish
Draft in Google Docs or Notion, then import to Medium
Use the 30-30-40 rule: 30% research, 30% writing, 40% editing
Read top-performing articles in your niche for inspiration
Engagement Hacks
End with a question to encourage comments
Use bold text and short paragraphs for scannability
Include at least 1 image per 300 words
Add pull quotes or callout boxes for key insights
Use numbered lists for actionable steps
Timing & Frequency
Best days to publish: Tuesday, Wednesday, Thursday
Best times: 8–10 AM EST (when US readers are most active)
Consistency > Volume: 1 great article/week beats 5 mediocre ones
Republish underperforming articles with new titles and images after 3+ months
Run “clawhub install devhoangkien/medium-writer” in your terminal. The skill is added to your agent's skills directory and picked up automatically on the next run — no restart or extra configuration needed.
What does the Medium Writer skill do?
Writing and publishing articles for the Medium Partner Program. Creating monetizable articles. The SKILL.md section on this page shows the exact instructions the skill gives your agent.
Is the Medium Writer skill free?
Yes. Medium Writer is a free, open-source skill by devhoangkien. As with any third-party skill, review the source repository before installing it into an agent with sensitive access.
Does Medium Writer work with Claude Code and OpenClaw?
Yes. Skills use the portable SKILL.md format, so Medium Writer works with Claude Code, OpenClaw, Codex, Hermes, and any other agent that reads SKILL.md skills.