Translation Coverage

Overview

You send the keys the product must have, then one catalog per locale. We count how many keys each locale still holds, which ones are missing, which extras appeared, and which listed emptyValueKeys are present but empty. Duplicate keys are refused. Locales are canonicalized through ICU. We do not read PO or JSON resource files and we do not judge translation quality. A successful call costs 1 execution credit.

A locale file that silently dropped a key is a production hole. Set comparison against the reference list is the mechanical answer.

When to use it

Scope

Non-goals

• Does not read PO, XLIFF or JSON resource files from disk
• Does not judge translation quality or placeholder compatibility
• Does not merge catalogs or infer a source locale

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.translation_coverage","input":{"referenceKeys":["app.title","app.save"],"catalogs":[{"locale":"FR","keys":["app.title"]}]}}'

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

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

const { output } = await sq.execute("localization.translation_coverage", {"catalogs":[{"locale":"FR","keys":["app.title"]}],"referenceKeys":["app.title","app.save"]});

Errors

Other limits

Limitations

• Does not read PO, XLIFF or JSON resource files from disk
• Does not judge translation quality or placeholder compatibility
• Does not merge catalogs or infer a source locale
• Parsing a Gettext file
• Checking whether {count} survived inside a message

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "localization.translation_coverage",
  "input": {
    "catalogs": [
      {
        "locale": "FR",
        "keys": [
          "app.title"
        ]
      }
    ],
    "referenceKeys": [
      "app.title",
      "app.save"
    ]
  }
}

Examples

{
  "catalogs": [
    {
      "locale": "FR",
      "keys": [
        "app.title"
      ]
    }
  ],
  "referenceKeys": [
    "app.title",
    "app.save"
  ]
}

{
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "truncated": false,
  "localeCount": 1,
  "locales": [
    {
      "locale": "fr",
      "total": 2,
      "present": 1,
      "missing": 1,
      "extra": 0,
      "empty": 0,
      "presentRatio": 0.5,
      "emptyRatio": 0,
      "missingKeys": [
        "app.save"
      ],
      "extraKeys": [],
      "emptyKeys": []
    }
  ],
  "referenceKeyCount": 2
}

{
  "referenceKeys": [],
  "emptyValueKeys": [],
  "catalogs": [
    {
      "locale": "de-DE",
      "keys": [
        "obsolete"
      ]
    }
  ]
}

{
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "truncated": false,
  "localeCount": 1,
  "locales": [
    {
      "locale": "de-DE",
      "total": 0,
      "present": 0,
      "missing": 0,
      "extra": 1,
      "empty": 0,
      "missingKeys": [],
      "extraKeys": [
        "obsolete"
      ],
      "emptyKeys": []
    }
  ],
  "referenceKeyCount": 0
}

Recommended use cases

• Measuring how complete fr-FR still is against the English key list
• Spotting extra keys a translator added that the product no longer ships

Avoid for

• Parsing a Gettext file
• Checking whether {count} survived inside a message

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