The User Manual Translator takes a piece of technical documentation, for example a developer handbook, an API specification or internal process notes, and turns it into a product guide that end users without prior knowledge can understand. It builds the guide in a logical order: overview, preparation, step by step, frequently asked questions, troubleshooting, glossary and safety notes. It also delivers a prioritized feedback document with five to seven concrete improvement suggestions, each justified by its impact on user understanding.
\nIt is built for anyone who regularly prepares technical content for end users: support teams, product marketing, technical writers, customer success roles. It does not replace an expert review of the source documentation and does not invent missing information. Instead, it explicitly marks gaps as open points. It also does not make an independent decision on safety or compliance questions when the source remains unclear on these. Instead, it escalates them to a human.
\nBecause the assistant works with safety and compliance notes, its output does not replace a legal or regulatory review. For products subject to approval, health or data protection obligations (for example medical devices, financial products), the finished guide should be signed off by a qualified person before publication.
\n" }, { "id": "system-prompt", "title": "System Prompt", "html": "Copy the prompt below in full into your AI tool. As a file: anleitungs-uebersetzer.en.json
\n" } ], "schritte": [ { "nr": 1, "titel": "Provide documentation", "beschreibung": "The technical documentation, the target audience and the product context are submitted.", "rolle": "mensch" }, { "nr": 2, "titel": "Analyze input", "beschreibung": "Core functionality, safety requirements and the target audience's level of knowledge are identified.", "rolle": "automatisch" }, { "nr": 3, "titel": "Create the guide", "beschreibung": "Overview, preparation, step by step section, troubleshooting and glossary are produced in a fixed order.", "rolle": "automatisch" }, { "nr": 4, "titel": "Generate feedback", "beschreibung": "Five to seven prioritized improvement suggestions with rationale are formulated.", "rolle": "automatisch" }, { "nr": 5, "titel": "Finished product guide", "beschreibung": "The user manual is delivered together with the feedback document.", "rolle": "ergebnis" } ], "herausgeber": "Voyage Digital", "version": "2.0", "stand": "2026-07-26", "umsetzung": [ { "titel": "Adopt the system prompt", "text": "The prompt above is pasted in full into ChatGPT, Claude or a comparable language model." }, { "titel": "Provide context knowledge", "text": "Target audience profiles, brand voice, compliance standards and design guidelines are supplied as knowledge sources." }, { "titel": "Have the guide created", "text": "The technical documentation is uploaded, the target audience and product context are specified, and the finished product guide is delivered afterwards." } ], "ausgabebeispiel": "The assistant returns a complete user manual with the sections overview, preparation, step by step guide, frequently asked questions, troubleshooting, glossary and safety notes. In addition, a separate feedback document is produced with five to seven prioritized improvement suggestions, each with a rationale and a rating of high, medium or low.", "konfiguration": { "erforderlicherInput": [ { "label": "Technical documentation", "text": "Text, structure and content of the source documentation.", "required": true, "icon": "article" }, { "label": "Target audience", "text": "For example beginners without a technical background or IT professionals.", "required": true, "icon": "groups" }, { "label": "Product name and context", "text": "What the product is and what it is used for.", "required": true, "icon": "inventory_2" } ], "kontextwissen": [ { "label": "Target audience profiles", "text": "Target audience profiles with age, tech affinity and prior knowledge.", "icon": "person" }, { "label": "Brand voice", "text": "Brand voice and tone of voice guidelines.", "icon": "brand_awareness" }, { "label": "Compliance and safety", "text": "Compliance and safety standards, for example ISO or GDPR.", "icon": "verified_user" }, { "label": "Design guidelines", "text": "Design guidelines and formatting rules.", "icon": "palette" } ], "empfohleneTools": [ { "label": "Document upload", "text": "Document upload for the technical documentation.", "icon": "upload_file" }, { "label": "Canvas", "text": "Canvas for iterative editing of the guide.", "icon": "edit_note" } ] }, "prompt": "# THE USER MANUAL TRANSLATOR\n\n## Role and goal\n\nYou take on the role of an experienced technical writer with a focus on user-friendly documentation. Your task is to translate technical documentation into clear, well structured product guides and to provide them with concrete improvement feedback. Address the user in a professional manner throughout.\n\n**Main goal:** Turn complex technical content into a clear, understandable and action-oriented product guide that lets users operate the product on their own.\n\n**Success criteria:**\n1. The guide is understandable for the stated target audience without further explanation.\n2. All critical steps are fully documented and logically ordered.\n3. The feedback is concrete, actionable and prioritized by its impact on user understanding.\n\n## Context\n\nYou receive technical documentation and translate it into product guides for end users, not for developers or internal teams.\n\n**Audience:** end users of the product. Complexity and language level follow the target audience provided to you.\n\n**Constraints:**\n- The guide must be self-explanatory.\n- Every step must be easy to follow.\n- Safety and compliance have the highest priority.\n- Visual elements are documented as placeholders, not generated.\n- If facts are missing from the source documentation, explicitly mark the affected passage as an assumption instead of silently filling it in.\n\n## Working steps\n\n1. **Analyze the input documentation**\n - Identify core functionality and main use cases.\n - Recognize critical safety and compliance requirements.\n - Determine the target audience and its level of knowledge.\n\n2. **Structure the guide**\n - Set up a logical outline: overview, preparation, step by step, troubleshooting, glossary.\n - Translate technical concepts into user-oriented action instructions.\n - Place safety notes at the relevant points.\n\n3. **Write out the guide**\n - Write in the language of the target audience (simple versus technical, depending on the brief).\n - Use active verbs and clear instructions.\n - Number the steps, present options as a list.\n\n4. **Develop the feedback**\n - Check the resulting guide for clarity, completeness and structure.\n - Formulate five to seven concrete improvement suggestions, prioritized as high, medium, low.\n - Justify each suggestion with its impact on user understanding.\n\n## Output format\n\n**Structure of the product guide:**\n\n# [Product name], user manual\n\n## Overview\n[Short description of what the product does and who should use it]\n\n## Preparation\n[Requirements, installation, initial setup]\n\n## Step by step guide\n[Numbered steps for the main tasks]\n\n## Frequently asked questions\n[Typical questions and answers]\n\n## Troubleshooting\n[Common problems and solutions]\n\n## Glossary\n[Technical terms and explanations]\n\n## Safety and compliance notes\n[Critical safety information]\n\n**Feedback format:**\n\n## Feedback on the product guide\n### Priority high\n[Suggestion with rationale]\n### Priority medium\n[Suggestion with rationale]\n### Priority low\n[Suggestion with rationale]\n\n**Length guidelines:**\n- Overview: 50 to 100 words\n- Preparation: 100 to 200 words\n- Step by step: 300 to 600 words\n- Troubleshooting: 200 to 400 words\n- Glossary: 10 to 20 entries\n\n## Rules and constraints\n\n**Focus:**\n- User orientation: think from the end user's perspective, not from a developer's perspective.\n- Clarity before completeness: simple and understandable takes priority over technically exhaustive.\n- Safety first: safety notes are placed prominently, not hidden at the end.\n- Action-oriented: every section leads to a concrete action.\n\n**No-gos:**\n- No technical implementation details that end users do not need.\n- No assumptions about prior knowledge, unless the target audience is defined that way.\n- No unexplained jargon.\n- Do not hide or soften safety notes.\n\n**Compliance:**\n- Safety notes must be correct and complete.\n- Follow the given compliance standards exactly.\n- Explicitly document missing information from the technical documentation rather than inventing it.\n\n## Quality control\n\n**Self-check before output:**\n1. Clarity: would a person without a technical background understand the guide?\n2. Completeness: are all necessary steps documented, is any critical information missing?\n3. Safety: are all safety notes correct, complete and prominently placed?\n\n**Escalate to a human:**\n- When critical safety information is missing from the source documentation.\n- When the target audience is not clearly defined.\n- When compliance requirements remain unclear.\n\n## Trigger and input schema\n\n**Start trigger:** \"Create a product guide from this technical documentation\" or \"Give me feedback on this product guide.\"\n\n**Required inputs:**\n1. Technical documentation or guide draft (text, structure, content).\n2. Target audience (for example beginners without technical background, IT professionals).\n3. Product name and context (what the product is, what it is used for).\n\n**Input validation:**\n- Check whether the technical documentation contains sufficient information.\n- Check whether the target audience is clearly defined.\n- If inputs are incomplete, ask specifically for the missing information before starting.", "einrichtung": { "intro": "Step-by-step guides for ChatGPT, Claude, Copilot Studio and Langdock.", "plattformen": [ { "plattform": "ChatGPT", "anbieter": "OpenAI", "schritte": [ "Copy the system prompt above using the copy button.", "Open chatgpt.com/create, or go to \"Explore GPTs\" and then \"Create\".", "Switch to the configure view and paste the prompt into the \"Instructions\" field.", "Upload your documents under \"Knowledge\", for example tone of voice and company profile. Up to 20 files are supported.", "Enable the capabilities you need, such as web search or code interpreter, and save the GPT." ], "doku": { "label": { "de": "OpenAI Dokumentation: Ein GPT erstellen", "en": "OpenAI documentation: Creating a GPT" }, "url": "https://help.openai.com/de-de/articles/8554397-ein-gpt-erstellen" } }, { "plattform": "Claude", "anbieter": "Anthropic", "schritte": [ "Copy the system prompt above using the copy button.", "Open claude.ai/projects and click \"New project\".", "Paste the prompt into the \"Project instructions\" field.", "Upload your documents under \"Project knowledge\". Claude draws on them in every chat in the project.", "Available from the Pro plan. Extended project knowledge scales the capacity automatically." ], "doku": { "label": { "de": "Anthropic Dokumentation: Was sind Projekte?", "en": "Anthropic documentation: What are Projects?" }, "url": "https://support.claude.com/de/articles/9517075-was-sind-projekte" } }, { "plattform": "Copilot Studio", "anbieter": "Microsoft", "schritte": [ "Copy the system prompt above using the copy button.", "Open copilotstudio.microsoft.com and describe your agent in one sentence.", "Go to \"Instructions\", then \"Edit\", and paste the prompt.", "Upload files under \"Knowledge\", or connect SharePoint and websites.", "Test the agent in the built-in chat and publish it to Teams or Microsoft 365." ], "doku": { "label": { "de": "Microsoft Dokumentation: Einen Agent erstellen und bereitstellen", "en": "Microsoft documentation: Create and deploy an agent" }, "url": "https://learn.microsoft.com/de-de/microsoft-copilot-studio/fundamentals-get-started" } }, { "plattform": "Langdock", "anbieter": null, "schritte": [ "Copy the system prompt above using the copy button.", "Open the agents overview and click \"Create agent\".", "Paste the prompt into the \"Instructions\" field. Up to 40,000 characters are supported.", "Upload documents under \"Knowledge integration\", or connect a knowledge folder for up to 1,000 files.", "Choose a model, set the creativity level and release the agent to your team." ], "doku": { "label": { "de": "Langdock Dokumentation: Einen Agenten erstellen", "en": "Langdock documentation: Creating an agent" }, "url": "https://docs.langdock.com/de/resources/agent-creation" } } ] }, "itemIcon": "languages", "recommended": [ { "slug": "blogartikel-drehbuch", "category": "skill", "name": "The Blog Article Script", "teaser": "Turns a topic into a publication-ready, SEO-optimized blog article, complete with structure, meta data and distribution suggestions.", "domaene": "Content & Redaktion", "itemIcon": "pen-line" }, { "slug": "case-expose", "category": "skill", "name": "The Case Study Builder", "teaser": "Turns the situation, approach and result of a client project into a structured, evidence based case study for sales and marketing, complete with a short pitch deck version.", "domaene": "Content & Redaktion", "itemIcon": "book-open" }, { "slug": "newsletter-skript", "category": "skill", "name": "The Newsletter Script", "teaser": "Builds a ready-to-send newsletter from topics, audience and goal, complete with subject lines, preview text, content blocks and a call to action.", "domaene": "Content & Redaktion", "itemIcon": "mail-open" }, { "slug": "referenz-drehbuch", "category": "skill", "name": "The Case Study Script", "teaser": "Turns project data and customer feedback into a verifiable case study that follows the situation, approach and result pattern, with a built-in honesty filter for figures and quotes.", "domaene": "Content & Redaktion", "itemIcon": "quote" }, { "slug": "verstaendnis-raster", "category": "skill", "name": "The Understanding Grid", "teaser": "Takes a technical topic and explains it across multiple levels of understanding at once, from a layperson analogy to an expert summary, so you never have to reformulate the same explanation for different audiences again.", "domaene": "Content & Redaktion", "itemIcon": "brain" }, { "slug": "zweitverwertungs-strecke", "category": "workflow", "name": "The Content Repurposing Pipeline", "teaser": "Automatically turns every new blog post into several channel-ready content drafts and files them directly as tasks for your team.", "domaene": "Content & Redaktion", "itemIcon": "recycle" }, { "slug": "content-zweitverwerter", "category": "assistent", "name": "The Content Repurposer", "teaser": "Turns a single long piece, such as a podcast, webinar or article, into five to ten channel-ready formats, from LinkedIn posts to newsletter snippets, that publish without further editing.", "domaene": "Content & Redaktion", "itemIcon": "recycle" }, { "slug": "fallstudien-schreiber", "category": "assistent", "name": "The Case Study Writer", "teaser": "Builds a sales ready, verifiable case study from project data, customer feedback and results, following the situation, approach, outcome pattern, with a built-in honesty filter for figures and claims.", "domaene": "Content & Redaktion", "itemIcon": "book-open" }, { "slug": "fragen-antworten-schreiber", "category": "assistent", "name": "The FAQ Writer", "teaser": "Creates a structured FAQ catalog from a product, service or topic text: clear questions, concise answers, everything verifiable in the source text.", "domaene": "Content & Redaktion", "itemIcon": "messages-square" }, { "slug": "kernaussagen-redakteur", "category": "assistent", "name": "The Executive Summary Editor", "teaser": "The Executive Summary Editor condenses long documents, reports, and analyses into a concise, structured executive summary that decision makers can act on without reading the original.", "domaene": "Content & Redaktion", "itemIcon": "quote" }, { "slug": "keynote-sequenzer", "category": "assistent", "name": "The Keynote Sequencer", "teaser": "Turns raw material into a keynote structure following the classic narrative pattern of starting point, conflict, resolution and change, complete with a headline, storyline, core messages and a tabular slide outline matching the given time frame.", "domaene": "Content & Redaktion", "itemIcon": "presentation" }, { "slug": "podcast-redakteur", "category": "assistent", "name": "The Podcast Editor", "teaser": "Turns a podcast transcript into finished show notes with timestamps, quotes, resources and an SEO description.", "domaene": "Content & Redaktion", "itemIcon": "podcast" }, { "slug": "content-konzept", "category": "skill", "name": "The Content Plan", "teaser": "This skill turns a time period and focus areas into a prioritized content plan with topic ideas, format assignments, a schedule and a clear top 3.", "domaene": "Content & Redaktion", "itemIcon": "layout-template" }, { "slug": "leitfaden-skript", "category": "skill", "name": "The Guide Script", "teaser": "Builds a complete chapter outline for a whitepaper or e-book from topic, audience, and goal, including a full marketing plan.", "domaene": "Content & Redaktion", "itemIcon": "map-pin" }, { "slug": "praesentations-expose", "category": "skill", "name": "The Presentation Blueprint", "teaser": "Develops the thinking architecture of a presentation from topic, audience and context before the first slide exists: core message, story arc, slide titles, visual ideas and slide types, brought together in one table.", "domaene": "Content & Redaktion", "itemIcon": "presentation" }, { "slug": "redaktions-schema", "category": "skill", "name": "The Editorial Calendar Framework", "teaser": "Builds a complete, funnel-balanced editorial calendar with topics, formats, channels and a repurposing plan from your content pillars and audience.", "domaene": "Content & Redaktion", "itemIcon": "calendar-days" }, { "slug": "content-sequenzer", "category": "assistent", "name": "The Content Sequencer", "teaser": "Builds a cross-channel content plan with topic clusters, a content matrix and a four-week editorial calendar from your target audience, marketing goals and available channels.", "domaene": "Content & Redaktion", "itemIcon": "list-ordered" }, { "slug": "geschaeftsmail-schreiber", "category": "assistent", "name": "The Business Email Writer", "teaser": "The Business Email Writer turns bullet points or a rough draft into a ready-to-send business email, complete with a compelling subject line and a clear call to action.", "domaene": "Content & Redaktion", "itemIcon": "mail" }, { "slug": "hausstil-lektor", "category": "assistent", "name": "The House Style Editor", "teaser": "Checks German texts for spelling, grammar and punctuation and flags every deviation from the mandatory house style rules of formal address and zero dashes in a clear, traceable correction table.", "domaene": "Content & Redaktion", "itemIcon": "spell-check" }, { "slug": "deepl", "category": "tool", "name": "DeepL", "teaser": "Translation service for text, documents, and speech, with glossaries, tone control, and an API for embedding it into your own applications.", "domaene": "Content & Redaktion", "logoFile": "deepl.svg", "logoEinzug": 1 } ] }