| name | yalla-social |
| description | Generate Arabic social media content for Instagram with bilingual hashtags and platform optimization |
| version | 1.0.0 |
| author | Mousa Abu Mazin |
| license | MIT |
| platforms | ["linux","macos"] |
| prerequisites | {"commands":[],"env_vars":[]} |
| metadata | {"hermes":{"tags":["social-media","arabic","instagram","content","marketing","yalla-ads"]}} |
Yalla Ads Social Media Content Generator
Generate Arabic social media content for Yalla Ads' Instagram account (@yallaadss). Supports multiple content formats with brand-consistent messaging and bilingual hashtags.
Brand Guidelines (CRITICAL)
Colors
- Primary: Orange (#E67E22)
- Secondary: Navy (#1B2E6E)
- Accent: White (#FFFFFF)
- Background options: Navy gradient, clean white, orange accent stripes
Tone
- Professional yet approachable
- Confident, not arrogant
- Educational and value-driven
- Speaks to SMB owners and marketing managers in MENA
- Modern Standard Arabic for body text
- Brand slogan "منوصلك للزبون الصحيح" can be used as a tagline
Visual Identity
- Play button triangle element in logo
- Glassmorphism design elements
- Clean, minimal layouts
- Arabic RTL text direction always
Content Formats
Format 1: Carousel Text (Slide Posts)
Generate text content for Instagram carousel posts (typically 5-10 slides).
Structure:
Slide 1 (Hook): Bold statement or question that stops scrolling
Slide 2-8 (Content): One key point per slide, short sentences
Slide 9 (Summary): Key takeaways
Slide 10 (CTA): Follow @yallaadss + website
Rules:
- Maximum 80 words per slide
- One idea per slide — do not cram
- Use Arabic numerals (١، ٢، ٣) for numbered lists
- Bold the key phrase or statistic on each slide
- Each slide should work standalone but flow as a story
- First slide must hook within 2 seconds of reading
Example topic structure:
Slide 1: "٩٠٪ من أصحاب المشاريع يخسرون ميزانيتهم الإعلانية — لا تكن منهم"
Slide 2: "السبب الأول: استهداف خاطئ"
Slide 3: [Explain targeting mistakes]
...
Slide 9: "الخلاصة: ٥ خطوات تحمي ميزانيتك"
Slide 10: "تابعنا @yallaadss | yalla-ads.com"
Format 2: Story Captions
Generate caption text for Instagram Stories (text overlays and companion captions).
Types:
- Quick tip: one actionable marketing tip (under 30 words on-screen)
- Poll/Question: engagement-driving question with 2 options
- Behind the scenes: casual brand moment (still in MSA)
- Stat of the day: striking marketing statistic with source
- Client win: success metric celebration (anonymized)
Rules:
- On-screen text: maximum 30 words (stories are viewed fast)
- Use large, readable text against branded backgrounds
- Include sticker suggestions: poll, question box, quiz, countdown
- Every 3rd story should have a CTA (swipe up / link / DM)
Output format for each story:
Story [number]:
Type: [Quick tip / Poll / Stat / etc.]
On-screen text: "[Arabic text, 30 words max]"
Background: [Navy / Orange gradient / White]
Sticker: [Poll with options / Question box / Quiz / None]
Caption (if shared to feed): "[longer caption if applicable]"
CTA: [None / Swipe up to yalla-ads.com / DM us / etc.]
Format 3: Reel Scripts
Generate scripts for short-form video Reels (30-60 seconds).
Structure:
Hook (0-3 sec): Pattern interrupt — bold claim or question
Problem (3-10 sec): Identify the pain point
Solution (10-25 sec): Teach the method/strategy
Proof (25-35 sec): Data point or quick case study
CTA (35-45 sec): Follow for more + visit yalla-ads.com
Rules:
- Total script: 100-180 words (spoken Arabic)
- Write it as spoken narration, not written text
- Still MSA but conversational register (formal but not stiff)
- Include on-screen text overlay suggestions for key moments
- Suggest background music mood (upbeat, corporate, dramatic)
- Include B-roll or visual suggestions for each segment
Output format:
Reel Title: "[Arabic title]"
Duration: [30s / 45s / 60s]
Music mood: [upbeat / corporate / dramatic / chill]
[Timecode] — [Segment]
Narration: "[spoken Arabic text]"
On-screen text: "[text overlay]"
Visual: [description of what should be shown]
[Repeat for each segment]
Caption: "[full Instagram caption with hashtags]"
Format 4: Single Post Caption
Generate a caption for a single Instagram image or graphic post.
Structure:
Line 1: Hook (first line visible before "more")
Line 2-3: Value/insight (the meat of the post)
Line 4: CTA or question to drive comments
Line 5: [blank line]
Line 6: Hashtags
Rules:
- First line must be compelling (it's the only visible text before "...more")
- Total caption: 150-300 words
- End with a question to drive engagement
- Separate hashtags with a blank line
Hashtag Strategy
Every post must include bilingual hashtags. Use this structure:
Core Brand Hashtags (include on every post)
#يلا_ادز #YallaAds #تسويق_رقمي #DigitalMarketing
Topic Hashtags (pick 5-8 relevant ones)
| Category | Arabic | English |
|---|
| Google Ads | #إعلانات_قوقل #اعلانات_جوجل | #GoogleAds #PPC |
| SEO | #تحسين_محركات_البحث #سيو | #SEO #SearchEngine |
| Social Media | #سوشال_ميديا #وسائل_التواصل | #SocialMedia #SocialMediaMarketing |
| Content | #صناعة_المحتوى #محتوى_رقمي | #ContentMarketing #ContentCreation |
| E-commerce | #تجارة_الكترونية #متجر_الكتروني | #Ecommerce #OnlineStore |
| Business | #ريادة_اعمال #مشاريع | #Entrepreneurship #SmallBusiness |
| Saudi | #السعودية #رؤية_2030 | #SaudiArabia #Vision2030 |
| UAE | #الامارات #دبي | #UAE #Dubai |
Location/Audience Hashtags (pick 3-5)
#تسويق_السعودية #تسويق_الامارات #اعلانات_رقمية
#MarketingTips #DigitalAgency #MENA
Total Hashtags Per Post
- Carousel/Single post: 20-25 hashtags
- Reel: 15-20 hashtags
- Story: 3-5 hashtags (if any)
Content Calendar Themes
When generating content, align with these weekly themes:
| Day | Theme | Content Type |
|---|
| Sunday | Marketing tip | Carousel or single post |
| Monday | Industry news / trends | Single post or reel |
| Tuesday | How-to tutorial | Carousel (educational) |
| Wednesday | Behind the brand | Story series |
| Thursday | Client results / case study | Single post or carousel |
| Friday | Engagement post (poll/question) | Story + post |
| Saturday | Weekend inspiration / motivation | Reel or single post |
Execution Steps
- Determine format: user specifies carousel, story, reel, or single post (or ask)
- Select topic: use a trending topic from
yalla-trends skill or user-provided topic
- Generate content: write the content following the format-specific rules above
- Add hashtags: compile bilingual hashtag set following the strategy
- Output: present the final content in a clean, copy-paste ready format
- Batch option: if the user asks, generate a full week of content (7 posts) following the calendar themes
Output Template
For every piece of content generated, output:
## [Format Type]: [Topic in Arabic]
**Platform:** Instagram (@yallaadss)
**Format:** [Carousel / Story / Reel / Single Post]
**Posting day:** [Suggested day based on calendar]
**Topic:** [Arabic topic name]
---
[Full content in the format-specific structure]
---
**Hashtags:**
[Full bilingual hashtag block]
**Design notes:**
- Primary color: Orange (#E67E22) or Navy (#1B2E6E) background
- [Any specific visual suggestions]
- [Font/layout notes]
Notes
- All Arabic text must be RTL-ready and use Arabic quotation marks (« ») where appropriate
- Numbers can use either Arabic (١٢٣) or Western (123) numerals depending on context — use Arabic numerals for lists and rankings, Western for statistics and data
- Keep content educational and value-driven — avoid hard sells
- Reference the yalla-ads.com website and @yallaadss handle in CTAs
- For carousel posts, suggest when to reuse content as Reels or Stories
- Seasonal content (Ramadan, Eid, Saudi National Day, UAE National Day, White Friday) should be flagged and prioritized when those dates are within 4 weeks
