medium-posts — Claude Code skill for Medium publishing
Guides writing, publishing and republishing on Medium: canonical tags, structure, distribution. Useful when your blog should rank faster than a new domain can.
npx skills add kostja94/marketing-skills --skill medium-posts -a claude-code
npx skills add kostja94/marketing-skills --skill medium -a claude-codeWhat medium-posts does
The skill walks through a Medium post end to end: it asks whether the piece is original or a republish, shapes the title around a keyword, and places internal links back to your site plus a CTA. The canonical step matters most on republishing — point it at the original URL in Medium settings, or search engines may treat the text as a duplicate.
It also explains why Medium is worth the effort: the platform's domain authority ranks content in days rather than months, and articles that pull traffic attract links. A section covers AI search, where Medium posts show up in generated answers often enough to plan for.
If your project has a root contextus.md, the skill reads it and loads only the modules this task needs. Without it, it works from your project material or facts you supply and asks for what's missing. Two neighbours cover other ground: parasite-seo for parasite SEO where Medium isn't the target platform, and generative-engine-optimization for AI search visibility. Don't reach for both at once — they answer different questions.
What it helps with
- set a canonical link when moving a post from your site to Medium
- shape a title and outline around a target keyword
- place links back to site pages inside the article
- decide which posts belong on Medium and which stay home
- write copy that AI search engines pick up
Example prompts for the agent
- help me publish this article on Medium with a canonical to the original
- write a Medium title and outline for a post about CI/CD
- check where the CTA and site links should go in this Medium draft
How to install medium-posts
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill medium-posts -a claude-codenpx skills add kostja94/marketing-skills --skill medium -a claude-code2Manually: put the files in place
~/.claude/skills/medium/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/medium/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill medium -a codex2Manually: put the files in place
.agents/skills/medium/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill medium -a cursor2Manually: put the files in place
.cursor/skills/medium/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills medium2Manually: put the files in place
.github/skills/medium/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill medium -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/platforms/mediumManually: put the files in place
.devin/skills/medium/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill medium -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about medium-posts
How do I install medium-posts in Claude?
Run npx skills add kostja94/marketing-skills --skill medium-posts -a claude-code. The alternative is npx skills add kostja94/marketing-skills --skill medium -a claude-code. The skill file then sits at ~/.claude/skills/medium/SKILL.md.
What does medium-posts do?
It helps write, publish and optimize Medium articles: it sorts out original versus republish, sets up the canonical link, and suggests structure, internal links and CTA placement.
How is medium-posts different from parasite-seo?
medium-posts applies when Medium itself is the target platform. For a broader parasite SEO plan where Medium is just one of several, use parasite-seo.
Source text
SKILL.md · MIT
--- name: medium-posts description: When the user wants to write, publish, republish, or optimize posts on Medium.com (canonical tags, distribution, Medium SEO). Also use when the user mentions "Medium," "Medium article," "Medium story," "Medium publishing," "canonical Medium," or "publish on Medium." Not for general parasite SEO when Medium is not the target platform—use parasite-seo. For AI search visibility strategy, use generative-engine-optimization. metadata: version: 1.1.0 --- # Platforms: Medium Guides Medium publishing for parasite SEO and content distribution. Medium's domain authority helps content rank faster than on new sites; articles can reach page 1 within days. Use this skill when planning Medium content or republishing from your site. **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Initial Assessment **Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system. Identify: 1. **Content**: Original or republish 2. **Canonical**: If republish, set canonical to original URL 3. **Goal**: Traffic, backlinks, AI citations ## Why Medium for Parasite SEO | Benefit | Detail | |---------|--------| | **Fast rankings** | Page 1 within days vs months on own domain | | **Authority** | Leverages Medium's domain authority | | **AI-friendly** | Frequently cited in AI search results | | **Backlinks** | Traffic-generating articles attract links | ## Canonical Links When republishing: Set canonical to your original URL in Medium settings. Prevents duplicate content penalties; signals original source. ## Content Best Practices - **Match intent**: Keyword-focused; solve problem or answer question - **Quality**: Same quality as on your site - **CTA**: Link to relevant site pages; don't over-promote ## Output Format - **Title** (keyword-optimized) - **Structure** (for original) or **canonical** setup (for republish) - **Internal links** to site - **CTA** placement ## Related Skills - **parasite-seo**: Parasite SEO strategy; Medium as platform - **article-page-generator**: Article structure for republish - **link-building**: Medium as backlink source - **grokipedia-recommendations**: GEO; AI search visibility
© kostja94 · MIT · kostja94/marketing-skills
