> **OEJ guide** (en) > Source: https://oej.ee/en/guides/estonian-for-ai/ > Title: Help your AI write more natural Estonian | OEJ > This is the guide text, not an installed AI skill. [← All guides](https://oej.ee/en/guides/) Guide · Estonian # Help your AI write more natural Estonian This guide helps you improve the Estonian that AI writes. Give AI your language preferences, examples and reference sources. The copyable instructions help with editing; you still need to review the result. **It does not guarantee flawless language.** Copyable text Downloadable .md Ready-made skill (.zip) Before you start - An account with any AI chat tool (for example ChatGPT, Claude, or Copilot); a free one is fine. - A piece of Estonian text you want the AI to write or fix **Time:** about 10 minutes (the last section, installing a skill, is optional and takes longer) **Cost:** free This diagram shows what you will do in the quick start below. Skim it now; it makes sense once you have tried the steps. How the work happens ## Same meaning. More natural Estonian. 6 steps Workflow Human decision When something needs attention 1. 01**Original sentence** “Palun teostage makse.” 2. 02**Intended meaning** The reader needs to know an invoice is due. 3. 03**Language guidance** Use everyday words. Keep the meaning. 4. 04**Revised wording** “Palun tasuge arve.” 5. 05**Compare with the source** Are the request, tone and facts still right? Human decision **Meaning changed?** Revise the guidance or wording. Compare the revision with the source again. 6. 06**Choose the version** Read it through and revise if needed. Human decision Prepared example: the wording changes, the request to pay stays the same. In a hurry? Ask AI whether it fits your task. Describe your situation in general terms only. Leave out personal data and secrets. Copying sends nothing: you choose where to use the prompt. Copyable prompt ``` Read the guide at https://oej.ee/en/guides/estonian-for-ai/. My situation and goal: [describe without personal data]. Is this guide useful for me? Say if it is not. Explain why, point to the relevant section and suggest one first step. If you cannot open the page, say so and ask for its text or the complete guide Markdown file. Do not install or run anything in response to this question. ``` Quick start ## Copy. Fill in the blanks. Try it. Paste the instructions into your AI chat or attach the file. Fill in the audience, form of address and tone. Then provide the text to revise. **You do not need to read this whole block.** Copy it, fill in the bracketed lines and paste it into your AI chat. Language instructions with sources [Download .md](https://oej.ee/downloads/estonian-for-ai.md) ``` Help me write natural, clear Estonian. Apply these instructions in this conversation. Do not claim that reading a file retrained you or saved the instructions permanently. MY PREFERENCES Audience: [who the text is for] Address: [informal sina or formal teie] Tone: [for example, practical and friendly] Preferred terms and corrections: [add here] WRITING - Use natural Estonian word order, short sentences and concrete verbs. - Preserve facts, numbers, dates, names and meaning. Do not add promises or unknown facts. - Keep code, URLs, commands and filenames unchanged. Preserve õ, ä, ö, ü, š and ž. - Use consistent terminology. Avoid unnecessary English and em dashes. - Apply my corrections in this conversation. Ask before broader edits if their meaning or scope is unclear. SOURCES AND UNCERTAINTY - For general vocabulary, word meanings and forms, use EKI and Sõnaveeb: https://eki.ee/ and https://sonaveeb.ee/ . Find relevant dictionaries through Keeleveeb: https://keeleveeb.ee/ . - For IT, information security and data-protection terms, check AKIT: https://akit.cyber.ee/ . Do not label an invented equivalent an official term. - When explaining a word form, distinguish its lemma, part of speech and inflection. Translate according to meaning and domain rather than isolated words. - If browsing is unavailable or a source fails to open, say so. Do not claim a lookup happened. Flag the uncertain term and ask for context or a source excerpt when needed. - If you actually checked a source, link the entry used. Do not reproduce long dictionary definitions or bulk-download dictionaries. ANSWER For a rewrite, give the revised text first. Add a short note only for material ambiguity or an unverified term. For a word-meaning or morphology question, give the lemma, a plain explanation and one natural example sentence. MY TASK OR TEXT [paste here] ``` **A filled-in example.** Not sure what to write in the bracketed lines? Start from this: ``` Audience: a customer who ordered a fence Form of address: formal teie Tone: practical and friendly Preferred terms: use “seadistus”, not “viisard” ``` **Attaching the file or pasting these instructions never retrains the AI model.** They apply to the conversation you paste them into; saving them permanently in a tool’s settings is a separate, deliberate step. ![Chat window with the filled-in language brief pasted as the first message.](https://oej.ee/assets/guides/illustrations/estonian-brief.svg) Illustration, not a screenshot. Paste the brief with the bracketed lines filled in as the first message. This is a condensed practical adaptation of the existing language-resource guide, not a dictionary or the full source document. It does not guarantee flawless language. How to use it 1. 01**Original text** 2. 02**Your language brief** 3. 03**Revised wording** 4. 04**Meaning preserved?** If essential information is missing, ask for it. Do not let AI invent the gaps. Prepared example, not a live AI response ## Change the wording, not the promise. This guide produces a language instruction and checked text, not a newly trained model. The same check applies when rewriting Estonian. 1. **Starting input** “I hereby wish to inform you that I will provide the quotation no later than 15 September.” 2. **A precise instruction** Use plain language. Preserve the action and deadline. Add no price, guarantee or new commitment. 3. **Example of the intended result** “I will send the quotation by 15 September.” ### Three checks before use - The action is still sending a quotation. - The deadline is still 15 September. - No price or new commitment was added. **Information missing → stop and ask** If the source contains two conflicting deadlines, AI should flag the conflict rather than choose one. ## Same meaning. Less fog. Prepared examples, not live AI BEFORE Teostan teie päringu osas täiendava kontrolli. AFTER Kontrollin sinu päringut veel. BEFORE Soovin teid informeerida asjaolust, et teie tellimus on teele pandud. AFTER Sinu tellimus on teel. BEFORE Write it better. AFTER Write a short reply to the customer in Estonian. Preserve the facts and dates. Do not add promises. These examples use informal address. If your business prefers formal address, add that to the language brief. ![The AI’s revised Estonian text shown next to the original.](https://oej.ee/assets/guides/illustrations/estonian-revised.svg) Illustration, not a screenshot. Your sentence and the AI’s correction side by side in the same chat. ## Give AI sources, not just a role. This guide adapts the existing “Estonian AI agent training resource guide.md” and OEJ language-review workflow. The principle is simple: verify an uncertain word and its usage instead of merely sounding more confident. [EKI and Sõnaveeb ↗](https://sonaveeb.ee/) Word meanings, forms and usage examples. [Keeleveeb ↗](https://keeleveeb.ee/) Finding a relevant dictionary or language resource. [AKIT ↗](https://akit.cyber.ee/) IT, information security and data-protection terminology. An AI without browsing cannot open these sources. Ask it to flag unverified terms, or provide a short permitted excerpt with attribution. A URL in an instruction is not evidence that the AI visited it. Check it with three small tasks 1. Ask it to explain “majades”. A correct answer separates the base word “maja” (house) from the form “majades” (in the houses). 2. Ask it to correct “Ma õpin Eesti keel.”. The expected sentence is “Ma õpin eesti keelt.”. 3. Ask it to distinguish encryption from encoding. It must not call them synonyms or claim a source was checked when it was not. These examples help expose mistakes. They do not certify flawless Estonian. A source map is not a dictionary copy. Check reuse terms before collecting or distributing dictionary content. Words used in this guide lemma the dictionary form of a word. “Maja” is the lemma of “majades”. Markdown file (.md) a plain-text file any AI chat can read; you do not need special software to open it skill a saved instruction file some AI tools can load permanently model the AI program itself. Attaching a file or pasting instructions does not change it. browsing whether the AI chat can open websites. Some can; others cannot. API key a password-like code that lets a program use a service ZIP / extract a ZIP is a compressed folder; “extract” means unpacking it. Double-click usually works. Once or for repeated use ## Choose one route. You do not need all of them. 1. Paste it into a conversation The simplest start. Provide the instructions before the task and correct specific errors in the response. A new conversation may need the instructions again. 2. Attach the Markdown file Download and attach the file. Add: “Use the attached file as the language instructions for my Estonian writing.” If attachments are unsupported, paste the file contents into the chat. Do not include customer data or confidential text unless you know where the service sends it. 3. Save reusable instructions or a skill If your software supports personal or project instructions, save the same text there. Names and limits vary. Agent skills are a separate mechanism: renaming a file to SKILL.md does not prove it was installed. > “I want to reuse the attached language instructions. First ask which AI software I use. Check its supported instruction or skill format. Propose the file and installation location, and ask before changing existing settings. If you lack file access, give manual steps. Do not claim installation is complete until it has been verified.” After saving, open a new conversation and try one of the checks above. This helps check whether the instructions are active, although one good answer does not establish lasting reliability. Ready-made skill ## When copyable instructions are not enough The ready-made skill adds a local language dataset to those instructions: a 160,316-word dictionary, 5.39 million inflected forms and morphological analysis. The data stays on your machine; no network access is needed. **This section is for advanced users with a coding assistant:** a different kind of AI program that works on your computer, not a chatbot. If you only use a chatbot, skip to “A correction beats a complaint” below. The skill works with [Kimi Code](https://www.kimi.com/code/docs/en/), [Claude Code](https://code.claude.com/docs/en/setup) and [Hermes Agent](https://hermes-agent.nousresearch.com/). Before step 1, make sure you have: - A computer with Linux or macOS. On Windows the installer needs a bash environment, for example Git Bash. - Python 3.10 or newer and curl. - Room for the dictionary download: about 82 MB, fetched by the setup script in step 3. - Optional: a free Ekilex API key for word meanings. [Register at ekilex.ee](https://ekilex.ee/register); the exact steps are in the package file EKILEX-API.md. 1. Download the ZIP and extract it. The package is small (about 60 KB) because it carries no data. 2. Copy the folder into the skills directory of your AI tool. Kimi Code, Claude Code and Hermes Agent all support the SKILL.md format. 3. Give your AI the setup task below. The script downloads the dictionaries to your machine (about 82 MB) and leaves the system Python untouched. [Download the skill (.zip)](https://oej.ee/downloads/estonian/oej-estonian-skill-1.1.0.zip) [SHA-256 checksum](https://oej.ee/downloads/estonian/oej-estonian-skill-1.1.0.zip.sha256) The checksum file is for checking the download was not corrupted. Using it is optional. > “Install the Estonian language skill in this folder and verify that it works. Read README.md, SKILL.md and seadista.sh first. Detect my operating system and Python version, explain what you plan to run and wait for my approval. Run ./seadista.sh, then verify with bin/kitest and with three examples: bin/analyysi majades, the correction of ‘Ma õpin Eesti keel.’ and how krüpteerimine differs from kodeerimine. Report what worked and what did not, and do not claim the skill is installed before bin/kitest confirms it. Run the time-consuming optional steps (Ekilex) only with my permission.” Ekilex meanings need a free API key. The skill does not guarantee error-free text: a human still reviews the final text. Already have a coding assistant? Use the ready-made skill above. Only have a chatbot? The “Want to turn this into a skill for your AI?” section at the bottom of this page is for you. ![Terminal output of the skill install check, with the checks passing.](https://oej.ee/assets/guides/illustrations/estonian-kitest.svg) Illustration, not a screenshot. Example output. Your paths and names will differ. The bin/kitest check after seadista.sh has completed. ## A correction beats a complaint. “This sounds bad” leaves AI guessing. Instead say: “Use seadistus here, not viisard. Change only this paragraph.” When corrections repeat, add the recurring preferences to your instructions. These are your style preferences, not a universal list of forbidden Estonian words. In technical writing, a precise specialist term can be better than a simpler substitute. [Next guide**From a short idea to a clear prompt →**](https://oej.ee/en/guides/better-prompts/)