MCPInstall

hebrew-content-writer

Write and edit professional content in Hebrew including marketing copy, UX text, articles, emails, and social media posts. Use when user asks to write in Hebrew, "ktov b'ivrit", create Hebrew marketing content, edit Hebrew text, write Hebrew UX copy, or optimize Hebrew content for SEO. Covers grammar rules, register from formal to dugri, mixed Hebrew/English, gendered language, nikud and numerals, and Hebrew SEO best practices. Do NOT use for Hebrew NLP/ML tasks (use hebrew-nlp-toolkit) or translation (use a translation skill).

Installs
441
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/skills-il/localization --skill hebrew-content-writer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads hebrew-content-writer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Hebrew Content Writer

Instructions

Step 1: Identify Content Type and Register

Content TypeRegisterAudienceKey Characteristics
Legal / GovernmentFormal (gvoha)Officials, lawyersPassive voice, complex sentences, traditional gendering
Business / CorporateBusinessProfessionalsClear, professional, moderate formality
Marketing / AdsBusiness-CasualGeneral publicPersuasive, benefit-focused, concise
Direct / DugriDugriIsraeli general publicBlunt, no softeners, short imperative sentences
UX / InterfaceDirectEnd usersImperative mood, ultra-short, action-oriented
Social MediaInformalYoung adultsCasual, slang-friendly, emoji-compatible
Blog / ArticleBusinessReadersInformative, SEO-aware, structured

Step 2: Apply Hebrew Grammar Rules

Spelling Standard -- Use Ktiv Maleh (Full Spelling): Modern Hebrew content uses ktiv maleh (plene spelling) with vav and yod for vowels:

  • Correct: תוכנה (tochnah) not תכנה
  • Correct: שירות (sherut) not שרות
  • Follow Academy of Hebrew Language guidelines

Smichut (Construct State) Rules:

  • First noun loses definite article: "beit ha-sefer" (the school) not "ha-beit ha-sefer"
  • First noun may change form: bayit -> beit, yom -> yom (unchanged)
  • To make a smichut plural, pluralize the first noun: בתי ספר (schools), not בתי ספרים. The second noun keeps whatever number its own meaning needs (ספרי ילדים, חנות בגדים)

Direct Object Marker (et):

  • Required before definite direct objects: "ra'iti ET ha-sefer" (I saw the book)
  • NOT used with indefinite objects: "ra'iti sefer" (I saw a book)
  • Common mistake: omitting "et" or using it with indefinite objects

Subject-Verb Agreement:

  • Verbs agree in gender and number with their subject
  • Past tense: also agrees in person
  • Present tense: only gender and number (no person distinction)
  • Future tense: gender, number, and person

Step 3: Handle Gendered Language

Option A -- Traditional (default for formal/legal): Use masculine plural for mixed groups. Standard in government, legal, academic writing.

Option B -- Slash Notation (for business/marketing):

משתמשים/ות יקרים/ות (dear users, m/f)

Option C -- Gender-Neutral Rewording (recommended for UX/tech):

Instead ofUse
המשתמש צריך ללחוץ (the user needs to click, m.)יש ללחוץ על (click on)
אתה יכול לבחור (you can choose, m.)אפשר לבחור (it is possible to choose)
הלקוחות שלנו מרוצים (our customers are satisfied, m.)רמת שביעות הרצון בקרב הלקוחות גבוהה (customer satisfaction is high)

Ask the user which approach they prefer if not specified.

Step 4: Common Hebrew Writing Mistakes to Avoid

MistakeWrongCorrectRule
Smichut with ha- on first nounהבית הספרבית הספרOnly second noun gets ha-
Missing etראיתי הכלבראיתי את הכלבDefinite direct object needs et
Wrong gender agreementהילדה הלךהילדה הלכהVerb must match subject gender
Mixed ktivתוכנה/תכנה in same textPick one consistentlyUse ktiv maleh throughout
Colloquial in formal textנגיד ש...לדוגמה...Match register to context

Step 5: Hebrew SEO Optimization

Keyword Strategy:

  • Research keywords in Hebrew using Google Keyword Planner (region: Israel)
  • Account for morphological variations -- target root words and common forms
  • Example: "ביטוח" (insurance) also search "ביטוחים", "לבטח", "מבוטח"
  • Consider bilingual searches -- Israelis search English for tech terms

