ULT-alignment

Map Hebrew source words to English ULT words with JSON alignment output.

1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/unfoldingWord/bp-assistant-skills --skill ult-alignment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ULT-alignment
Source: https://github.com/unfoldingWord/bp-assistant-skills/tree/main/.claude/skills/ULT-alignment
Command: npx skills add https://github.com/unfoldingWord/bp-assistant-skills --skill ult-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Align Hebrew source words with English ULT words to enable precise, machine-readable word-level mappings for downstream USFM alignment and linguistic analysis.

Core Features & Use Cases

  • Two-step workflow: AI generates an index-based mapping; a script converts the mapping to a properly formatted USFM-aligned output.
  • Input requirements: Hebrew USFM text, English ULT text, and optional verse range to focus alignment.
  • Output: a JSON mapping containing reference, hebrew_words, english_text, and alignments suitable for conversion to aligned USFM.
  • Use Case: for Genesis 1:1, generate a mapping that preserves English word order while aligning to Hebrew indices for verification and downstream processing.

Quick Start

Provide Hebrew USFM and English ULT text, then request a word-level alignment JSON mapping.

Frequently Asked Questions about ULT-alignment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I align Hebrew source words to English ULT text for translation analysis?▼

The Skill maps Hebrew source words to English ULT words by generating an index-based JSON mapping. This output preserves English word order while linking to Hebrew indices, enabling precise verification and downstream USFM alignment.

Can I align specific verses instead of processing an entire Hebrew text file?▼

Yes, you can align specific verses by providing an optional verse range parameter. This focuses the Hebrew to English word-level alignment on your selected text segment rather than processing the entire USFM input.

What input formats do I need for Hebrew to English word-level alignment?▼

Hebrew to English word-level alignment requires Hebrew USFM text and English ULT text as inputs. You can optionally specify a verse range to constrain the alignment scope.

Does the alignment output support inter-verse mapping and superscriptions?▼

Yes, the word-level alignment supports inter-verse alignment and superscriptions. It outputs a JSON mapping containing alignments that can be converted into properly formatted aligned USFM.

How is the generated JSON mapping converted to aligned USFM?▼

The JSON mapping is converted to aligned USFM through a two-step workflow. The AI generates an index-based mapping, and a script converts that mapping into properly formatted aligned USFM output.