Claude Code Skill · v1.0.0

Integrate with Claude Code

Give Claude Code full context on the AgileTrust Tokenization API — endpoints, auth, encoding modes, algorithm trade-offs, tweak rules, and PII-specific recipes — so your team can integrate in minutes instead of hours.

Download Skill Installation → View Source

Installation

Install the Skill

The skill is installed once per machine. After installation, Claude Code automatically loads it whenever you ask about tokenization, FPE, or AgileTrust integration.

Requires curl and tar (pre-installed on macOS and most Linux distros):

bash 
curl -L https://tokenization.qa.agiletrust.io/agiletrust-tokenization-skill.tar.gz \
  | tar -xz -C ~/.claude/skills/

Replace https://tokenization.qa.agiletrust.io with your production docs URL when deploying.

  1. Download agiletrust-tokenization-skill.tar.gz
  2. Create the skills directory if it doesn't exist: 
    mkdir -p ~/.claude/skills
  3. Extract the archive: 
    tar -xzf agiletrust-tokenization-skill.tar.gz -C ~/.claude/skills/
  4. Verify: 
    ls ~/.claude/skills/agiletrust-tokenization/SKILL.md

To install the skill for a specific project (all team members on the repo benefit when they clone it):

bash 
mkdir -p .claude/skills
curl -L https://tokenization.qa.agiletrust.io/agiletrust-tokenization-skill.tar.gz \
  | tar -xz -C .claude/skills/
# Commit .claude/skills/agiletrust-tokenization/ to your repo

Usage

How to Use the Skill

After installation, just ask Claude Code naturally. The skill triggers automatically when you mention tokenization, FPE, AgileTrust, or PII data types. You can also invoke it directly.

Direct invocation

/agiletrust-tokenization

This loads the full skill context and prints a usage summary.

Example interactions

Claude Code session — RUT tokenization
You
I need to tokenize a list of Chilean RUTs in Python. They look like "13301430-6". What endpoint and encoding should I use?
Claude
Use POST /tokenize with encoding: "numeric". The hyphen and check digit will be preserved automatically — you just pass the full RUT string. Here's a working snippet: tokenize("13301430-6", encoding="numeric") → "35240589-5". Note: recalculate the check digit after detokenizing if your system validates Modulo-11.
Claude Code session — algorithm choice
You
Should I use FF1 or FF3-1 for tokenizing 4-digit PINs?
Claude
Use FF1. FF3-1 requires a minimum of 6 decimal digits; a 4-digit PIN falls below that threshold and would use the keyed-substitution fallback instead of FPE. Create your application in the Admin Console with the FF1 algorithm selected to get proper FPE on 4-digit inputs.
Claude Code session — email tokenization
You
How do I tokenize email addresses while keeping them routable?
Claude
Tokenize only the local part (the part before @) and preserve the domain. For example, split user@example.com, tokenize user with encoding: "utf8" and tweak "656d61696c0000", then reassemble as token@example.com. The @ and .com stay intact for routing.

Trigger phrases

The skill activates automatically when you use phrases like:

"tokenize" "detokenize" "AgileTrust API" "format-preserving encryption" "FPE" "FF1" / "FF3-1" "tokenize a PAN" "tokenize RUT" "tokenize email" "X-API-Key" "protect PII"

Contents

What's Included

SKILL.md

Main skill file: setup, quick start, encoding/algorithm selection, tweak rules, error handling, code samples, and use-case table. Always loaded when skill triggers.

references/api-reference.md

Full endpoint specs, request/response schemas, all field types and constraints, format-preservation examples, and algorithm-specific limits.

references/algorithms.md

FF3-1 vs FF1 detailed comparison: pros/cons, capability matrices by encoding, when-to-choose guide, and links to NIST standards.

references/use-cases.md

Per-PII recipes: email, RUT/DNI, credit card (PAN), phone, full name, date, IBAN, IP address. Each includes curl + Python examples and caveats.

references/error-codes.md

All HTTP status codes (400–503) with body examples, reproduction curl commands, and fixes.

assets/examples/

Runnable scripts: tokenize.sh (bash/curl), tokenize.py (Python requests), tokenize.js (Node.js fetch). Copy and run directly.

assets/openapi.yaml

Bundled OpenAPI 3.0.3 spec for offline reference. Identical to the live API Reference.