# Champagne Fairy Wine Translator

A reusable wine-language skill for translating, proofreading, and reviewing content in English, Hebrew, and Russian. The same core skill folder can be packaged as a Codex plugin or configured manually in assistants that support persistent instructions and reference files.

Developer: John Neystadt  
Copyright © 2026 Champagne Fairy

## What it does

- Translates wine descriptions and tasting notes in every direction among English, Hebrew, and Russian.
- Proofreads and edits wine descriptions and tasting notes in their original language while preserving voice, sensory intensity, and factual claims.
- Reviews existing translations against a bundled trilingual glossary and returns complete corrections.
- Preserves negation, numbers, vintages, units, vine ages, classifications, and exact proper-name identity.
- Requires an authoritative Internet lookup for every place, vineyard, village, winery, and winemaker name; verified target-language forms include the original in parentheses, while unverified names remain unchanged and are flagged.
- Distinguishes high-risk terms such as `francs de pied`, `foudre`, German `Fuder`, malolactic fermentation, dosage, residual sugar, and no-added-sulfites claims.
- Uses separate EU still-wine and sparkling-wine sweetness rules and treats the Terry Theise scale as sensory rather than analytical.

The package contains original terminology guidance and synthetic tests only. It does not include Champagne Fairy catalog descriptions, critic reviews, customer data, or private translation caches.

## Acknowledgements

Thanks to Chaim Shraga and John Neystadt for allowing their tasting notes to be used for terminology research and dictionary building.

## Example prompts

- “Translate this tasting note from Russian into English and Hebrew.”
- “Proofread this Hebrew wine description and keep the author's voice.”
- “Review this English translation against the Russian source and explain material corrections.”
- “Explain `franc de pied` in English, Hebrew, and Russian.”

The main skill is `$translate-wine-content`.

## Dictionary and installation

The public dictionary, sweetness tables, and installation page are at:

- [English dictionary and installation](https://champagne-fairy.co.il/guide/wine-terminology#install-wine-translation-skill)
- [Hebrew dictionary and installation](https://champagne-fairy.co.il/he/guide/wine-terminology#install-wine-translation-skill)
- [Russian dictionary and installation](https://champagne-fairy.co.il/ru/guide/wine-terminology#install-wine-translation-skill)

There is no single automated installer shared by ChatGPT, Gemini, and Codex. Use the package in the format supported by the selected assistant:

### Codex or ChatGPT desktop plugin

This repository directory is already a Codex plugin because it contains `.codex-plugin/plugin.json`. Install the published marketplace package when one is available. For local development, expose the plugin through a repo or personal Codex marketplace and install it from that marketplace; do not treat the folder as a browser extension.

### ChatGPT custom GPT or Project

For a [custom GPT](https://help.openai.com/en/articles/8554397), paste the body of `skills/translate-wine-content/SKILL.md` into **Instructions** and upload the files under `skills/translate-wine-content/references/` as **Knowledge**. For a [ChatGPT Project](https://help.openai.com/en/articles/10169521-using-projects-in-chatgpt), use the same content as project instructions and project sources. Make Web Search available whenever the text contains places, vineyards, villages, wineries, or winemaker names. The skill must verify every such name through an authoritative Internet source and output the target-language form with the original in parentheses; if it cannot verify a name, it must preserve and flag the original.

### Gemini Gem

Create a Gem using the body of `skills/translate-wine-content/SKILL.md` as its instructions, then add the files under `skills/translate-wine-content/references/` as Gem knowledge. Google documents the current instruction and knowledge-file flow in [Tips for creating custom Gems](https://support.google.com/gemini/answer/15235603?hl=en). Ensure the Gem can search the web for every required proper-name lookup. It must output each verified target-language form with the original in parentheses; if it cannot verify a name, it must preserve and flag the original.

`agents/openai.yaml` and `.codex-plugin/plugin.json` are OpenAI/Codex interface metadata. They are optional when manually configuring another assistant; `SKILL.md` and `references/` contain the portable workflow and knowledge.

## Validate before publishing

From this directory:

```text
node skills/translate-wine-content/scripts/validate_terminology.mjs
node skills/translate-wine-content/tests/smoke.mjs
```

## Attribution and licenses

The complete plugin package is licensed under [CC BY-ND 4.0 International](https://creativecommons.org/licenses/by-nd/4.0/). See `LICENSE` and `NOTICE` for the terms and suggested attribution.

Suggested attribution:

> [Champagne Fairy Wine Terminology](https://champagne-fairy.co.il/guide/wine-terminology), © 2026 Champagne Fairy, licensed under [CC BY-ND 4.0 International](https://creativecommons.org/licenses/by-nd/4.0/).

CC BY-ND 4.0 permits redistribution of the unadapted licensed material with attribution. It does not permit distributing translations, abridgements, rewrites, reorganizations, or other adapted versions without separate permission from Champagne Fairy. Necessary technical format changes and uses allowed by applicable legal exceptions remain unaffected.

The package licenses cover the listed package files; they do not determine rights in content supplied by a user or output produced by an assistant.

The licenses do not grant permission to imply endorsement or present another product as an official Champagne Fairy product.
