Compare Message Placeholders

Overview

You send a source string, a translation, and the placeholder syntax. We inventory every placeholder in both, then tell you which names the translation dropped, which names it added, and which ICU argument types no longer match. SIMPLE_BRACES reads {name} with doubled braces and apostrophes as escapes. ICU_MESSAGE uses the ICU parser so nested plural and select arguments keep their types. We never format, never execute the template, and never judge translation quality. A successful call costs 1 execution credit.

A missing placeholder in a translation is a runtime hole. Comparing names and ICU usages is a mechanical check a model cannot prove from the strings alone.

When to use it

Scope

Non-goals

• Does not score translation quality or fluency
• Does not format or execute the message
• Does not auto-detect printf, Mustache or other template families

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"localization.message_placeholders_compare","input":{"source":"Hello {name}","translation":"Bonjour","syntax":"SIMPLE_BRACES"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("localization.message_placeholders_compare", {"syntax":"SIMPLE_BRACES","source":"Hello {name}","translation":"Bonjour"});

Errors

Other limits

Limitations

• Does not score translation quality or fluency
• Does not format or execute the message
• Does not auto-detect printf, Mustache or other template families
• Asking whether the wording is a good translation
• Rendering the message with real values

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "localization.message_placeholders_compare",
  "input": {
    "syntax": "SIMPLE_BRACES",
    "source": "Hello {name}",
    "translation": "Bonjour"
  }
}

Examples

{
  "syntax": "SIMPLE_BRACES",
  "source": "Hello {name}",
  "translation": "Bonjour"
}

{
  "truncated": false,
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "compatible": false,
  "diagnostics": [],
  "sourceArguments": [
    {
      "name": "name",
      "usage": "SIMPLE",
      "occurrences": 1
    }
  ],
  "translationArguments": [],
  "syntax": "SIMPLE_BRACES",
  "missingPlaceholders": [
    "name"
  ],
  "extraPlaceholders": [],
  "usageMismatches": []
}

{
  "syntax": "ICU_MESSAGE",
  "source": "{count, plural, one {# file} other {# files}}",
  "translation": "{count, plural, one {# fichier} other {# fichiers}}"
}

{
  "truncated": false,
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "compatible": true,
  "diagnostics": [],
  "sourceArguments": [
    {
      "name": "count",
      "usage": "PLURAL",
      "occurrences": 1
    }
  ],
  "translationArguments": [
    {
      "name": "count",
      "usage": "PLURAL",
      "occurrences": 1
    }
  ],
  "syntax": "ICU_MESSAGE",
  "missingPlaceholders": [],
  "extraPlaceholders": [],
  "usageMismatches": []
}

Recommended use cases

• Catching a dropped {count} before a localized build ships
• Checking that an ICU plural argument stayed a plural in the translation

Avoid for

• Asking whether the wording is a good translation
• Rendering the message with real values

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags