Grapheme Cluster Counter

Overview

You pass text (or a file_ref); we count grapheme clusters — what users perceive as characters — using Unicode extended grapheme boundaries, correctly handling emoji sequences and combining marks. Optionally return individual segments. Do not use this for code-point or byte sizing.

Most string.length() functions count code units, not what users see — we count what humans perceive as characters.

When to use it

Scope

Non-goals

• Does not count code points or bytes
• Does not normalize emoji

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

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":"text.count_graphemes","input":{"text":"Hello 👋🏽"}}'

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

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

const { output } = await sq.execute("text.count_graphemes", {"text":"Hello"});

Errors

Other limits

Limitations

• Does not count code points or bytes
• Does not normalize emoji
• Code point counting (use text.count_characters)
• Byte estimation (use text.count_bytes)

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "text.count_graphemes",
  "input": {
    "text": "Hello"
  }
}

Examples

{
  "text": "Hello"
}

{
  "warnings": [
    "Unicode version is provided by the runtime and not explicitly pinned."
  ],
  "normalization": "none",
  "count": 5,
  "skill": "text.count_graphemes",
  "policy": "unicode_extended_grapheme_cluster",
  "unit": "grapheme_cluster",
  "unicode_version": "runtime_default",
  "normalized": false
}

{
  "text": "👨‍👩‍👧‍👦"
}

{
  "warnings": [
    "Unicode version is provided by the runtime and not explicitly pinned."
  ],
  "normalization": "none",
  "count": 1,
  "skill": "text.count_graphemes",
  "policy": "unicode_extended_grapheme_cluster",
  "unit": "grapheme_cluster",
  "unicode_version": "runtime_default",
  "normalized": false
}

Recommended use cases

• Validate visible text length for UI fields
• Count emoji accurately
• Measure user-perceived string length

Avoid for

• Code point counting (use text.count_characters)
• Byte estimation (use text.count_bytes)

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