On-Page SEO for Hebrew:

  • Title tag: primary keyword near the beginning. Google sets no length limit but truncates the displayed title to fit the device width, so keep the key words early
  • Meta description: a compelling call-to-action. Google sets no length limit here either and truncates the snippet as needed, so lead with the value
  • H1: One per page, contains primary keyword
  • URL slug: Google recommends words in the audience's language, and transliterated words where relevant. Hebrew words (percent-encoded in the URL), a transliteration ("bituach-briut") or an English equivalent all work; pick one convention per site
  • Alt text: Descriptive Hebrew text for images
  • Internal linking: Use Hebrew anchor text

Content Structure:

  • Use short paragraphs (2-3 sentences) -- Hebrew text appears denser than English
  • Use headers (H2, H3) every 200-300 words
  • Bulleted lists improve readability in Hebrew
  • Bold key terms for scanning

Advertising sent by fax, automated call, SMS, email or any other electronic message such as WhatsApp (Communications Law section 30A):

  • Send only with the recipient's prior explicit consent in writing; consent given in an electronic message or a recorded call counts. A one-time approach to a business recipient that asks them to agree to receive advertising is not a violation.
  • The exception for commercial advertising sent without consent needs ALL three: the recipient gave their details while buying, or negotiating to buy, a product or service and was told they would be used for advertising; they were given a chance to refuse and did not; and the advertising is for a similar kind of product or service.
  • State these prominently and clearly, without misleading: that it is advertising, with the word "פרסומת" (or "בקשת תרומה" for a donation request, "תעמולה" for propaganda) at the start and, in an electronic message, in its title or subject line; the advertiser's name, address and contact details; and the recipient's right to refuse at any time with a simple way to do so (for an electronic message, a valid internet address for refusals).
  • For an automated call, the recorded message must also say at its start that the recipient may ask to be removed from the mailing list, and let them do so right away, including by pressing a key.
  • For an SMS the law replaces that list: the message states only the advertiser's name and contact details for sending a refusal.
  • A court may award up to 1,000 NIS per advertising message sent knowingly in breach, without proof of damage.
  • Donation requests and propaganda messages have their own variants of these rules (for example, section 30A(b1) for nonprofits and public-benefit companies sending by email); check the statute for those.
  • Check the statute text and the Ministry of Communications FAQ (https://www.gov.il/he/pages/17052018_7) before writing campaign copy; these requirements come from the law, not from style.

Step 6: Write in the Dugri (Direct) Register

"Dugri" is the blunt, no-nonsense register Israelis use and expect in everyday speech and increasingly in product copy, support replies, and startup marketing. It is a distinct mode, not just "informal" - it can be polite and still completely direct. Use it when the brand voice is plain-spoken or when softening would feel evasive to an Israeli reader.

How to write dugri:

  • Drop English-style softeners. Cut "we would be happy to", "it might be worth considering", "please feel free to". Say the thing.
  • Short sentences, one idea each. Long subordinate clauses read as bureaucratic.
  • Second-person imperative is fine and friendly: "תשלחו לנו את המספר" (send us the number), "תבדקו את זה" (check this).
  • Lead with the point, then the reason - not the other way around.
  • Dugri is not rude. It still uses "תודה" and basic courtesy; it just refuses to pad.
Padded (avoid)Dugri (use)
נשמח אם תוכלו לשקול לעדכן את הפרטיםתעדכנו את הפרטים
ייתכן שכדאי לבדוק את החיבור לאינטרנטתבדקו את החיבור לאינטרנט
אנחנו מתנצלים על אי הנוחות שנגרמהסליחה על אי הנוחות. (add "תיקנו את זה" only if it is true)

Step 7: Handle Mixed Hebrew/English (Heblish)

Israeli writing routinely mixes Hebrew and English, especially in tech, marketing, and business copy. The decision for each English term is keep, transliterate, or translate:

  • Keep in English - established tech/product terms with no natural Hebrew equivalent in daily use: API, SaaS, deploy, dashboard (often), email (though "אימייל"/"מייל" is also common). Brand and product names always stay in English.
  • Transliterate - terms that have entered spoken Hebrew phonetically: "אימייל", "סטארטאפ", "פינטק", "באג", "פיצ'ר". Use when the transliteration is what people actually say.
  • Translate - terms with a well-established Hebrew word the audience uses: "תוכנה" (software), "משתמש" (user), "הורדה" (download), "עדכון" (update). Forcing English here reads as lazy.

RTL/LTR mixing in one line:

  • An English term inside a Hebrew sentence keeps its LTR run; the browser's bidi algorithm usually handles a single word, but wrap longer English strings, codes, or anything with punctuation in <bdi> or dir="ltr" so surrounding Hebrew punctuation does not reorder.
  • Keep a space on both sides of the English run.

English nouns taking Hebrew grammar:

  • Hebrew plural: Israelis routinely add Hebrew plural endings to English nouns - "באגים" (bugs), "לינקים" (links), "פיצ'רים" (features). This is natural; do not "correct" it to English plurals.
  • Definite article: the Hebrew "ה־" attaches to the English noun - "האפ" (the app), "הלינק" (the link), "הדשבורד" (the dashboard).
  • Gender: assign the English noun a Hebrew gender consistently (usually masculine by default) so verbs and adjectives agree - "הדשבורד נטען" not "הדשבורד נטענה".

Step 8: Nikud, Numerals, and Dates

When to add nikud (vowel points):

  • Children's content, early-reader material, songs, poetry.
  • A single ambiguous word where context does not disambiguate (e.g., to distinguish "סֵפֶר" from "סַפָּר").
  • Foreign names and unfamiliar loanwords on first mention.

When to omit nikud:

  • Modern body copy, UI text, marketing, articles - standard unvocalized Hebrew. Adding nikud throughout looks like a textbook and slows fluent readers.

Numerals and dates:

  • In running body copy, prefer digits for most numbers ("3 ימים", "תוך 24 שעות"); spelling out is reserved for formal/legal text or numbers that open a sentence.
  • Number-gender agreement: 1 and 2 agree with the noun ("יום אחד", "שני ימים"; "שנה אחת", "שתי שנים"). From 3 to 10 the number takes the OPPOSITE-looking form (a known trap): a masculine noun takes the form ending in ה, "שלושה ימים" (three days), and a feminine noun takes the form without it, "שלוש שנים" (three years).
  • Dates follow Israeli convention DD/MM/YYYY and 24-hour time. See israeli-ui-design-system for formatting in UI components.
  • Gershayim (״) mark an acronym and go before its last letter (צה״ל, בי״ס); a geresh (׳) marks a shortened word and goes after its last written letter (מס׳, עמ׳). The Academy leaves the choice between double and single quotation marks to house style.
  • Put a maqaf (־) between a Hebrew prefix and a number or a Latin-letter word: ב־2026, ה־API, המאה ה־12. A maqaf joins with no spaces; a dash (–) separates and takes a space on each side, except in a range, where it takes no spaces (עמ' 46–53, 16.00–18.00).

Step 9: Literal-Translation Pitfalls

Calques from English produce text that is grammatical but unmistakably translated. Watch for:

PitfallWrong (calque)Natural Hebrew
"to make sense" translated word-for-wordזה עושה סנס / זה עושה שכלזה הגיוני / זה נשמע הגיוני
Over-using generic "אתה" for impersonal "you"אתה צריך ללחוץ, אתה יכול לראותיש ללחוץ, אפשר לראות
"בכדי" used where plain "כדי" belongsבכדי לשמור את הקובץכדי לשמור את הקובץ
Hitpa'el verb given a direct object with "את"להתחבר את החשבוןלחבר את החשבון / להתחבר לחשבון
Literal "at the end of the day"בסוף היוםבסופו של דבר / בשורה התחתונה

"בכדי" is not wrong in every context, but it is overused as a fancier-looking "כדי"; default to plain "כדי".

Examples

Example 1: Marketing Email

User says: "Write a Hebrew marketing email for a SaaS product launch" Result: Write business-register Hebrew email with compelling subject line, benefit-focused body, clear CTA. If the email is advertising, first confirm the recipients consented or meet the three-condition exception in Step 5, then start the subject line with "פרסומת" and include the sender details and refusal address. Apply SEO principles if it will be a web version. Use gender-inclusive language.

Example 2: UX Error Message

User says: "Write Hebrew error messages for a login form" Result: Write short, clear, action-oriented Hebrew text in imperative mood. Use neutral/inclusive phrasing. Examples: "הסיסמה שגויה. נסו שוב" (The password is incorrect. Try again).

Example 3: SEO Blog Post

User says: "Write a Hebrew blog post about cloud security for Israeli businesses" Result: Research Hebrew keywords, write structured article with proper H2/H3 hierarchy, include meta description, use ktiv maleh throughout, business register.

Example 4: Gender-Inclusive Rewrite

User says: "Make this Hebrew text gender-inclusive" Result: Identify gendered forms, apply Option C rewording where possible, use slash notation where rewording is awkward, maintain readability and register.

Bundled Resources

References

  • references/hebrew-grammar-quick-ref.md - Concise Hebrew grammar reference covering all 7 binyanim (verb patterns) with usage guidance by register, ktiv maleh vs. ktiv chaser spelling examples, common smichut (construct state) forms, and four gender-inclusive writing patterns with before/after examples. Consult when writing or editing Hebrew content and need to verify grammar rules, choose the correct register, or apply gender-neutral phrasing.

Gotchas

  • Agents default to formal/literary Hebrew (safa gvoha) when writing marketing or UI text. Israeli users expect casual, conversational Hebrew. Use colloquial phrasing, not textbook Hebrew.
  • Hebrew punctuation differs from English: the geresh (') and gershayim (") are used for abbreviations (e.g., tsahal) and acronyms, not for quotation. Agents may strip these or replace them with standard ASCII quotes.
  • Agents tend to transliterate English idioms literally into Hebrew, producing unnatural text. "Think outside the box" does not translate directly; use native Hebrew expressions instead.
  • Hebrew has grammatical gender that must agree between nouns, verbs, and adjectives. Agents often use masculine defaults even when addressing a female user or a feminine noun.

Reference Links

SourceURLWhat to Check
Academy of the Hebrew Languagehttps://hebrew-academy.org.ilOfficial spelling rules, loanword decisions, new terms
Milog online dictionaryhttps://milog.co.ilModern Hebrew usage, register, common phrasing
Ravmilim online dictionaryhttps://www.ravmilim.co.ilSynonyms, collocations, grammatical info
Academy decisions (ההחלטות)https://hebrew-academy.org.il/topic/hahlatot/Academy decisions on grammar, spelling and terminology
Academy punctuation rules (כללי הפיסוק)https://hebrew-academy.org.il/topic/hahlatot/punctuation/Maqaf, gershayim, geresh, quotation marks
Hebrew style guide (Wikipedia)https://he.wikipedia.org/wiki/ויקיפדיה:לשוןCommunity-maintained modern Hebrew language and style conventions

Troubleshooting

Error: "Text mixes formal and informal registers"

Cause: Inconsistent tone throughout the content Solution: Identify the target register at the start and apply it consistently. Common issue when multiple writers contribute or when translating from English.

Error: "SEO keywords don't match Hebrew search patterns"

Cause: Direct translation of English keywords to Hebrew Solution: Use Google Keyword Planner with Israel region. Hebrew search patterns differ from English -- Israelis may search differently than direct translations suggest.

FAQ

What does the hebrew-content-writer skill do?

Write and edit professional content in Hebrew including marketing copy, UX text, articles, emails, and social media posts. Use when user asks to write in Hebrew, "ktov b'ivrit", create Hebrew marketing content, edit Hebrew text, write Hebrew UX copy, or optimize Hebrew content for SEO. Covers grammar rules, register from formal to dugri, mixed Hebrew/English, gendered language, nikud and numerals, and Hebrew SEO best practices. Do NOT use for Hebrew NLP/ML tasks (use hebrew-nlp-toolkit) or translation (use a translation skill).

How do I install hebrew-content-writer?

Run npx skills add https://github.com/skills-il/localization --skill hebrew-content-writer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hebrew-content-writer/ (personal) or .claude/skills/hebrew-content-writer/ (project).

Which AI agents can use hebrew-content-writer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is hebrew-content-writer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains hebrew-content-writer?

It is published by skills-il in skills-il/localization. It has 441 recorded installs.

More from skills-il/localization

View all →

hebrew-rtl-best-practices

skills-il/localization

Implement right-to-left (RTL) layouts for Hebrew web applications. Use when user asks about RTL layout, Hebrew text direction, bidirectional (bidi) text, Hebrew CSS, "right to left", or needs to build a Hebrew web UI. Covers CSS logical properties, the :dir() pseudo-class, Tailwind RTL, React/Next.js RTL setup, icon mirroring, Hebrew typography, and font selection. Do NOT use for Arabic RTL (similar but different typography) unless user explicitly asks for shared RTL patterns, or for native mobile RTL (React Native I18nManager, SwiftUI, Android) which is out of scope.

Frontend & Design700 installs

israeli-accessibility-compliance

skills-il/localization

Not an accessibility surveyor's opinion and not legal advice. Implement Israeli web accessibility compliance per IS 5568 standard, which is WCAG 2.0 AA plus Israeli national changes, for Hebrew RTL applications. Use when user asks about Israeli accessibility law, "negishot" (accessibility), IS 5568, "teken negishot" (accessibility standard), "nachim" (disabilities), Hebrew screen reader support, RTL ARIA patterns, or accessibility audit for Israeli websites. Covers mandatory legal requirements under the Equal Rights for Persons with Disabilities Act, who is exempt, enforcement and penalties, the accessibility coordinator role, Hebrew screen reader compatibility (NVDA, JAWS, VoiceOver), native mobile apps, and RTL-specific ARIA patterns. Do NOT use for general WCAG guidance without Israeli context (use standard a11y resources instead), or for building a self-hosted accessibility preferences widget (use wcag-accessibility-widget).

Frontend & Design250 installs

hebrew-document-generator

skills-il/localization

Not legal advice. Generate Hebrew documents (PDF, DOCX/Word, PPTX) with correct RTL layout, mixed Hebrew-and-English bidi handling, and Hebrew typography. Use whenever the output is a Hebrew or mixed Hebrew/English Word document, Hebrew PDF, or Hebrew PowerPoint ("Hebrew Word document", "מסמך Word בעברית", "create a .docx in Hebrew"), or Israeli templates like Heshbonit Mas, Hozeh, or Protokol. ALSO use this for the symptom where a Hebrew document looks fine on screen or in Claude but comes out scrambled, reversed, or broken in Word, with English, numbers, or punctuation on the wrong side ("Hebrew text reversed in Word", "fix Hebrew formatting in Word"); the fix is regenerating the .docx with paragraph-level RTL/bidi, NOT a web/CSS RTL change. Prefer over the generic docx/pdf skills ONLY when the document is Hebrew or RTL; for English-only docs use the generic skill. Covers reportlab, WeasyPrint, python-docx, pptxgenjs. Do NOT use for OCR or reading existing documents (use hebrew-ocr-f

Docs & Writing231 installs

hebrew-tailwind-preset

skills-il/localization

Open the skill to read its SKILL.md instructions.

Frontend & Design220 installs

shabbat-aware-scheduler

skills-il/localization

Schedule meetings, deployments, and events respecting Shabbat, Israeli holidays (chagim), and Hebrew calendar constraints. Use when user asks to schedule around Shabbat, "zmanim", check Israeli holidays, plan around chagim, set Israeli business hours, or needs Hebrew calendar-aware scheduling logic. Includes halachic times (zmanim) via HebCal API, full Israeli holiday calendar, and Israeli business hour conventions. Do NOT use for religious halachic rulings (consult a rabbi) or diaspora 2-day holiday scheduling.

israeli-ui-design-system

skills-il/localization

Build RTL-first UI component libraries and design systems for Israeli applications with Hebrew typography. Use when user asks about Hebrew UI components, "itzuv" (design), Israeli design system, Hebrew font pairing, RTL component library, "tipografia ivrit" (Hebrew typography), or gov.il design patterns. Covers RTL-first component architecture, Hebrew font pairings (Heebo+Inter, Rubik+Source Sans 3), gov.il design system patterns, Israeli formatting conventions (shekel sign, day-first dates, 24-hour clock), and culturally appropriate UI for Israeli users. Do NOT use for general RTL CSS (use hebrew-rtl-best-practices) or accessibility audits (use israeli-accessibility-compliance instead).

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs