MAHMOUD ABDELNABY
Localization · SKILL MD · 1

Dialect-Aware Copywriting Adaptation Agent Skill

Stop AI from mixing Arabic dialects. An authoritative Agent Skill that writes native Egyptian, Saudi, and Emirati ad copy with zero vocabulary bleed.

Problem it addresses

Create an authoritative Agent Skill (SKILL.md) for dialect-aware Arabic marketing copy: 1) Strict dialect isolation rules preventing vocabulary bleed between Egyptian, Saudi (Najdi/Hejazi), and Emirati vernacular, 2) Tone matching (Casual UGC vs Premium B2B vs Conversational Direct Response), 3) Reference vocabulary guides, 4) Worked transformation test fixtures.

Who it is for

BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • examples/before-and-after-copy-tests.md
  • examples/multidialect-campaign-sample.md
  • LICENSE
  • README.md
  • references/egyptian-colloquial-glossary.md
  • references/egyptian-commercial-slang.md
  • references/emirati-tone-guide.md
  • references/gulf-slang-glossary.md
  • references/saudi-vernacular-rules.md
  • SKILL.md
  • templates/tone-adapter-rules.json
  • tests/test_data_integrity.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests

Scope and limitations

  • Morphological Particle Adaptation: Adapts future tense markers (هـ in Egyptian vs بـ / راح in Gulf) and negation particles (مش vs مو) to preserve natural vernacular flow.
  • Cultural Metaphor Relevance: Replaces regionally specific Egyptian cultural references with equivalent Gulf commercial hooks.
  • Demonstrative Editorial Selection: Provides illustrative transformation rules and editorial patterns, not an exhaustive academic dialect atlas.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories