Write a technical blog post
Turns engineering notes, code and results into a technical blog post with one clear takeaway, real numbers and working code, and no hype. Use for engineering blogs and write-ups of a project.
Engineers read technical posts to learn something they can use: a technique, a trade-off, a mistake to avoid. They leave at the first sign of marketing or vagueness, and they distrust numbers without a method. The best posts follow one concrete problem from symptom to solution, show the dead ends honestly and end with a takeaway the reader can apply elsewhere.
Write a post about: For: . Target length: about words.
- Decide the one takeaway a reader should leave with, in one sentence. Every section must serve it; cut material that does not.
- Open with the concrete problem or surprising result in the first two sentences: a symptom, a number, a failure. No scene-setting about the industry.
- Give only the context needed to follow along.
- Walk through what was tried, in order, including what did not work and why. Show code or config where it carries the explanation, trimmed to the lines that matter.
- Present the result with the numbers from the notes and how they were measured.
- Name the trade-offs and when this approach is the wrong choice.
- Close with the takeaway, phrased so it applies beyond this codebase.
- Use only facts, numbers, quotes and code from the notes. If a claim needs a figure that is not there, write
[needs number: ...]instead of estimating. - Code must be consistent with the notes and minimal; do not invent APIs or library features.
- No hype or filler: avoid "in today's fast-paced world", "game-changer", "seamless", "unlock", "delve", "robust" and rhetorical questions as openers.
- Use "we" for the team's work and "you" for the reader. Short paragraphs; descriptive subheadings.
- Do not name customers, colleagues or internal systems unless the notes say they can be named.
Titles
Three title options: one plain and descriptive, one leading with the result, one leading with the problem. No clickbait.
Post
The full post in Markdown with subheadings.
Facts to verify
Every number, quote and factual claim in the post, each with where it came from in the notes, plus any [needs number] gaps.
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Software engineering
- category
- Developer writing
- level
- Intermediate
- made for
- Software engineer, Developer advocate, Tech lead / staff engineer
- risk
- read-only
- version
- v1.0.0 · experimental
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-tech-blog-post --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-tech-blog-post -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-software-engineering@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Developer writingRewrite for clarity
Rewrites technical prose so the main point comes first and every sentence is plain and specific, while keeping every fact, number and caveat. Use on design notes, emails, RFC drafts and docs.
rewrite-for-clarityWrite a conference talk proposal
Writes a CFP submission with title options, abstract, timed outline, takeaways and notes for reviewers, aimed at the event's audience and selection criteria. Use for engineers and developer advocates.
write-conference-talk-proposalExplain a technical issue to executives
Translates a technical issue or decision into a one-page executive brief with business impact, options, cost, risk and the specific ask. Use when leadership must decide or fund something technical.
explain-tech-to-executivesWrite an API deprecation notice
Writes the notice to API consumers for a deprecation or breaking change, covering what changes, the timeline, migration steps and where to get help. Use before announcing an API change.
write-api-deprecation-notice