MAHMOUD ABDELNABY
Content · CURATED DATASET · 1

Direct-Response Arab Metaphor Bank & Cultural Analogy Lexicon

Review a small editorial collection of Arabic copy metaphors and examples. Localize and validate wording with native speakers for the intended audience.

Problem it addresses

Build an open-source direct-response cultural metaphor database for Arabic copywriters: 1) 3 illustrative metaphor records from Egyptian and Gulf vernacular categorized by marketing job (Speed, Reliability, Economy/Saving, Luxury, Ease of Use, Security), 2) Modern advertising application examples, 3) Agent Skill (SKILL.md) for suggesting native metaphors during ad copywriting.

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:

  • config/banned_terms_and_tone.json
  • data/metaphors_by_category.csv
  • data/metaphors_catalog.json
  • docs/cultural-storytelling-guide.md
  • examples/before-and-after-headlines.md
  • examples/sample_draft_article.md
  • LICENSE
  • README.md
  • reports/voice_compliance_report.json
  • SKILL.md
  • src/brand_voice_linter.py
  • tests/test_voice.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 · python src/brand_voice_linter.py --help

Scope and limitations

  • Cultural Authenticity: Curated metaphors drawn from lived Egyptian and Gulf idioms to convey speed, reliability, economy, and luxury.
  • Tone Sensitivity: Classifies metaphors by customer journey stage to prevent informal slang from undermining luxury or B2B brand authority.
  • Demonstrative Editorial Selection: Provides illustrative creative copywriting examples, not formal linguistic statistical corpora.

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

Related repositories