hermes

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.

context

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.

task

Write a post about: For: . Target length: about words.

notes

  1. Decide the one takeaway a reader should leave with, in one sentence. Every section must serve it; cut material that does not.
  2. 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.
  3. Give only the context needed to follow along.
  4. 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.
  5. Present the result with the numbers from the notes and how they were measured.
  6. Name the trade-offs and when this approach is the wrong choice.
  7. Close with the takeaway, phrased so it applies beyond this codebase.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-tech-blog-post --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-tech-blog-post -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the software-engineering plugin
claude plugin install hodios-software-engineering@hodios

The plugin brings every entry in this domain at once.

PromptDeveloper writing

Rewrite 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-clarity
PromptDeveloper writing

Write 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-proposal
PromptDeveloper writing

Explain 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-executives
PromptDeveloper writing

Write 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