dev-to-hashnode

SKILL.md

Dev.to & Hashnode Publishing

Developer blogging platforms offer built-in audiences of hundreds of thousands of developers. This skill covers cross-posting strategy, platform-specific optimization, and building followers on Dev.to and Hashnode.


Before You Start

  1. Read .agents/developer-audience-context.md if it exists
  2. Decide your canonical URL strategy (important for SEO)
  3. Create accounts on both platforms to reserve your username
  4. Understand: These platforms reward consistency and engagement

Platform Comparison

Dev.to vs Hashnode

Feature Dev.to Hashnode
Monthly visitors ~10M+ ~3M+
Custom domain No (subdomain only) Yes (free)
Canonical URL support Yes Yes
SEO benefits High domain authority Your domain gets SEO
Monetization No native Sponsors, newsletter
Newsletter No Built-in
Series support Yes Yes
Code highlighting Excellent Excellent
Community features Strong (reactions, comments) Growing
Audience Broader, more beginners More senior, focused

When to Use Each

Use Dev.to when Use Hashnode when
Maximum reach is priority Building your own brand
Targeting beginners/mid-level Want custom domain SEO
Community engagement matters Building email list
Quick validation of content Long-term content strategy
Don't have your own blog Supplementing your main blog

Cross-Posting Strategy

The Canonical URL Decision

Strategy Pros Cons
Original on your blog SEO to your domain, full control Platforms may rank lower
Original on Dev.to Maximum initial reach No SEO to your domain
Original on Hashnode (custom domain) SEO + platform reach Smaller initial audience

Best Practice: Your Blog + Cross-Post

  1. Publish on your blog first — This is canonical
  2. Wait 1-2 days — Let Google index your original
  3. Cross-post to Dev.to — Set canonical URL to your blog
  4. Cross-post to Hashnode — Set canonical URL to your blog

Setting Canonical URLs

Dev.to (in frontmatter):

---
title: Your Title
canonical_url: https://yourblog.com/your-post
---

Hashnode (in editor):

  • Click "Article settings" gear icon
  • Paste original URL in "Canonical URL" field

Dev.to Optimization

Frontmatter Structure

---
title: "Specific, Keyword-Rich Title (Not Clickbait)"
published: true
description: "One compelling sentence that shows up in previews and SEO"
tags: javascript, webdev, tutorial, beginners
cover_image: https://your-cdn.com/image.png
canonical_url: https://yourblog.com/original-post
series: "Building a CLI from Scratch"
---

Tag Strategy

Tag Followers Use for
#javascript 200K+ JS content
#webdev 150K+ General web development
#beginners 120K+ Accessible content
#tutorial 100K+ Step-by-step guides
#react 80K+ React specific
#programming 80K+ General programming
#python 70K+ Python content
#devops 50K+ DevOps, CI/CD
#opensource 40K+ OSS projects
#productivity 40K+ Dev tools, workflows

Rules:

  • Maximum 4 tags per post
  • First tag is primary (appears in URL)
  • Check tag follower count before using

What Performs on Dev.to

Content type Performance Notes
Beginner tutorials High Largest audience segment
Listicles ("10 tools...") High Easy to consume
Career advice High Aspirational content
Hot takes Medium-high Controversial drives engagement
Deep technical Medium Niche but engaged audience
Project showcases Medium Best with story behind it
News/updates Low Competes with official sources

Dev.to Engagement Features

Feature How to use
Reactions Heart, unicorn, saved, fire — different meanings
Comments Reply to every comment for algorithm boost
Series Group related posts, drives binge reading
Discussion Tag #discuss for opinion/question posts
Listings Post jobs, events, products

Hashnode Optimization

Article Settings

Setting Recommendation
Subtitle Use for SEO keywords
Cover image 1600x840 optimal size
SEO title Can differ from article title
SEO description 155 characters max
Canonical URL Your original if cross-posting
Enable table of contents Yes for long posts
Disable comments No — engagement helps

Tag Strategy

Hashnode tags work differently:

  • Tags are linked to global topics
  • Some tags have dedicated feeds
  • Fewer tags, more focused

Popular Hashnode tags:

  • javascript, web-development, react
  • devops, cloud, aws
  • beginners, tutorial
  • opensource, programming

What Performs on Hashnode

Content type Performance Notes
In-depth tutorials High Audience expects depth
Architecture posts High More senior audience
DevOps/cloud content High Strong niche presence
Career stories Medium-high Personal narratives work
Quick tips Medium Less than on Dev.to
Listicles Medium Less effective here

Hashnode-Specific Features

Feature How to use
Newsletter Enable to collect subscribers
Series Great for tutorials, courses
Custom CSS Style your blog uniquely
Widgets Add GitHub, newsletter CTAs
Sponsors Hashnode has sponsor program
Analytics Built-in, more detailed than Dev.to

