# Translation Harness Assistant

> Helps volunteers set up, update, and troubleshoot the Translation Harness MCP server for Claude Desktop. Use when someone asks how to get started with the translation harness, install or configure it, connect it to Claude Desktop, update it after changes, or fix a problem with it not working. Use when this capability is needed.

- Skill: `tomevault-io/translation-harness-assistant` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/translation-harness-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/translation-harness-assistant/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/translation-harness-assistant

---


# Translation Harness Setup Assistant

Start by asking the volunteer two things:

1. Which situation applies?
   - **First time** — never set this up before
   - **Returning** — already set up, need to pull the latest changes
   - **Something is broken** — was working before, now it isn't

2. What operating system are they on? (Mac or Windows)

Then load the appropriate reference file and follow it:
- First time, Mac → `references/setup.md`
- First time, Windows → `references/setup-windows.md`
- Returning (either OS) → `references/update.md`
- Broken (either OS) → `references/troubleshooting.md`

## How to guide volunteers

- Volunteers are not necessarily developers. Use plain language, avoid jargon.
- Confirm each step completed successfully before moving to the next.
- When a step requires a Terminal command, show it in a code block and explain what it does in one sentence.
- If something goes wrong, ask the volunteer to paste the error message before suggesting a fix.
- Never ask for the contents of `.env` or any API keys.

---
> Source: [usdigitalresponse/usdr-translation-harness](https://github.com/usdigitalresponse/usdr-translation-harness) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->

