Word Aligner agent skill

Install the skill once, then ask your assistant in plain language. It translates, works out which words correspond, calls the Word Aligner API, and hands back a shareable diagram link. No API key, no sign-up.

What it is

The skill is a small package that teaches an AI assistant how to use Word Aligner. It holds a SKILL.md with instructions and worked patterns, an API reference, and an OpenAPI schema. Any assistant that can follow instructions and make an HTTP request can run it, so the same package works across Claude, ChatGPT, and custom agents.

What you can ask

Once it is installed, requests like these produce a diagram link:

  • “Translate ‘я хочу спать’ into English and show the word alignment.”
  • “Make an interlinear gloss of this Latin sentence.”
  • “Align this Hebrew verse with its English translation, right to left.”
  • “Show which French words map to which English words in this pair.”

The assistant returns a Word Aligner URL you can open, edit, or export as PNG, SVG, or PDF.

Install

Claude

Add it as an Agent Skill. In Claude Code, put the word-aligner-skill/ folder in your skills directory (~/.claude/skills/ for personal use, or .claude/skills/ in a project). In the Claude apps that support skills, upload word-aligner-skill.zip where custom skills are added. As a fallback on any Claude surface, paste the contents of SKILL.md into your project instructions.

ChatGPT

Build a Custom GPT. Add an Action from the OpenAPI schema at /api/align/openapi.json, then paste SKILL.md into the instructions so the model knows how to count word indices and lay out a gloss. No authentication is needed.

Any other agent

The API is open and needs no key, so any tool-using agent can call it. Point your framework at POST /api/align with the SKILL.md guidance and the full API reference. The package also ships an agents/openai.yaml manifest for OpenAI-style agents.

MCP server

There is also a hosted MCP server, a second way to connect that needs no package to install. It runs inside Word Aligner at https://aligner.tinygods.dev/mcp and exposes one tool, create_word_alignment, which takes your text lines and word pairs and returns a shareable diagram link plus a preview image. No API key, no sign-up.

It speaks the Model Context Protocol over Streamable HTTP, so any MCP client can use it. Pick the skill package or the MCP server depending on what your assistant supports.

Claude

Add it as a remote MCP server. In Claude Code:

claude mcp add --transport http word-aligner https://aligner.tinygods.dev/mcp

ChatGPT

Turn on Developer Mode, then add a connector pointing at https://aligner.tinygods.dev/mcp. No authentication.

How it works

Under the hood the skill calls one endpoint, POST /api/align, with the text lines and the word pairs that link them, and gets back a URL:

{
  "lines": ["Hello world", "Bonjour le monde"],
  "alignments": [[0, 0, 1, 0], [0, 1, 1, 1], [0, 1, 1, 2]]
}

The hard part for a model is counting word indices and laying out a gloss tier, which is what SKILL.md spells out. The API reference covers every parameter: per-line fonts and RTL, palettes and line style, and pair-level gap and connector control.

Get the skill

Download the skill Open the editor →