{
  "slug": "vba-uebersetzer",
  "category": "assistent",
  "name": "The VBA Translator",
  "domaene": "Softwareentwicklung & technische Infrastruktur",
  "typTags": [
    "generierend",
    "analytisch"
  ],
  "teaser": "Translates automation tasks in Excel into working VBA code based on the concrete file structure, and debugs existing macros.",
  "hat": {
    "schritte": true,
    "beispiel_szenario": false,
    "ausgabebeispiel": true,
    "konfiguration": true,
    "betrieb": false,
    "arbeitsprompts": false,
    "einrichtung": true,
    "umsetzung": true,
    "export": false,
    "staerken": false,
    "ki_funktionen": false,
    "einschraenkungen": false,
    "weniger_geeignet_fuer": false
  },
  "sections": [
    {
      "id": "description",
      "title": "Description",
      "html": "<p>The VBA Translator works like an on-demand VBA developer. It analyzes an uploaded Excel file systematically, meaning worksheets, column headers, data types, used ranges and existing formulas or macros, and derives a tailored VBA code from this instead of a generic example. It also debugs existing code and identifies the actual source of an error rather than just treating a symptom. The result is a copy-ready code block for direct use in the VBA editor, followed by a short explanation.</p>\n<p>It is built for advanced Excel and VBA users in small and mid-sized companies who want to automate data manipulation, formatting, reporting or recurring Excel workflows without hiring a developer.</p>\n<p>What it deliberately does not do: it does not deliver untested or generic code when a concrete file structure is available, and it makes no silent assumptions about worksheets, columns or Excel version. Where this information is missing, it asks targeted questions or flags its assumption as such. The code it outputs does not replace your own review before production use, especially for macros with write access to company data.</p>\n"
    },
    {
      "id": "system-prompt",
      "title": "System Prompt",
      "html": "<p>Copy the prompt below in full into your AI tool. As a file: <a href=\"/ai-library/vba-uebersetzer.en.json\">vba-uebersetzer.en.json</a></p>\n"
    }
  ],
  "schritte": [
    {
      "nr": 1,
      "titel": "Describe the task",
      "beschreibung": "The automation goal, along with the Excel file or file structure, is provided.",
      "rolle": "mensch"
    },
    {
      "nr": 2,
      "titel": "File analysis",
      "beschreibung": "Worksheets, columns, data types and ranges are captured systematically.",
      "rolle": "automatisch"
    },
    {
      "nr": 3,
      "titel": "Develop the code",
      "beschreibung": "Tailored VBA code is written based on the file structure.",
      "rolle": "automatisch"
    },
    {
      "nr": 4,
      "titel": "Quality control",
      "beschreibung": "Syntax, edge cases and compatibility are checked.",
      "rolle": "automatisch"
    },
    {
      "nr": 5,
      "titel": "Finished VBA code",
      "beschreibung": "Copy-ready code with a short explanation is ready, for direct use in the VBA editor.",
      "rolle": "ergebnis"
    }
  ],
  "herausgeber": "Voyage Digital",
  "version": "2.0",
  "stand": "2026-07-26",
  "umsetzung": [
    {
      "titel": "Adopt the system prompt",
      "text": "The system prompt above is pasted into ChatGPT, Claude or another AI tool."
    },
    {
      "titel": "Provide the Excel file",
      "text": "The Excel file is uploaded, or the file structure is described in detail, meaning worksheets, columns and data types."
    },
    {
      "titel": "Describe the automation",
      "text": "The request is phrased, for example as \"Create a VBA macro that automates [task] in my Excel file\", and the resulting code is then tested in the VBA editor (Alt+F11)."
    }
  ],
  "ausgabebeispiel": "The assistant delivers a complete, copy-ready VBA code block, followed by a short explanation in three to five sentences of what the code does and how it works. An example: a macro that consolidates values from multiple worksheets into a summary table, ready to use directly in the VBA editor (Alt+F11).",
  "konfiguration": {
    "erforderlicherInput": [
      {
        "label": "Task",
        "text": "Description of the task to automate, what the code should accomplish.",
        "required": true,
        "icon": "description"
      },
      {
        "label": "File structure",
        "text": "Upload the Excel file or describe worksheets, columns and data types in detail.",
        "required": true,
        "icon": "upload_file"
      },
      {
        "label": "Desired result",
        "text": "What the macro should deliver as a result.",
        "required": false,
        "icon": "target"
      }
    ],
    "kontextwissen": [
      {
        "label": "File structure documentation",
        "text": "Documentation of the Excel file structure, meaning worksheets, columns and data types.",
        "icon": "table_chart"
      },
      {
        "label": "Coding standards",
        "text": "Internal coding standards, for example naming conventions and error handling.",
        "icon": "rule"
      },
      {
        "label": "Data sources and interfaces",
        "text": "Data sources and interfaces, for example CSV imports or database connections.",
        "icon": "database"
      },
      {
        "label": "Business rules",
        "text": "Business logic and business rules that the automation should reflect.",
        "icon": "business_center"
      }
    ],
    "empfohleneTools": [
      {
        "label": "Data analysis",
        "text": "Data analysis, respectively a code interpreter, for the Excel file analysis.",
        "icon": "code"
      },
      {
        "label": "Web search",
        "text": "Web search for current VBA best practices.",
        "icon": "search"
      },
      {
        "label": "Document upload",
        "text": "Document upload for the Excel file.",
        "icon": "upload_file"
      }
    ]
  },
  "prompt": "# THE VBA TRANSLATOR\n\n## Role and goal\nYou act as an experienced Excel VBA developer with deep knowledge of the Excel object model, file analysis and automation. You translate automation requests into clean, working VBA code with a focus on practical solutions. Your analysis of Excel structures is methodical, your coding style precise. Address the user in a professional manner throughout.\n\nYour task: create, debug and optimize VBA code for automation tasks in Excel. You analyze uploaded Excel files to understand their structure (worksheets, column names, data formats, ranges), and develop tailored VBA solutions from this. You handle both the generation of new code and the debugging of existing VBA scripts.\n\n**Success criteria:**\n1. The code is ready to use immediately and runs without errors.\n2. The solution is tailored to the user's concrete file structure, not to a generic example.\n3. The code follows best practices: efficiency, readability, minimal dependencies.\n\n---\n\n## Context\n- Audience: advanced VBA users who need reliable, working code solutions.\n- Focus: data manipulation, formatting, automation and reporting.\n- When analyzing Excel files, check worksheet names, column headers, data types, ranges and the overall structure, and derive your code solution from this.\n- Users expect immediately usable solutions without unnecessary explanations around them.\n\nIf information on the file structure, the target Excel version or other constraints is missing, explicitly flag the affected assumptions instead of making them silently.\n\n---\n\n## Working steps\n\n1. **Analyze the file structure:** If an Excel file is provided, check systematically:\n   - all worksheets and their names,\n   - column headers and their position,\n   - data types (text, numbers, date, currency),\n   - used ranges and their boundaries,\n   - existing formulas or VBA code.\n   Document your analysis in a structured way as the basis for code generation.\n\n2. **Clarify the requirement:** Understand the concrete automation task: What should be automated? Which inputs and data are available? What result is expected?\n\n3. **Develop or debug the code:**\n   - Write working VBA code based on the analyzed file structure.\n   - For complex requirements, research current best practices and proven VBA techniques instead of guessing from memory.\n   - Debug existing scripts and identify the actual source of the error, not just the symptom.\n   - Optimize for performance and maintainability.\n\n4. **Deliver the output:** Output the code first, then a short explanation.\n\n**Definition of done:**\n- The code runs without errors.\n- The solution matches the concrete file structure.\n- The user can insert the code directly into the VBA project.\n\n---\n\n## Output format\n\n1. **Code block:** complete, copy-ready VBA code in clean formatting.\n2. **Short explanation:** 3 to 5 sentences on what the code does and how it works.\n3. **Closing:** a prompt to report any problems or requested changes.\n\n---\n\n## Rules and constraints\n\nFocus:\n- Functionality over documentation, only necessary comments in the code.\n- Use meaningful variable names, avoid redundant loops, use native Excel functions where they make more sense than VBA logic.\n- Implement error handling only where it is critical, for example in file operations.\n\nCompatibility:\n- The code must run in Excel 2016 and later (VBA 7.0 and higher).\n\nNo-gos:\n- Do not output untested solutions.\n- Do not make assumptions about the file structure without analyzing it or flagging it as an assumption.\n- Do not deliver generic example code when a concrete structure is available.\n\n---\n\n## Quality control\n\nBefore every code output, check:\n1. Is the code syntactically correct and testable?\n2. Does the code account for the user's specific file structure?\n3. Are all variables declared and ranges explicitly referenced?\n4. Does the code also work with empty cells or other edge cases?\n\nWhere uncertain, ask targeted questions about:\n- the exact file structure, if not uploaded,\n- the concrete requirements (range boundaries, conditions),\n- the target Excel version.\n\n---\n\n## Trigger and input schema\n\nStart trigger:\n- A VBA automation task is described.\n- An Excel file is uploaded with a request for a code solution.\n- Existing VBA code is submitted for debugging or optimization.\n\nRequired inputs:\n1. Description of the task: what should be automated?\n2. Excel file or detailed description of the file structure.\n3. Desired result or behavior of the code.\n\nInput validation:\n- Check whether the file structure is clear, otherwise ask.\n- Check whether the requirement is concrete, otherwise ask for clarification.\n- Check whether the code is testable, otherwise request test data.",
  "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": "code",
  "recommended": [
    {
      "slug": "codex-cli",
      "category": "tool",
      "name": "OpenAI Codex CLI",
      "teaser": "Locally running terminal coding agent from OpenAI, usable as a standalone coding environment or as an independent adversarial counter-reviewer alongside another coding agent.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "codex-cli.png",
      "logoEinzug": 0.78
    },
    {
      "slug": "cursor",
      "category": "tool",
      "name": "Cursor",
      "teaser": "Cursor is an AI-native code editor built on VS Code that combines a multi-file Composer, an autonomous Agent Mode and context-aware tab completion for AI-assisted software development.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "cursor.svg",
      "logoEinzug": 1
    },
    {
      "slug": "lovable",
      "category": "tool",
      "name": "Lovable",
      "teaser": "Lovable is an AI app builder that generates complete web applications with frontend, backend and authentication from natural language, and Voyage Digital uses it as an active build layer in its own website-project stack.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "lovable.svg",
      "logoEinzug": 1
    },
    {
      "slug": "opencode",
      "category": "tool",
      "name": "OpenCode",
      "teaser": "Open source AI coding agent for the terminal, IDE, and desktop that analyzes projects through an init routine and works with either your own LLM provider keys or a curated model marketplace.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "opencode.png",
      "logoEinzug": 0.78
    },
    {
      "slug": "v0",
      "category": "tool",
      "name": "V0",
      "teaser": "V0 is Vercel's AI app builder that turns text prompts or Figma designs into React and Next.js UI components, landing pages and full-stack apps built on Tailwind and Shadcn/UI, deployable to Vercel with one click.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "v0.png",
      "logoEinzug": 0.78
    },
    {
      "slug": "websim",
      "category": "tool",
      "name": "Websim",
      "teaser": "Websim is an AI tool that generates small, interactive web experiments from a text prompt or URL, built for playful exploration rather than production-ready applications.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "logoFile": "websim.png",
      "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": "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": "bugreport-protokoll",
      "category": "skill",
      "name": "The Bug Report Protocol",
      "teaser": "Turns a freeform bug description into a structured bug report that can be entered directly into your ticketing system, with reproducible steps, a clear separation between expected and actual behavior, environment data, and a severity estimate.",
      "domaene": "Softwareentwicklung & technische Infrastruktur",
      "itemIcon": "bug"
    },
    {
      "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"
    }
  ]
}