Update to DeepL

{
  "description": "A short first-run tour of DeepL that ends with a real result on the user's own content: a translated\ntext or file and, on plans that support it, a first set of saved company terms. Use when the user is new\nto DeepL or just connected it and asks \"get started with DeepL\", \"what can DeepL do?\", \"show me how\nDeepL works\", \"help me try DeepL\", \"set up DeepL\" or \"onboard me\". Not for a concrete translation,\nrewrite or glossary request: handle those directly.\n",
  "included_files": [],
  "name": "getting-started",
  "skill_md_contents": "---\nname: getting-started\ndescription: |\n  A short first-run tour of DeepL that ends with a real result on the user's own content: a translated\n  text or file and, on plans that support it, a first set of saved company terms. Use when the user is new\n  to DeepL or just connected it and asks \"get started with DeepL\", \"what can DeepL do?\", \"show me how\n  DeepL works\", \"help me try DeepL\", \"set up DeepL\" or \"onboard me\". Not for a concrete translation,\n  rewrite or glossary request: handle those directly.\nlicense: MIT\nmetadata:\n  author: DeepL\n  version: \"1.0\"\n---\n\n# Getting started with DeepL\n\n## What this skill does\n\nGets a new user to one real result in a few turns, on their own content, instead of a feature tour.\nThe user shares something they actually work on, DeepL translates it, and, when the plan allows, DeepL\nsaves the terms from it that should always be translated the same way. The user leaves knowing what\nDeepL did for them and how to ask for it next time.\n\n## Rules for every step\n\n- **Keep the workflow out of sight.** Never tell the user about steps, paths (Pro, Free), plans you\n  inferred, tool names or this skill. Write no text before or between tool calls.\n- **Show, then ask.** Ask one question per message. Apart from results, write at most three short\n  sentences. Every step can be skipped. If the user wants to stop, stop.\n- **Keep one conversation language.** Talk in the language of the user's first message to you, the one\n  that started this tour, and keep it for the whole tour. Never switch to the target language of a\n  translation, and short replies such as a number or a picked option do not change it. Use plain words.\n  Do not say \"glossary\" or \"style rule\" before step 3, and explain the word the first time you use it.\n- **Every translation comes from a DeepL tool.** Never translate, summarize a translation, or rebuild a\n  file yourself. If a DeepL tool fails, say what failed and offer the next step.\n- **Buttons only for a message that is just a question.** When a message shows anything else, such as\n  the introduction, a translation, a table of terms or a file link, write it and ask the question in\n  text with two to four numbered options in the same message. The host's tool that asks with clickable\n  options hides everything else you write in that message, so use it only when the question is the\n  whole message, such as asking for the language of the example.\n- **Nothing is saved without a yes.** Show the exact terms first, then create.\n- **Terms come only from the user's content.** Each source term must appear in the text you translated.\n  Never add terms from general knowledge.\n- **No sign-off.** Never end a message with a line such as \"Translated with DeepL\". The user already\n  knows who translated it.\n- **Say only what the tool results say** about files, links, limits and saved terms. Do not add details\n  such as how long a link works.\n\n## Workflow\n\n### 1. Get something real to translate\n\nReply right away, without calling any DeepL tool first: the first thing the user sees is this message.\nWrite it in plain text, without the option tool. Welcome the user, say in two sentences what DeepL is and\nwhat happens next, then ask the question with numbered options. For example:\n\n> Welcome to DeepL! DeepL is a translation AI that translates texts and whole files into many languages\n> and keeps the layout of your files. Let's try it on something of yours, it takes about a minute.\n>\n> What would you like to translate, and into which language?\n> 1. Paste a text\n> 2. Attach a file\n> 3. Show me an example\n\nWhat the options mean:\n\n1. **Paste a text**, such as an email, a product description or a paragraph from a document.\n2. **Attach a file** (Word, PowerPoint, Excel, PDF, HTML, text). DeepL keeps the layout.\n3. **Show me an example.**\n\nIf the user picks an option without naming a language, ask for the language in the same message that\nasks for their text or file, or, for the example, with the option tool and a few common languages plus\n\"Other\". Never guess the language. Infer the user's job and topic from what they share.\n\n- **Example:** use this text: \"Northwind Pay lets small shops accept card payments in minutes. Connect\n  your Northwind Pay terminal, open the Merchant Hub and set up your first payout. Payouts reach your\n  account within two business days.\"\n\n### 2. Translate it\n\nBefore the first DeepL call, check silently what the account can do. Load the DeepL tools if they are\ndeferred, then pick the path from the tools you see. No tool reports the plan, and the user is not asked.\n\n| What you see | Path |\n| --- | --- |\n| `list-glossaries` and `create-glossary` are listed | **Pro path.** Call `list-glossaries`. |\n| `list-glossaries` is listed, `create-glossary` is not | **Pro path without saving.** Skip step 3a. |\n| No glossary tools | **Free path.** |\n\n- **Every language the user asked for, in one call.** Both `translate-text` and `upload-document` take\n  several target languages at once, so never translate one language and offer the others later.\n- **Text** (pasted or the example): call `translate-text` with `targetLangs` and no `sourceLang`, so\n  that DeepL detects it. The result names the detected source language; use it as `sourceLang` in\n  step 3. Keep a text under 4,000 characters, because the Free plan limits a request to 5,000. For\n  longer text, translate the first part and say so.\n- **Free path:** send only the text or file and the target languages. The Free plan rejects\n  `formality`, `context`, `customInstructions`, `glossaryId` and `styleId`.\n- **File:** call `upload-document` and follow its result. Send the file to the upload URL yourself. If\n  you cannot, call `upload-document-show-fallback-widget` when the result says so, and tell the user to\n  pick the file in the widget. Then call `get-document-status` until the file is done and\n  `download-document` to give the user the link. Do not stop after the upload: the result is the\n  downloaded file.\n\nShow the result as it is. Add one sentence on what DeepL did, for example that it kept the layout of\nthe file.\n\n### 3a. Pro path: save the user's terms\n\nAlways offer this step after the first translation on the Pro path. Glossaries shared with the user's\nteam do not count as the user's own, so they are no reason to skip it.\n\n- **After the example:** the terms are not the user's, so do not save them. In the same message as\n  the translation, ask whether DeepL should learn the user's own product names and terms, with the\n  numbered options \"Paste my text\" and \"Not now\". If\n  the user pastes a text, translate it as in step 2, then continue below.\n- **After the user's own text or file:**\n  1. Pick up to 10 terms from the source text that must be translated the same way every time: product\n     and brand names, names of features or plans, and recurring terms of the user's field. For a file,\n     use its text if you can read it. Write each term in its dictionary form: in languages with cases,\n     such as Russian, German or Polish, use the nominative singular (\"Тихая Гавань\", not \"Тихой Гавани\").\n     Use the target term from DeepL's translation. A brand or product name keeps its source spelling.\n     Put first the terms that DeepL translated, because those are where the user's own wording matters.\n  2. Show them as a short table with one translation column per target language. In one sentence, say\n     that DeepL can save them as a glossary, a list of terms it applies to every text and file the user\n     translates. Then ask, in the same message as the translation and the table, with the numbered\n     options \"Save these terms\", \"Change some first\" and \"Not now\".\n  3. If the user already has a glossary of their own for this topic, add the terms to it with\n     `update-glossary-entries` instead of creating a second one. Otherwise call `create-glossary` with a\n     name such as \"<Company> terms\", then `update-glossary-entries` with the new glossary id, the\n     detected source language as `sourceLang`, `targetLang` and the approved entries, once for each\n     target language.\n  4. Translate the sentence that contains the most saved terms again with `translate-text`, `glossaryId`\n     and the same `sourceLang`: a glossary needs an explicit source language. Name the glossary, show\n     both versions, one under the other, and mark the terms that changed. If nothing changed, say so\n     plainly: DeepL already used these terms, and the glossary keeps them that way in future\n     translations.\n\nIf a glossary call fails because of permissions or plan limits, say so in one sentence and go to step 4.\n\n### 3b. Free path: show one more thing\n\nOffer one of these as numbered options, whichever fits what the user shared, and do it if they agree:\n\n- A pasted text: translate a real file with its layout kept, as in step 2.\n- A file: polish a text the user writes with `correct-text` or `rephrase-text`. The Free plan limits\n  such a text to 2,000 characters.\n\nThen name, in one sentence, the terms that DeepL Pro could save for them, such as two terms from their\ntext. Do not push an upgrade, and do not repeat it.\n\nIf a tool reports a limit or that the user needs DeepL Pro, explain it in plain words and suggest a\nshorter text.\n\n### 4. Wrap up\n\nIn two sentences:\n\n- what DeepL did: the translation, the file, and the glossary name with its number of terms if one\n  was saved;\n- how to ask next time, as one example request that names DeepL and fits what the user shared, such as\n  \"Translate this into German with DeepL and my Northwind terms\".\n\nThen, in the same message, ask one question about the next step with numbered options the user has not\ndone yet:\n\n| The user has | Options |\n| --- | --- |\n| Saved a glossary | Add another language to it · Translate a file with it · That's all |\n| Translated a text, no glossary | Translate a file with its layout kept · That's all |\n| Translated a file, no glossary | Translate a text · That's all |\n\nIf the user picks a step, go back to that step of the workflow. Offer this question once. After\n\"That's all\", stop. Do not list every DeepL feature.\n\n## Notes\n\n- **When the user arrives with a task**, do the task first and skip the tour. Offer step 3 afterwards\n  only if it fits.\n- **Several target languages:** translate into all of them in step 2, up to 10 in one call, and show the\n  before and after in step 3 for each of them.\n"
}