Skip to content

Arabic README translation, Travel Advisor agent, and skill enhancements#1

Open
PYTHON01100100 wants to merge 8 commits intoMoshe-ship:mainfrom
PYTHON01100100:main
Open

Arabic README translation, Travel Advisor agent, and skill enhancements#1
PYTHON01100100 wants to merge 8 commits intoMoshe-ship:mainfrom
PYTHON01100100:main

Conversation

@PYTHON01100100
Copy link
Copy Markdown

@PYTHON01100100 PYTHON01100100 commented Mar 27, 2026

I've thoroughly read the repo and all 6 changed files. Here's a well-written PR description you can use:


PR Title

feat: Arabic README translation, Travel Advisor agent, and skill enhancements


PR Description

Overview

This PR adds several improvements to the مخلب plugin, focusing on Arabic-first documentation, a new Travel Advisor agent, and quality enhancements to existing skills.


Changes

📖 README.md — Arabic README Badge

Added an Arabic README badge ([![عربي](...)](README_AR.md)) to the main README, making it immediately visible to Arabic-speaking contributors and users that a full Arabic version exists.


📄 README_AR.md — Full Arabic Translation (New File)

Created a complete Arabic translation of the project README. This is a significant contribution (~310 lines) that makes مخلب truly accessible to Arabic-speaking developers who prefer to read documentation in their native language. The translation covers all sections: installation, skills catalog, architecture, model support, and contribution guidelines.


✈️ agents/travel-advisor/agent.md — New Travel Advisor Agent (New File)

Introduced a new agent configuration for an Arabic-first travel and visa advisor. This agent:

  • Helps users understand visa requirements based on nationality and destination
  • Detects whether entry is visa-free, eVisa, visa-on-arrival, or requires prior application
  • Prioritizes official government and embassy sources over aggregators
  • Handles multiple Arabic dialects (Gulf, Egyptian, etc.)
  • Includes a structured response format with visa status, requirements, and official source links
  • Has special handling for travel to Saudi Arabia with Saudi-official sources
  • Integrates with skills: travel-advisor-visa, arabic-web-search, saudi-tourism, arab-travel

🕌 skills/arab-travel/SKILL.md — Islamic Travel Supplications (du'as)

Enhanced the Arab Travel skill with a rich set of Islamic travel supplications (أدعية السفر), including:

  • دعاء الركوب (du'a when boarding a vehicle)
  • دعاء السفر (du'a during travel)
  • دعاء الوصول (du'a upon arrival)
  • دعاء الوداع (du'a for farewell)

The skill now serves these prayers to users when they ask about traveling by car, plane, or train — a culturally essential feature for Muslim Arabic-speaking users.


📅 skills/hijri-calendar/SKILL.md — Hijri Calendar Enhancements

Improved the Hijri Calendar skill with two additions:

  1. 29 Ramadan alert: Notifies users to watch for the Eid al-Fitr crescent moon announcement from their country.
  2. 29 Sha'ban alert: Notifies users to watch for the Ramadan crescent moon announcement and provides the Gregorian date of Ramadan.
  3. 29 Dhul Qa'dah alert: Notifies users about the Dhul Hijjah crescent moon, Arafah day date, and related events.
  4. Better context display: When asked about an occasion, the skill now shows both how many days remain and the current Hijri + Gregorian + Arabic day name together.

🔗 skills/travel-advisor-visa/SKILL.md — New Visa Advisor Skill (New File)

Added a new skill dedicated to visa lookup and travel entry requirements, supporting the Travel Advisor agent above.


Summary of Files Changed

File Type Lines Added
README.md Modified +1
README_AR.md New +310
agents/travel-advisor/agent.md New +103
skills/arab-travel/SKILL.md Modified +32
skills/hijri-calendar/SKILL.md Modified +6
skills/travel-advisor-visa/SKILL.md New ~240

Notes for Reviewer

As noted in the PR comments, the demo GIF currently doesn't display Arabic text (RTL) correctly. A re-recorded GIF showing Arabic text rendered properly with UTF-8 encoding is planned as a follow-up to make the demo accessible to Arabic users.


You can copy this directly into the PR description box. Want me to also write a shorter version, or a version in Arabic?

@PYTHON01100100 PYTHON01100100 changed the title ترجمة README إلى اللغة العربية وتحسين دعم العربية Arabic README translation, Travel Advisor agent, and skill enhancements Mar 28, 2026
@PYTHON01100100
Copy link
Copy Markdown
Author

I will return asap

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant