A bug report that saves hours of follow-up questions has a fixed shape: reproducible steps, a clear separation between what should happen and what actually happens, complete environment data, and an assessment of urgency. This protocol takes an unstructured report, whether it comes from support, QA, or directly from the product team, and shapes it into exactly that pattern.
\nIt is built for anyone who passes bugs on to a development team without working in a ticketing system every day: customer reports, internal observations, test logs. The result can be entered directly into Jira, Linear, or GitHub Issues.
\nThe protocol does not judge whether a reported behavior is actually a bug, and it estimates severity only as well as the information provided allows. Where environment data or reproduction steps are missing, the assistant flags this as an open gap instead of inventing it.
\n" }, { "id": "skill-text", "title": "Skill Text", "html": "Copy the prompt below in full into your AI tool. As a file: bugreport-protokoll.en.json
\n" } ], "schritte": [ { "nr": 1, "titel": "Describe the bug", "beschreibung": "The description states what happens and what was expected instead, supplemented with the available environment data.", "rolle": "mensch" }, { "nr": 2, "titel": "Understand the bug", "beschreibung": "The core of the problem is separated from the symptoms and captured as the starting point for structuring.", "rolle": "automatisch" }, { "nr": 3, "titel": "Structure the report", "beschreibung": "Title, reproduction steps, and expected versus actual behavior are brought into the fixed shape.", "rolle": "automatisch" }, { "nr": 4, "titel": "Assess severity and workaround", "beschreibung": "Urgency is estimated and any known workaround is documented.", "rolle": "automatisch" }, { "nr": 5, "titel": "Bug report", "beschreibung": "The finished, structured report is ready for direct entry into the ticketing system.", "rolle": "ergebnis" } ], "herausgeber": "Voyage Digital", "version": "2.0", "stand": "2026-07-26", "umsetzung": [ { "titel": "Copy the skill text", "text": "The skill text is copied into the chosen AI tool, and the bug is described the way it was noticed." }, { "titel": "Add environment data", "text": "Browser, operating system, and screenshots are added, they noticeably increase the value of the bug report." }, { "titel": "Review the result", "text": "The finished report is reviewed and entered directly into the ticketing system, for example Jira, Linear, or GitHub Issues." } ], "zutaten": [ "Bug description", "Environment data" ], "beispielSzenario": "A customer reports that the app keeps crashing whenever they click the button. This description is passed to the AI, along with the browser and operating system. What comes back is a structured bug report with a searchable title, five exact reproduction steps, complete environment data, and the assessment Major, functional limitation, with the workaround of temporarily using a desktop browser.", "eingaben": [ { "feld": "Bug description: what happens, what should happen instead", "pflicht": true }, { "feld": "Steps to reproduce, rough or detailed", "pflicht": true }, { "feld": "Environment: browser, operating system, version, device", "pflicht": false }, { "feld": "Screenshots, logs, frequency, impact", "pflicht": false } ], "ausgabe": "A nine-part bug report with title, summary, numbered reproduction steps, expected and actual behavior, environment data, severity estimate, workaround, and supplementary information.", "prompt": "# DESCRIPTION\nYou turn bug descriptions into structured, directly actionable bug reports. Focus: reproducibility, a clean separation between expected and actual behavior, complete environment information. Where information is missing, explicitly mark missing or assumed information as an assumption instead of silently filling it in.\n\n# INPUT\n- Bug description (what happens, what should happen instead)\n- Steps to reproduce, rough or detailed\n- Optional: screenshots or logs, environment (browser, operating system, version), frequency, impact\n\n# OUTPUT\nA structured bug report with the following sections:\n1. Title: short, descriptive, easy to find\n2. Summary: one sentence naming the problem\n3. Steps to reproduce: numbered, exact\n4. Expected behavior\n5. Actual behavior\n6. Environment: browser, operating system, version, device\n7. Severity and priority: Critical, Major, Minor, or Trivial\n8. Workaround, if one exists\n9. Additional information: logs, screenshots, context\n\n# CONTEXT\n- Reproducibility is the single most important criterion for a usable bug report.\n- Severity and priority are two different dimensions and are never mixed up.\n- A bug report addresses exactly one issue. Do not combine multiple symptoms into one report.\n- Screenshots and logs are valuable and are always included when available.\n\n# WORKING INSTRUCTIONS\n## Step 1: Understand the bug\nWork out the core of the problem from the user's description and separate it from pure symptoms.\n\n## Step 2: Formulate title and summary\nWrite a concise, searchable title and a one-sentence summary.\n\n## Step 3: Build reproduction steps\nDocument exact, numbered steps to reproduce the bug.\n\n## Step 4: Document expected and actual behavior\nDescribe both states clearly separated, without mixing them.\n\n## Step 5: Assess severity and workaround\nEstimate severity (Critical, Major, Minor, Trivial), capture environment information, and document a workaround if one is known. Where information is missing, flag this in the report as an open assumption instead of inventing it.\n\n# DEFINITION OF DONE\n[ ] Title is short, descriptive, and searchable\n[ ] Reproduction steps are exact and numbered\n[ ] Expected and actual behavior are clearly separated\n[ ] Environment information is complete or flagged as missing\n[ ] Severity is estimated\n[ ] The report addresses exactly one bug\n\n# ADDRESSING THE USER\nAddress the user in a professional manner throughout.\n\n# CONVERSATION START\nWhich bug would you like to document? Describe the issue, what you expected, and what happened instead, and I will structure a clear bug report from it.", "einrichtung": { "intro": "Step-by-step guides for ChatGPT, Claude, Copilot Studio and Langdock.", "plattformen": [ { "plattform": "ChatGPT", "anbieter": "OpenAI", "schritte": [ "Copy the skill text above using the copy button.", "Click your profile picture and select \"Skills\".", "Click \"Create skill\" and paste the copied text as the instruction.", "Adjust inputs, outputs and format where your case requires it.", "Save the skill. It is available in all chats from that point on." ], "doku": { "label": { "de": "OpenAI Dokumentation: Skills in ChatGPT", "en": "OpenAI documentation: Skills in ChatGPT" }, "url": "https://help.openai.com/de-de/articles/20001066-skills-in-chatgpt" } }, { "plattform": "Claude", "anbieter": "Anthropic", "schritte": [ "Copy the skill text above using the copy button.", "Open claude.ai and go to \"Skills\" in your profile.", "Create a new skill and paste the copied text as the instruction.", "The skill works in claude.ai, in Claude Code and through the API.", "Available on the Pro, Max, Team and Enterprise plans." ], "doku": { "label": { "de": "Anthropic Dokumentation: Benutzerdefinierte Skills erstellen", "en": "Anthropic documentation: Creating custom skills" }, "url": "https://support.claude.com/de/articles/12512198-benutzerdefinierte-skills-erstellen" } }, { "plattform": "Copilot Studio", "anbieter": "Microsoft", "schritte": [ "Copy the skill text above using the copy button.", "Open Copilot Studio and create a new agent.", "Paste the copied text as the instruction.", "Connect knowledge sources and tools where needed.", "Publish the agent for yourself or for your organisation." ], "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 skill text above using the copy button.", "Open the sidebar and click \"Add skill\".", "Paste the copied text directly as the instruction.", "Connect the skill to integrations such as Gmail or Slack where needed.", "Save the skill and release it for yourself or your team." ], "doku": { "label": { "de": "Langdock Dokumentation: Skills", "en": "Langdock documentation: Skills" }, "url": "https://docs.langdock.com/de/product/chat/skills" } } ] }, "itemIcon": "bug", "recommended": [ { "slug": "api-drehbuch", "category": "skill", "name": "The API Playbook", "teaser": "The API Playbook turns a technical API specification into complete, developer-friendly documentation, from a quick start guide to a full endpoint and error reference.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "webhook" }, { "slug": "anleitungs-dokumentierer", "category": "assistent", "name": "The Documentation Writer", "teaser": "Creates complete, understandable technical documentation from product information, technical specifications and a defined audience, from the product overview through installation and usage to troubleshooting and glossary.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "book-open-check" }, { "slug": "review-protokoll", "category": "skill", "name": "The Review Protocol", "teaser": "Turns rough code review notes into structured, constructive review feedback with severity-sorted remarks, rationale, and a clear approve/request-changes/comment recommendation.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "search-check" }, { "slug": "stripe-agent-skills", "category": "tool", "name": "Stripe Agent Skills", "teaser": "Stripe Agent Skills is Stripe's official collection of agent skills for best practices, project setup and version upgrades, giving AI coding agents current, correct patterns for building Stripe integrations.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "stripe-agent-skills.png", "logoEinzug": 0.78 }, { "slug": "mcp-builder", "category": "skill", "name": "The MCP Builder", "teaser": "Guides you through research, implementation, testing and evaluation of an MCP server: typed tools, clean error handling, pagination and ten verified evaluation questions for reliable access by a language model to an external service.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "plug" }, { "slug": "vba-uebersetzer", "category": "assistent", "name": "The VBA Translator", "teaser": "Translates automation tasks in Excel into working VBA code based on the concrete file structure, and debugs existing macros.", "domaene": "Softwareentwicklung & technische Infrastruktur", "itemIcon": "code" }, { "slug": "supabase", "category": "tool", "name": "Supabase", "teaser": "Supabase is an open source backend-as-a-service platform built on Postgres, providing database, authentication, storage, and edge functions in a single tool.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "supabase.png", "logoEinzug": 0.78 }, { "slug": "vercel", "category": "tool", "name": "Vercel", "teaser": "Git-centered deployment and hosting platform for web applications, with a built-in AI model gateway, isolated sandboxes for agent-generated code, and a security and observability stack in one interface.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "vercel.svg", "logoEinzug": 1 }, { "slug": "windsurf", "category": "tool", "name": "Windsurf", "teaser": "Windsurf is an AI native code editor built on VS Code, with an autonomous Cascade agent for multi file changes, fast context aware tab completion, and inline chat.", "domaene": "Softwareentwicklung & technische Infrastruktur", "logoFile": "windsurf.svg", "logoEinzug": 0.78 }, { "slug": "angebots-schiene", "category": "workflow", "name": "The Quote Pipeline", "teaser": "A workflow that automatically turns an incoming quote request into a reviewed quote draft, from requirements extraction through to sales approval.", "domaene": "Vertrieb & Outreach", "itemIcon": "file-badge" } ] }