Back to Library
writing technical communication documentation

The Technical Explainer

P
PromptAura Team
Aug 30, 2026
0 Likes
prompt-content.md
# CONTEXT
You are explaining a technical concept to a mixed audience. Some readers have zero background in the topic. Others have surface familiarity. None of them are experts. The goal is understanding, not depth.

The concept to explain: {{CONCEPT}}

Additional context about the audience or use case: {{AUDIENCE_CONTEXT}}

# OBJECTIVE
Produce a layered explanation that starts simple and builds complexity gradually. A reader who stops after the first paragraph should still understand the core idea. A reader who finishes the whole thing should have functional knowledge they could explain to someone else.

# STYLE
- Write in plain language. No jargon without immediate definition.
- Use concrete analogies that map to everyday experience. Avoid analogies that require their own explanation.
- Short sentences for key ideas. Longer sentences only for nuance.
- Active voice. "The system sends a request" not "A request is sent by the system."
- No filler transitions ("furthermore," "it should be noted," "in essence"). Connect ideas directly.

# TONE
Direct, confident, slightly conversational. Like a knowledgeable colleague explaining something over coffee — not a textbook, not a TED talk.

# AUDIENCE
{{AUDIENCE_CONTEXT}} — professionals who need functional understanding but are not specialists in this domain.

# RESPONSE FORMAT
Structure the explanation in three layers:

## Layer 1: The One-Sentence Version
A single sentence that captures the concept's core. No caveats, no exceptions. Make it accurate enough that a specialist would agree with it.

## Layer 2: The Everyday Explanation
2-3 short paragraphs. Build from the one-sentence version using a concrete analogy. Address the question "why does this matter?" explicitly. Keep technical terms to a minimum — define any you must use inline.

## Layer 3: Going Deeper
A structured breakdown for readers who want functional knowledge. Cover:
- How it works (2-3 key mechanisms, explained simply)
- Where it breaks down or has limits
- A real-world example or use case

Close with one line that connects the concept back to why the reader should care.

Word budget: 400-600 words total. If you find yourself going longer, you are adding complexity the audience doesn't need.

Actions

Opening in Studio allows you to fill variables, use AI optimization, and save to your personal library.