tn-writer

Generate per-verse translation notes from issue TSV data using deterministic prep steps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires axios, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the generation of translation notes from issue identification TSV data, reducing manual writing workload and ensuring consistency with established templates.

Core Features & Use Cases

  • Automated TN generation from issue data and prepared notes
  • Prose writing guided by per-item templates and AT policy
  • Verse-level notes written one issue at a time, with deterministic prep
  • Support for MCP-first execution and strict style guidelines

Quick Start

Provide an issues TSV for a chapter and request translation notes to be generated.

Frequently Asked Questions about tn-writer

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

FAQPage Schema
How do I generate translation notes from issue TSV data automatically?

You can generate translation notes from issue TSV data by using an automated tool that processes per-verse items, applies deterministic preparation steps, and writes notes guided by style guidelines and per-item policy.

What is the best way to automate writing per-verse translation notes?

The best way to automate writing per-verse translation notes is to process issue identification outputs sequentially, honoring writer_packet guidance and templates to ensure prose conforms to established style guides.

Do I need a style guide to automate translation note generation?

Yes, a style guide is required to automate translation note generation because the tool enforces strict style guidelines and uses per-item templates to structure the output prose correctly.

Can I use issue identification output to create translation notes for a whole chapter?

Yes, you can provide an issues TSV for an entire chapter to generate verse-level translation notes, processing one issue at a time while deferring AT and logical variations to subsequent pipeline steps.

What are the limitations of automated translation note writing?

Automated translation note writing defers AT and logical variations to subsequent pipeline steps, meaning it focuses strictly on generating per-verse prose from issue data rather than handling complete translation processing.

How does tn-writer handle per-item policy when generating translation notes?

tn-writer handles per-item policy by relying on per-item packages and policy directives to structure notes, ensuring the generated translation notes honor the specific writer_packet guidance for each item.