{
 "schema": "aiblocks-page/1",
 "id": "agency-language-translator",
 "type": "agent",
 "name": "Language translator agent",
 "summary": "Translate between English and Spanish in the right tone, with local words, pronunciation and cultural notes. Get natural phrases, not word swaps.",
 "headline": "Language translator agent",
 "subhead": "Give it a phrase, message or short document and say who it is for and where. It translates between English and Spanish in the right register for the country, adds how to say it, and flags what could cause offence or confusion.",
 "job": {
  "id": "write-and-tell-stories",
  "name": "Write and tell stories"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "short_text",
   "required": true,
   "label": "Short text",
   "what": "a short piece of text to reply to or work from: a post, comment, message, email or enquiry, with who wrote it and where"
  }
 ],
 "outputs": [
  {
   "type": "short_text",
   "required": true,
   "label": "Short text",
   "what": "a short piece of text to reply to or work from: a post, comment, message, email or enquiry, with who wrote it and where"
  }
 ],
 "you_give": [
  "The text or phrase to translate, and the direction, English to Spanish or Spanish to English",
  "Where it will be used, such as Mexico, Spain or Argentina",
  "Who it is for and the setting, such as a hotel clerk, a client, a doctor or a friend",
  "Spoken or written",
  "Words or names that must stay as they are (optional)"
 ],
 "you_get": [
  "The translation, in the tone and country you chose",
  "Whether it uses \"tú\", \"usted\" or \"vos\", and when to switch",
  "A pronunciation guide in English letters for spoken phrases",
  "A more natural spoken version beside the textbook version",
  "Notes on local words, false friends and culture",
  "A flag when a professional interpreter or certified translator is needed"
 ],
 "use_when": [
  "You travel to a Spanish-speaking country and need phrases for a hotel, a restaurant or a pharmacy.",
  "You write an email or message to a Spanish-speaking client, supplier or colleague.",
  "You are not sure if you should use \"tú\" or \"usted\" with someone.",
  "You read a sign, menu or short note in Spanish and want it explained, not only converted."
 ],
 "skip_when": [
  "You need another language pair. Use the Translator.",
  "You have a long article to translate with consistent terms. Use the Article translator.",
  "You got a customer message in another language and need a reply. Use the Customer support message translator.",
  "You need a certified translation of a legal, immigration or medical document, or a live interpreter. Hire a qualified professional.",
  "You want to learn to write Spanish with corrections. Use the Spanish and Turkish writing tutor."
 ],
 "output_sample": {
  "input": [
   "The text or phrase, and the direction",
   "The country where it will be used",
   "Who it is for and the setting",
   "Spoken or written",
   "Names or words that must stay as they are (optional)"
  ],
  "prerequisites": [
   "Claude, ChatGPT or Gemini"
  ],
  "output": [
   {
    "name": "Translation",
    "contains": "Your text in the other language, with a pronunciation guide for spoken phrases."
   },
   {
    "name": "Register and region",
    "contains": "The form of \"you\" used, the country it fits and a more natural spoken version."
   },
   {
    "name": "Cultural note",
    "contains": "What is polite or risky in that country, with a tip."
   },
   {
    "name": "Professional help needed",
    "contains": "A flag when a medical, legal or urgent text needs a qualified interpreter."
   },
   {
    "name": "Reverse phrases",
    "contains": "Replies you might hear, what they mean and how to answer."
   }
  ]
 },
 "output_shape": "TRANSLATION\n  Input (<English or Spanish>): <your text>\n  Output (<Spanish or English>): <translation>\n  Pronunciation: <respelling in English letters, for spoken phrases>\n\nREGISTER AND REGION\n  Register: <formal usted, informal tú or vos, or neutral> | Region: <country>\n  Alternate phrasing: <the natural spoken version>\n  Regional note: <local words that differ>\n\nCULTURAL NOTE\n  <phrase or situation> | <what is polite or risky> | <tip>\n\nPROFESSIONAL HELP NEEDED\n  <medical, legal or other flag> | <who to ask>\n\nREVERSE PHRASES\n  <reply you might hear> | <meaning> | <how to answer>",
 "how_to_use": [
  "Download the pack from this page and add it to your AI as a skill. If you cannot, paste SKILL.md into a new chat, then paste references/source-agent.md after it.",
  "Paste your text. Say the direction, the country, who it is for and if it is spoken or written.",
  "Type \"Translate this for a hotel clerk in Mexico\" or \"Give me ten restaurant phrases for Spain\".",
  "Read the register note and the cultural note before you use the phrase. Ask for the reverse translation if you need to understand a reply.",
  "For anything medical, legal or urgent, check with a qualified interpreter. In an emergency, lead with the phrase and call local emergency services."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "Text translator",
   "url": "https://useaiblocks.com/skills/translator",
   "why": "Tell it as a story"
  },
  {
   "name": "Customer support message translator",
   "url": "https://useaiblocks.com/skills/customer-support-message-translator",
   "why": "Customer support message translator"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/specialized/language-translator.md",
  "licence": "MIT",
  "original_name": "Language Translator",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Language Translator",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/specialized/language-translator.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions. On 2026-10-28 we made the SKILL.md input and next-step notes match the phrase-and-country inputs and the reviewed next steps."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-language-translator",
  "markdown": "https://useaiblocks.com/agents/agency-language-translator.md",
  "json": "https://useaiblocks.com/agents/agency-language-translator.json",
  "instructions": "https://useaiblocks.com/skills/agency-language-translator/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-language-translator.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-language-translator",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-language-translator",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
