Skip to main content

Squillify development is paused indefinitely. Read why, and discover what this experiment achieved. Read the story

MicroSkills Reference

Text Slugifier

text.slugify

ProductionBounded custom (Class B)Deterministicstrictinstantv1.0.0
No network

Overview

Deterministic slug generator: lowercases, trims, replaces spaces/underscores with hyphens, removes non-alphanumeric characters, collapses multiple hyphens, and enforces a maximum length with safe truncation.

URL slugs need consistent rules — we lower-case, hyphenate, and truncate deterministically so you never depend on model formatting.

Reliability

STRICT and deterministic — identical input always yields identical slug. Max length 80, truncated on a character boundary with any trailing hyphen removed. Input validation (not retryable): missing or non-string text; text larger than 2,048 UTF-8 bytes.

Context footprint

Replaces ~200 tokens of LLM reasoning (prompt + generation) with a single tool call. Eliminates ambiguity about hyphenation, casing, and special character handling. A successful call costs 1 execution credit.

When to use it

When you need a URL-safe slug from a title, name, or label.

Do not use for non-Latin script transliteration (CJK, Arabic, Cyrillic stay dropped), full URL encoding, or globally unique IDs (use platform.entropy_token).

Scope

Note
We turn your title or label into a clean, URL-safe slug — lower-case, hyphenated, special characters removed, max 80 characters with safe truncation.

Non-goals

  • Does not transliterate non-Latin scripts (CJK, Arabic, Cyrillic)
  • Does not generate unique slugs or check for collisions
  • Does not perform URL encoding — output is already URL-safe

Properties

IdempotentRetry safeStreaming supportedFile input supportedRequires external service

Capabilities

formattingtext-processing

Cost & billing

Flat rate per invocation

MetercallsBillable onsuccessCost per call1 credit

File handling

Accepts file_refProduces file_refMax input2 KB

How we handle your data

Sensitive output possible
What this means

This skill may receive sensitive content and may return submitted, transformed, extracted, or reformatted content.

Squillify guarantees
  • Runs inside Squillify
  • This skill runs inside Squillify.
  • Payloads are not sent to an external service by this skill.
  • Squillify does not permanently store submitted payloads.
  • Telemetry records metadata only, not submitted content.
  • Submitted payloads are not used for training.
  • Submitted payloads are not reviewed by humans.
  • This skill does not target sensitive data.
  • The response may contain submitted or transformed content.
Your responsibility

Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.

Read the Microskill Data Handling Policy

Input schema

FieldTypeRequiredDescription
textstringYesTitle, name, or label to slugify under the UTF-8 byte ceiling.

Output schema

FieldTypeRequiredDescription
slugstringYesLowercase ASCII slug or empty when no character survives.

API contract

POST /v1/execute
curl
curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"text.slugify","input":{"text":"Hello World"}}'
Integrations
TypeScript SDK
import { Squillify } from "@squillify/sdk";

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

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

Errors

CodeHTTPRetryableDescription
VALIDATION_ERROR400NoThe request payload failed schema validation.
UNAUTHORIZED401NoMissing or invalid API key.
SKILL_NOT_ACCESSIBLE403NoThe API key is not granted access to this skill.
SKILL_NOT_AVAILABLE_FOR_PLAN403NoThis skill is not included in your current plan.
PLAN_ELIGIBILITY_UNAVAILABLE503YesPlan eligibility could not be decided. Retry after backoff.
SKILL_NOT_FOUND404NoThe requested skill or version does not exist.
TENANT_RATE_LIMITED429YesRequest rate limit exceeded. Retry after backoff.
QUOTA_EXCEEDED429YesPlan quota exhausted. Retryable once the quota period resets.
EXECUTION_TIMEOUT504YesExecution exceeded the allowed time budget.

Other limits

LimitValue
Recommended inline bytes32 KiB

Limitations

  • Does not transliterate non-Latin scripts (CJK, Arabic, Cyrillic)
  • Does not generate unique slugs or check for collisions
  • Does not perform URL encoding — output is already URL-safe
  • Full URL encoding (use a URL encoder instead)
  • Non-Latin script transliteration (use a dedicated transliterator)
  • Generating globally unique identifiers (use platform.entropy_token)

How to call

POST /v1/execute (requires authentication)

Request bodyjson
{
  "skillKey": "text.slugify",
  "input": {
    "text": "Hello World"
  }
}

Examples

Basic usage

Inputjson
{
  "text": "Hello World"
}
Expected outputjson
{
  "slug": "hello-world"
}

Accented Latin characters

Inputjson
{
  "text": "Café — résumé (2026)"
}
Expected outputjson
{
  "slug": "cafe-resume-2026"
}
Tip
Combining marks are removed after Unicode NFD decomposition, so accented Latin letters collapse to their base letter (é → e). Symbols are dropped.

Collapse repeated separators

Inputjson
{
  "text": "Q3 Report -- Draft___v2"
}
Expected outputjson
{
  "slug": "q3-report-draft-v2"
}
Tip
Spaces, underscores, and runs of hyphens all collapse into one hyphen, and leading or trailing hyphens are trimmed

Empty after cleaning

Inputjson
{
  "text": "!!!"
}
Expected outputjson
{
  "slug": ""
}
Tip
Input with no alphanumeric characters produces an empty slug
  • Generate URL-friendly slugs from article titles or product names
  • Create stable identifiers from human-readable strings
  • Sanitize user input for use in file paths or database keys

Avoid for

  • Full URL encoding (use a URL encoder instead)
  • Non-Latin script transliteration (use a dedicated transliterator)
  • Generating globally unique identifiers (use platform.entropy_token)

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

texturltransformation