engineering-blog-post

Writes and edits evidence-backed engineering blog posts using eight classified post patterns.

2|Updated Sep 6, 2026
One-click install
npx skills add https://github.com/samber/developer-relations-skills --skill engineering-blog-post-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineering-blog-post
Source: https://github.com/samber/developer-relations-skills/tree/main/skills/engineering-blog-post
Command: npx skills add https://github.com/samber/developer-relations-skills --skill engineering-blog-post-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Technical blog posts lose credibility with skeptical developer readers when they contain unsupported claims, marketing voice, missing methodology, or no stated limitations. This Skill drafts or edits engineering blog posts so every assertion is measured, shown, sourced, or marked as opinion before publication. ## Core Features & Use Cases - Pattern selection: Matches raw material to one of eight post patterns (Bug Hunt, Rewrote It in X, How We Built It, Benchmarks and Test Results, Lessons Learned, Thoughts on Trends, Non-markety Product Perspectives, Explainer) ranked by effort, value, and compliance cost. - Claim ledger and credibility gate: Classifies every assertion into four evidence classes and blocks handoff until six checks pass, including benchmark disclosure, honest limitations, and pinned code snippets. - Draft and edit modes: Drafts new posts from raw material, or returns a three-tier fix list (blocking, strong, optional) for existing drafts without rewriting the author's voice. - Use Case: Turn internal incident notes into a public postmortem: the Skill runs a redaction pass on names and ticket IDs, selects the Bug Hunt pattern, and produces a post with dead ends, root cause, and a generalizable lesson. ## Quick Start Ask the assistant to turn your incident notes, migration numbers, or design doc into an engineering blog post, or to review an existing technical draft for unsupported claims before publishing.

Frequently Asked Questions about engineering-blog-post

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an engineering blog post that developers trust?

Pick a post pattern that matches your raw material, build a claim ledger classifying every assertion as measured, shown, sourced, or opinion, and state at least one concrete limitation. The Skill enforces this through a six-check credibility gate before handoff.

How do I review a technical blog draft without rewriting it?

Use edit mode: the Skill returns a three-tier fix list (blocking, strong, optional) ordered by trust damage, quoting each offending line, and only rewrites passages you approve. This preserves the author's voice, which a full rewrite destroys.

What must a benchmark post disclose when comparing against a competitor?

A competitor comparison is benchmarketing and owes maximum disclosure: hardware, versions, workload, tuning applied to each side, run counts with variance, and a link to reproduction scripts, stated before the results. Tuning only your own side or reporting a single run gets posts publicly dismantled.

Can I publish my internal postmortem as a public blog post?

Derive the public post from the internal review, never copy it. Run a redaction pass removing individual names, service codenames, ticket IDs, and internal links, decide deliberately whether impact figures ship, and add a reason an unaffected reader should keep reading.

When should I not write an engineering blog post?

Skip it when the material fits a tutorial, quickstart, changelog, migration guide, or case study instead, or when the topic passes none of the topic filters (counter-intuitive, counter-narrative, surprising capability, elegant articulation, recognition). A post written from mastery with no surprise is accurate and unread.