tq-writer

Update Translation Questions to align with current ULT/UST texts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Update existing Translation Questions (TQs) to align with current ULT/UST texts, preventing drift between source texts and evaluation questions.

Core Features & Use Cases

  • Preparation-driven updates: A prep script gathers TQ data and references for a chapter or whole-book.
  • Chapter-by-chapter QA and alignment: The AI reviews each chapter's TQs against current ULT/UST and updates questions and responses accordingly.
  • Output formatting and validation: Outputs updated TSVs to output/tq/{BOOK}/{BOOK}-{CHAPTER}.tsv, applies curly-quote normalization, and runs verification per tq-guidelines.

Quick Start

Invoke tq-writer to update Translation Questions for a chosen book and chapter using the standard preparation and review workflow.

Frequently Asked Questions about tq-writer

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

FAQPage Schema
How do I align Translation Questions with updated ULT and UST texts?

To align Translation Questions with updated ULT and UST texts, use a preparation script to extract TQ data and references, then review each chapter to adjust questions and responses against current source texts.

What is the best way to update Bible translation questions for a whole book?

Updating Bible translation questions for a whole book involves running a preparation script to gather all TQ data and references, followed by a chapter-by-chapter QA review process to align questions and responses with current texts.

Do I need the en_tq repository to update translation questions TSV files?

Yes, updating translation questions TSV files requires access to the en_tq repository, ULT and UST outputs, and tq-guidelines to ensure proper TSV output formatting and curly-quote post-processing.

How does curly-quote normalization work in translation question TSV outputs?

Curly-quote normalization in translation question TSV outputs applies standardized curly quotation marks during the output formatting phase, with verification performed per tq-guidelines after questions and responses are updated.

Why do my existing Translation Questions drift from current ULT and UST texts?

Translation Questions drift from current ULT and UST texts when source texts are updated without corresponding TQ alignment, which this Skill prevents by reviewing and adjusting questions chapter-by-chapter against the latest texts.

Can I update translation questions for individual chapters instead of a whole book?

Yes, the preparation script and review workflow support both chapter-level and whole-book updates, allowing you to target specific chapters when aligning Translation Questions with current ULT and UST texts.