---
name: technical-article-enhancer
description: "Rewrites a rough technical draft into a clear, accurate article for a chosen audience, with precise terminology and optional diagram markers. Use when a writer has a rough technical article draft and needs it clearer, better structured, and written for a specific technical audience. Do not use for writing an article from a blank page or outlining a blog post. Related topics: writing, creative, technical."
---

# Technical Article Enhancer

Rewrites a rough technical draft into a clear, accurate article for a chosen audience, with precise terminology and optional diagram markers.

## When to use

Use this skill when a writer has a rough technical article draft and needs it clearer, better structured, and written for a specific technical audience. Do not use it for writing an article from a blank page or outlining a blog post.

## Workflow

1. Ask the user for each input listed below in a single message, skipping any they have already given. Where options are listed, offer them, but accept other answers too.
2. Read the draft and list each technical claim so none is lost.
3. Flag claims that look wrong or unsupported instead of changing them silently.
4. Restructure with headings so the point comes first and the emphasized concepts are prominent.
5. Replace vague wording with precise terms and define terms the audience may not know.
6. Insert diagram placeholders if requested and trim to the word range.

## Inputs

- **Original draft** (longer free text)
- **Target audience** (choose one: Software engineers, Data scientists, Hardware designers, Academic researchers, General tech enthusiasts)
- **Key concepts to emphasize** (choose any: Performance, Security, Scalability, Usability, Compliance)
- **Desired length in words** (number from 500 to 2000)
- **Tone** (choose one: Formal, Conversational, Instructional, Analytical)
- **Include diagram placeholders** (choose one: Yes, No)

## Output

The revised article in markdown with headings, lists, and code blocks as needed, plus Diagram placeholder lines if requested, within the word range.

## Prompt template

Fill the inputs into this template and follow it as the full instruction.

### Technical Article Enhancer

Act as a technical writing specialist and turn my rough draft into a polished article that is accurate, engaging, and scoped to its audience.

- Original draft: {{Original draft}}
- Target audience: {{Target audience}}
- Key concepts to emphasize: {{Key concepts to emphasize}}
- Desired length in words: {{Desired length in words}}
- Tone: {{Tone}}
- Include diagram placeholders: {{Include diagram placeholders}}

Keep every technical claim from the draft; do not add facts or numbers that are not in it, and flag anything that looks wrong or unsupported instead of silently fixing it. Put the point first, define terms the audience would not know, and replace vague words with precise ones. Give the emphasized concepts a clear place. Use headings, bullet lists, and code blocks where they help.

Return the revised article in markdown. If diagrams are requested, insert a placeholder line reading Diagram followed by a colon and a short description, at points where a visual would help.

## Pitfalls

- Adding invented numbers or benchmarks that make the article look authoritative but are false.
- Silently correcting a claim that the author meant.
- Over-simplifying for a specialist audience.
