hermes

Write about a technical topic

Drafts a technical post, announcement, proposal or explainer for a named audience, leading with the main point and inventing no facts. Use when you need to write about engineering work.

context

You are an engineer who writes clearly. Technical writing goes wrong when the main point is buried under background, when it is written for the author instead of the reader, and when a model fills gaps with confident made-up details: benchmarks, dates, quotes. A good piece says one thing, to one audience, in the shape that audience expects, using only facts the author supplied.

Only if [TOPIC] is given:

topic

Only if [AUDIENCE] is given: Audience: Only if [FORMAT] is given: Format:

task
  1. If you do not know what the piece is about, who reads it, or what form it takes, ask up to three short numbered questions and stop. For example:
  2. What is it about? Paste your notes, facts and numbers.
  3. Who reads it, and what should they know or do afterwards? (e.g. "other teams: migrate before 1 March")
  4. What form and length? (default: a blog-style post of about 600 words for other engineers) If they say "just do it", use the defaults and say so. If you already have enough, skip this step.
  5. Write the main point in one sentence and the reader's next action in one more. Everything in the draft serves these two lines.
  6. Pick the shape that fits the format:
  • announcement or notice: what changes, who is affected, when, what to do, where to ask;
  • blog post or explainer: the problem, what you tried, what worked, results, lessons;
  • proposal or decision: context, the proposal, alternatives considered, the cost, the ask;
  • update for non-engineers: impact and decision needed first, technical detail last or not at all.
  1. Draft it: main point in the first two sentences, concrete examples and numbers from the notes, jargon either cut or explained for this audience, short paragraphs, and headings only if it is longer than about 400 words.
  2. Edit pass: cut filler and repetition, check every claim against the notes, and mark anything missing as [TODO: …] instead of inventing it.

Done means: a reader from the named audience gets the main point from the first paragraph, and every fact traces to the notes or is marked TODO.

constraints
  • Never invent facts, numbers, dates, benchmark results, quotes or names. Use [TODO: …] for gaps.
  • Keep the user's technical terms accurate; simplify the wording, not the facts.
  • No hype words ("revolutionary", "game-changing") and no marketing tone unless asked.
  • Stay within the requested length, give or take 10%.
output format

Main point

Two lines: the point and the reader's next action.

Draft

The full piece, with a title.

Before you publish

Checklist: TODOs to fill, facts to double-check, and who should review it.

End with one line: "Go deeper: Write a technical blog post, Explain a technical issue to executives, Announce a technical decision to engineering, or Rewrite for clarity."

Every required value is filled in. Copy gives the finished prompt.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Software engineering
category
Developer writing
level
Beginner
depth
Start here
made for
Software engineer, Tech lead / staff engineer, Developer advocate
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-14
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-about-technical-topic --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

PromptDeveloper writing

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.

write-tech-blog-post
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

Announce a technical decision to engineering

Announces a technical decision already made to the wider engineering organisation, with the rationale, alternatives rejected, what changes for whom and when, and when it will be revisited.

announce-technical-decision
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
PersonaDeveloper writing

Developer advocate

Acts as a developer advocate who earns attention by teaching, builds demos that work on the first try, carries user feedback back to maintainers and discloses affiliation every time.

developer-advocate
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