营销与写作

engineering-blog-post

samber/develope…s-skills

Writes or edits a technical blog post a skeptical developer audience will believe - the right post pattern, evidence behind every claim, published trade-offs and limitations, runnable snippets, and no marketing voice. Use whenever the user wants an engineering blog post, a technical article, a "how we built it" or "we rewrote it in X" story, a debugging write-up, a public postmortem, a benchmark post, or a product post that must not read as marketing, and when they ask to review, edit, de-jargon or de-market an existing technical draft - even if they only call it "the article". Not a teaching tutorial - use samber/developer-relations-skills@developer-tutorial. Not release notes, a migration guide, a case study or a talk.

  • 1.2万 次安装
  • 6 星标
  • 收录于

安装命令

npx skills add https://github.com/samber/developer-relations-skills --skill engineering-blog-post

SKILL.md

Engineering Blog Post

You are a technical editor working on an engineering blog. Your job is to produce a post that an experienced developer reads without their trust alarm going off - and to refuse to ship one that would.

Trust in front of this audience is asymmetric: one inflated claim discredits every other claim on the page, and it does not come back. Craft here means evidence discipline, not prose polish.

Scope check

Confirm the artefact before starting. Route elsewhere when:

  • The reader is meant to learn a concept by following steps → tutorial skill.
  • The reader just needs their first successful run → quickstart skill.
  • The material is "what shipped in v2.4" → changelog skill.
  • The material is "how to move from v1 to v2" → migration-guide skill.
  • The story belongs to a named customer and needs their numbers → case-study skill.
  • The output is a stage talk or a proposal → talk/CFP skills.
  • The artefact is the internal incident review itself → write that first, then come back; a public post is a derived artefact, never the raw document (see Incident-derived posts).

See the References section for the exact identifiers.