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.