About media-writer
media-writer is a writing skill for creators adapting technical material to specific online communities. It selects a platform guide and applies that platform’s cultural expectations rather than reusing one format everywhere.
Key features
- 01Identify the target platform
- 02Load only its platform guide
- 03Account for community culture and reading context
- 04Avoid generic writing pitfalls
- 05Apply platform-specific formatting
Use cases
- 01Write technical posts for Hacker News
- 02Adapt technical insights for WeChat articles
- 03Shape posts to Reddit community norms
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/media-writerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/devto.mdhackernews.mdlinkedin.mdmedium.mdreddit.mdtwitter.mdwechat.mdDetails
From the project READMEMedia Writer
Transform technical content into platform-native writing that feels like it belongs.
The Core Truth
Every platform is a culture, not a format.
The difference between content that spreads and content that dies isn't formatting - it's cultural fluency. A Hacker News post that reads like a LinkedIn announcement will be ignored regardless of its technical merit. A WeChat article written like academic documentation will get zero shares.
Your job: Write like a respected member of each community, not like a tourist.
The Mindset Shift
Before writing for any platform, understand:
- Who are these people? Not demographics - their values, pet peeves, inside jokes
- What do they reward? Upvotes/shares come from triggering specific responses
- What do they punish? Every community has instant-rejection patterns
- What's the reading context? Commute? Deep focus? Procrastination?
CRITICAL: The same insight packaged differently can get 0 engagement or 10,000. The insight doesn't change. The cultural packaging does.
Platform Selection
Identify target platform from user input, then load ONLY that guide:
| User says... | Platform | Load | Do NOT Load |
|---|---|---|---|
| "WeChat", "WeChat Official Account" | references/wechat.md | All others | |
| "HN", "Hacker News" | Hacker News | references/hackernews.md | All others |
| "Reddit", "r/", "subreddit" | references/reddit.md | All others | |
| "Medium" | Medium | references/medium.md | All others |
| "Twitter", "X", "thread" | Twitter/X | references/twitter.md | All others |
| "Dev.to", "dev.to" | Dev.to | references/devto.md | All others |
| "LinkedIn", "LI" | references/linkedin.md | All others |
MANDATORY: Read the corresponding platform guide completely before writing. Each guide contains the cultural context and anti-patterns specific to that platform.
Universal Anti-Patterns
These kill content on ANY platform:
- Tourist writing: Content that screams "I don't actually use this platform"
- One-size-fits-all: Same content copy-pasted with minor tweaks
- Promise-delivery gap: Clickbait title with shallow content
- Tone deafness: Corporate speak on Reddit, casual on LinkedIn
- Self-promotion without value: Taking before giving
The Quality Bar
Expert content writers understand:
- First 10 seconds decide everything - Hook or die
- Every platform has status games - Learn what earns respect
- Authenticity beats polish - But authenticity must be platform-appropriate
- Engagement begets engagement - Respond to comments, join the conversation
- Timing matters - Each platform has optimal posting windows
Output
When creating platform-specific content:
- State the target platform
- Apply all cultural rules from that platform's guide
- Write as if you ARE a respected community member
- Include platform-specific formatting (TL;DR for Reddit, hooks for Twitter, etc.)
Remember: The goal isn't to "post content on Platform X." The goal is to become a valuable voice in that community.