dev-post
Turn one raw idea into a dev.to article that sounds like you. Produces three title options, one full draft, and a copy-ready block. Never publishes without an explicit yes. Optional: can publish via Forem API if DEVTO_API_KEY is present.
naheel0 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add naheel0/dev-skills --skill dev-post技能说明
name: dev-post description: >- Turn one raw idea into a dev.to article that sounds like you. Produces three title options, one full draft, and a copy-ready block. Never publishes without an explicit yes. Optional: can publish via Forem API if DEVTO_API_KEY is present.
dev-post
Turns one raw idea into a dev.to article that sounds like the person who wrote it. Optimized for dev.to's audience (beginner–intermediate web/dev tech), feed ranking (reactions + comment count + comment likes), and syndication best practices (canonical URL, cover image, tags).
Before you write
- Read
~/.claude/devto/voice.mdif it exists. That file is the user's voice profile: how they talk, what they never say, who they are talking to. If it does not exist, ask for three of their own past posts (dev.to or elsewhere), infer the voice from those, and write the file. Do not skip this and do not invent a voice. An article in the wrong voice is worse than no article. - Read
title-formulas.jsonandtag-suggestions.jsonin this folder. - If the idea is thin - "post about AI" - do not pad it. Ask one batched question: what happened, to whom, and what did it cost or return. An article needs one specific true thing. Get it before writing.
- Check
~/.claude/devto/log.mdif it exists - avoid repeating the same tag stack or title formula two posts in a row unless the user asks. Tag and formula suggestions are weighted bydev-learn.pyaudit results (higher weight = more likely to be suggested).
The shape
dev.to rewards dwell time, reactions, and comments, in that order. So:
Line 1 the title. Alone. <10 words, keyword + optional number.
Lines 2-3 the hook. First sentence must pull the reader through.
Body short paragraphs, 1-5 lines each, blank line between every one.
No wall. Use H2/H3 headings only. Bold key bits.
Code fenced markdown blocks for snippets; every block needs context.
Cover 1000×420 absolute URL. Strongly recommended; maximizes feed CTR.
CTA one closing sentence: one specific question or one instruction.
Never both.
Tags exactly 4, comma-separated, mixed broad + niche.
Length: 800–2,500 words is the working range. Under 400 reads as a note, not an article. Over 3,000 needs to earn every line.
- Read time: dev.to auto-computes
reading_time_minutes(~260 wpm). Sweet spot for reach: 1–3 min reads. Sweet spot for depth: 4–7 min reads. - Half-life: most views land in the first week; median post half-life is ~4 days. Optimize for the first 7 days, not forever.
The loop
1. Pick three titles, not one. Run the idea through title-formulas.json
and choose three formulas that genuinely fit it. Different formulas, not three
variations of one. Show them as three numbered lines and say which you would
ship and why, in one sentence.
2. Draft the full article on the strongest title.
3. Humanize it. Run the draft through /dev-human before showing it.
Every article from this skill ships humanized.
4. Pick tags. Exactly 4 tags from tag-suggestions.json. Mix 2–3 broad
(#javascript, #webdev, #beginners, #tutorial, #programming) + 1–2 niche
(#react, #deno, #a11y, #graphql, #mcp). Flag {{cover image URL}} if missing.
5. Print the block. Copy-ready, in a fenced block, exactly as it should be pasted into the dev.to editor (Basic Markdown supports YAML front matter; Rich+Markdown editor uses the gear icon). Then, underneath:
POST READY
title: #17 Build X in N Steps
length: 1,240 words · ~5 min read
humanizer: 6 artefacts stripped, human score 86 PASS
tags: javascript, webdev, tutorial, react
cover: {{cover image URL}}
canonical: {{canonical URL or none}}
series: {{series name or none}}
published: {{draft or published}}
post at: Tuesday 9:00am ET (from your plan)
Reply "yes" to log it, or tell me what to change.
6. Never publish automatically. This skill produces text. The user posts
it manually into dev.to, OR if DEVTO_API_KEY is present in ~/.env, the
skill can offer to publish via POST https://dev.to/api/articles with headers
api-key: $DEVTO_API_KEY and accept: application/vnd.forem.api-v1+json.
On "yes", append the post to ~/.claude/devto/log.md with the date, title,
formula_id, tags, cover, canonical, series, published, and first line.
Leave engagement_rate, comment_ratio, reach_multiple, human_score,
and audit_rank blank — /dev-audit fills those in after the post has
collected data. Then run /dev-learn (dev-learn.py audit --apply) to
promote winning formulas/tags and demote losing ones.
Rules that make the difference
- One idea per article. If the draft has two, you have two articles. Say so.
- Numbers over adjectives. "$4,200" beats "a lot". If the user has not given you a number, ask for one rather than writing around the hole.
- No engagement bait. "Thoughts?" and "Agree?" are dead. The closing question has to be one only this article could ask.
- Four tags maximum, comma-separated, lowercase slugs (no spaces). Tags with spaces → 422 Unprocessable Entity.
- Cover image must be an absolute URL. Local paths break.
- Canonical URL goes on the dev.to copy, not the source. If cross-posting
from a personal blog, set
canonical_urlon the dev.to article pointing back to the original. Let the original index first. - AI disclosure. If AI assisted the draft, add
#ABotWroteThistag or an in-article disclosure statement per dev.to's AI guidelines. Do not publish AI-generated educational content the human didn't already understand. - No promotional backlinks. dev.to bans posts whose main purpose is SEO backlinks (except personal blog or company blog posted under that company's org). Disclose affiliate links clearly.
- Never fabricate. No invented metrics, clients, revenue figures or outcomes under the user's name. If a number