Content Formatting

Structure That Works

# Title

[Compelling hook — why should they care?]

## Table of Contents (for long posts)
- [Section 1](#section-1)
- [Section 2](#section-2)

## The Problem

[What pain point are you solving?]

## The Solution

[Your approach, with code examples]

### Code Example

```language
// Well-commented code
const example = "explained";

Step-by-Step

  1. Step one — Explanation
  2. Step two — Explanation
  3. Step three — Explanation

Common Pitfalls

[What to watch out for]

Conclusion

[Summary + CTA]


If you found this helpful, follow me for more content about [topic].


### Formatting Best Practices

| Element | Guideline |
|---------|-----------|
| **Headers** | Use H2 for sections, H3 for subsections |
| **Code blocks** | Always specify language for syntax highlighting |
| **Images** | Use descriptive alt text, compress for speed |
| **Links** | Descriptive text, not "click here" |
| **Length** | 1000-2500 words performs best |
| **Paragraphs** | Keep short, 2-3 sentences max |
| **Lists** | Use liberally for scannability |

---

## Building Followers

### Consistency Strategy

| Frequency | Result |
|-----------|--------|
| 4+ posts/month | Rapid follower growth |
| 2-3 posts/month | Steady growth |
| 1 post/month | Slow but sustainable |
| Sporadic | Minimal follower retention |

### Engagement Tactics

| Tactic | Why it works |
|--------|--------------|
| Reply to every comment | Algorithm boost + relationship building |
| Comment on others' posts | Visibility + community |
| Follow relevant authors | Often reciprocated |
| Share on social media | Drives external traffic |
| Link between your posts | Keeps readers on your content |
| Create series | Encourages following for updates |

### Bio and Profile Optimization

**Dev.to profile**:
- Clear profile photo
- Bio with what you write about
- Link to your main site
- List your expertise areas

**Hashnode profile**:
- Custom domain setup
- Newsletter enabled
- Social links populated
- Blog name and tagline set

---

## Platform-Specific Do's and Don'ts

### Do's

1. **Do** set canonical URLs to protect your SEO
2. **Do** use platform-specific formatting (embeds, etc.)
3. **Do** engage with comments within 24 hours
4. **Do** cross-post to both platforms
5. **Do** use series for related content
6. **Do** optimize cover images for each platform
7. **Do** include a CTA at the end

### Don'ts

1. **Don't** post identical content without canonical URLs
2. **Don't** ignore comments
3. **Don't** use only self-promotional content
4. **Don't** neglect tags — they're discovery mechanisms
5. **Don't** forget mobile readability
6. **Don't** publish unfinished drafts
7. **Don't** keyword stuff your content

---

## Analytics and Iteration

### Dev.to Dashboard

| Metric | What it tells you |
|--------|-------------------|
| Views | Reach/impressions |
| Reactions | Engagement quality |
| Comments | Discussion value |
| Reading time | Content depth |
| Followers from post | Conversion rate |

### Hashnode Analytics

| Metric | What it tells you |
|--------|-------------------|
| Total views | Reach |
| Unique visitors | Audience size |
| Read ratio | Completion rate |
| Time on page | Engagement depth |
| Referrers | Traffic sources |
| Newsletter signups | List growth |

### What to Optimize

| Low metric | Try this |
|------------|----------|
| Low views | Better title, different tags |
| Low reactions | More engaging opening |
| Low comments | End with a question |
| High bounce | Better structure, hook |
| Low followers | Stronger CTA, series |

---

## Tools

| Tool | Use case |
|------|----------|
| **[Octolens](https://octolens.com)** | Monitor Dev.to and Hashnode for mentions of your topic, competitors, and trends. Find popular content to learn from. |
| **Hemingway Editor** | Improve readability |
| **Carbon** | Beautiful code screenshots |
| **Unsplash** | Free cover images |
| **Canva** | Custom cover image design |
| **Grammarly** | Catch errors before publishing |

---

## Content Calendar Template

| Week | Dev.to | Hashnode | Topic |
|------|--------|----------|-------|
| 1 | Publish | Cross-post (day 2) | Tutorial |
| 2 | Cross-post | Publish | Deep dive |
| 3 | Publish | Cross-post (day 2) | Listicle |
| 4 | Cross-post | Publish | Opinion/experience |

---

## Related Skills

- `developer-audience-context` — Know who you're writing for
- `hacker-news-strategy` — Drive traffic from HN to your posts
- `reddit-engagement` — Share posts in relevant subreddits
- `github-presence` — Link from READMEs to your content
- `x-devs` — Promote posts on Twitter/X
Weekly Installs
12
GitHub Stars
43
First Seen
12 days ago
Installed on
opencode12
claude-code12
github-copilot12
codex12
kimi-cli12
gemini-cli12