@mediabubble-adv/arabic-skill
v1.2.8
Published
Awesome Arabic Skill runtime pack and npx installer.
Maintainers
Readme
Awesome Arabic Skill
cAwesome Arabic Skill (arabic) is a MediaBubble skill for Arabic content creation, strategy, research distillation, and review. It is designed to behave like a senior Arabic content partner inside AI coding tools: it reads context, clarifies intent, recommends a direction, writes, humanizes, and audits before delivery.
It is not a translation shortcut. Current version is 1.2.7 (signal presets + harness reports + nightly workflow; G1–G12 scenario manifest in 1.2.6; validation stack in 1.2.5).
user asks -> guide -> clarify -> recommend -> write -> reviewWhat It Does
| Capability | Current role |
| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
| Arabic content creation | Captions, ads, landing pages, blogs, scripts, sales copy, books, UI microcopy, and professional documents |
| Dialect routing | Masri-first, pan-Arab capable, with 11 dialect modules |
| Humanization | Removes translationese, AI phrasing, stiff rhythm, and wrong register |
| Project awareness | /arabic auto scans project files so the skill can explain a product, tool, or codebase in natural Arabic |
| Research intelligence | research/ layer + /arabic research; distills into runtime via PR + golden tests |
| First-run onboarding | /arabic guide (Path A) and /arabic init (Path B) with .arabic/ templates |
| Command system | /arabic with subcommands for guide, write, audit, coach, plan, research, voice, auto, init, and help |
| Website dogfooding | Shipped at v1.1.0 — install site (8 Masri routes, dogfood /about) |
Install
Full Cursor integration (recommended)
Copies the runtime skill, /arabic slash command, and routing rule:
npx @mediabubble-adv/arabic-skill@latest install --target cursorFrom a git clone of this repo, npx without @latest resolves the local package and fails (command not found: arabic-skill). Use @latest above, or npm run install:cursor, or node bin/arabic-skill.js install --target cursor.
skills.sh registry
Install the skill via the open agent skills CLI (skill pack only; use npm install above for full Cursor integration):
npx skills add mediabubble-adv/arabic-skill -a cursor -g -yBrowse: skills.sh · Listing is driven by install telemetry from npx skills add.
Other targets
npx @mediabubble-adv/arabic-skill@latest install --target claude
npx @mediabubble-adv/arabic-skill@latest install --target codex
npx @mediabubble-adv/arabic-skill@latest install --target all
npx @mediabubble-adv/arabic-skill@latest install --dir ~/.cursor/skills --forceSee Cursor support, Claude support, or the supported tools index. The repo documents 24 AI coding surfaces (profiles below). Install website: https://arabic-skill.vercel.app
After install
/arabic guide ← first run (advisory, no repo setup)
/arabic init ← scaffold .arabic/ in a client project
/arabic write caption --dialect masri --count 3In a client repo, run /arabic init before --brief or plan workflows. Templates ship in arabic/templates/.arabic/.
Supported Tool Assets
The repository includes local logo assets under [public/assets/](./public/assets/) for README, docs, and the install website. GitHub renders these relative paths directly in Markdown, so docs can use either Markdown images or HTML <img> tags when fixed icon sizing is needed.
Tool profiles (24)
| Tool | Fit | Install | Profile |
| ---------------- | ------- | --------------------- | ------------------------------------------------------ |
| Aider | Strong | manual | Profile |
| Amp | Strong | manual | Profile |
| Antigravity | Partial | manual | Profile |
| ChatGPT | Partial | manual | Profile |
| Claude | Strong | npx --target claude | Profile |
| Cline | Strong | manual | Profile |
| Codex | Strong | npx --target codex | Profile |
| Continue | Partial | manual | Profile |
| Copilot | Partial | manual | Profile |
| Cursor | Strong | npx --target cursor | Profile |
| Gemini | Partial | manual | Profile |
| Hermes Agent | Partial | manual | Profile |
| JetBrains Junie | Partial | manual | Profile |
| Kilo Code | Partial | manual | Profile |
| Kiro | Partial | manual | Profile |
| OpenClaw | Partial | manual | Profile |
| OpenCode | Partial | manual | Profile |
| OpenHands | Strong | manual | Profile |
| Qwen | Limited | manual | Profile |
| Replit Agent | Partial | manual | Profile |
| Sourcegraph Cody | Partial | manual | Profile |
| VS Code | Partial | manual | Profile |
| Windsurf | Strong | manual | Profile |
| Zed | Strong | manual | Profile |
Fit tiers and packaging notes: Support Matrix. Tools without an npx preset use manual copy paths documented in each profile (or npx … install --dir <skills-path>).
Usage Examples
Natural language works:
Write 5 Masri Instagram captions for a fitness app launch in Cairo.Audit this Arabic landing page. It sounds translated and too formal.Scan this project and explain what it does in human Arabic for non-technical users.The command surface makes the same workflows faster:
/arabic guide
/arabic write meta --dialect masri --brief .arabic/briefs/fitness-launch.yaml
/arabic audit --file content/landing-ar.md
/arabic coach --file prompt.txt
/arabic plan website --dialect masri
/arabic research meta-ads
/arabic auto/arabic Command Model
The product direction is one root command, not dozens of independent skills:
| Command | Purpose |
| ---------------------------- | ----------------------------------------------- |
| /arabic or /arabic guide | Advisory flow for unclear ideas |
| /arabic write <type> | Pro mode for complete briefs |
| /arabic audit | Arabic copy review and scoring |
| /arabic coach | Arabic prompt improvement |
| /arabic plan <project> | Websites, campaigns, books, and brand systems |
| /arabic research <topic> | Structured research collection and distillation |
| /arabic init | Scaffold .arabic/ workspace in a client repo |
| /arabic voice | Brand voice save, load, and show |
| /arabic auto | Workspace-aware inference from project files |
| /arabic help | Copy-ready usage reference |
Full spec: Command Surface.
Project-Aware Arabic Content
A core capability is making the skill useful inside real repositories and product folders. The workspace scanner rules inspect files such as README.md, docs, routes, package metadata, examples, and product copy, then produce Arabic content that explains the project in clear human language.
Expected outputs include:
- Arabic product summaries for non-technical users
- Arabic install and usage tutorials
- Arabic landing-page copy based on actual project capabilities
- Arabic README sections, changelogs, release notes, and help pages
- Dialect-aware explanations for tools, apps, APIs, and SaaS products
This behavior is routed through /arabic auto, Project Mode, Dev-Tech domain support, and the runtime project-context scanner.
Repository Structure
arabic-skill/
├── arabic/ # Runtime skill pack users install
│ ├── SKILL.md # Master router, name: arabic
│ ├── dialects/ # 11 dialect modules
│ ├── domains/ # 12 industry packs
│ ├── conversations/ # Sales, support, negotiation, coaching, podcast, community
│ ├── professional-docs/ # Contracts, AI skills, agent rules, compliance language
│ ├── references/ # Engines, intake, templates, humanization, QA support
│ └── templates/.arabic/ # Onboarding scaffold (config, briefs, README)
├── research/ # Collected intelligence, citation registry, distillation queue
├── reference/ # 38 canonical specialist packs, kept as source material
├── docs/ # Product, planning, analysis, engineering, supported tools
├── website/ # Next.js marketing site (G13–G18, live on Vercel)
├── tests/golden/ # Golden fixtures (G1–G18, R*, RQ*) + scenario manifest
├── scripts/ # Validation scripts (npm run validate)
├── bin/arabic-skill.js # npx installer CLI
├── VERSION # Current product version
└── CHANGELOG.mdRuntime install folder is arabic/. The GitHub repo can stay mediabubble-adv/arabic-skill.
Development Status
| Area | Status |
| -------------------- | ----------------------------------------------------------------------------------------------------- |
| Runtime pack | arabic/ at v1.2.7 — advisory-first router, load discipline, onboarding |
| Canonical references | 38 packs preserved in reference/ |
| Research layer | R0–R4 ✅ — research/, /arabic research, validate-research.sh, monthly cron |
| /arabic commands | Shipped — router, Cursor adapter, init, auto, research |
| Website | v1.1.0 ✅ — https://arabic-skill.vercel.app (G13–G18) |
| npm distribution | @mediabubble-adv/[email protected] — npx install + publish CI |
| Golden tests | Structural + routing + scenario gates in CI; Playwright G15–G16; golden:harness + nightly workflow |
| Next train | 1.2.8+ — tune presets from nightly report artifacts |
Documentation
| Doc | Purpose |
| --------------------------------------------------------------------------- | --------------------------------------------------- |
| Docs Index | Full documentation map |
| PRD | Product vision and success criteria |
| Roadmap | Release train and phase sequence |
| Implementation Plan | File-by-file build plan |
| Claude Plan Audit Prompt | Prompt for Claude to audit and rewrite the plan set |
| Research Intelligence Plan | Internet + AI + reference research workflow |
| Research Monthly Cron | Scheduled research maintenance |
| Command Surface | /arabic grammar and subcommands |
| Reference Distillation | How reference/ becomes runtime behavior |
| Supported Tools | Install profiles for AI tools |
Validation
npm run validateRuns skill reference integrity, frontmatter schema, docs links, supported-tool parity, website install copy (G14), npm pack contents, Cursor install dry-run, research scaffold + stale-source checks, onboarding templates, golden fixture structure, G1–G12 routing contracts, and G1–G12 scenario manifest parity. Website UX: npm run validate:website-playwright (CI website-e2e). Opt-in LLM runs: npm run golden:harness (not in default CI).
Individual gates:
./scripts/validate-skill.sh
./scripts/validate-frontmatter.sh
./scripts/validate-docs.sh
./scripts/validate-research.sh
./scripts/validate-reference-sync.sh
./scripts/validate-onboarding.sh
./scripts/validate-golden.sh
./scripts/validate-behavioral-golden.sh
./scripts/validate-golden-scenarios.sh
./scripts/validate-website-playwright.sh
npm run golden:harness -- --list
npm run golden:harness -- --run --dry-run
npm run golden:harness -- --run --report autoRelease Policy
0.1.x— development baseline.v1.0.0— first public release (P1–P6, G1–G12).v1.1.x— website (G13–G18), npm publish, P8 runtime extensions.v1.2.x— full Cursor npx install, skills.sh, research R0–R4, onboarding, validation stack (current:1.2.7).- Future tags only after documented gates pass.
Positioning
Awesome Arabic Skill: Masri-first, pan-Arab capable. A skill that helps you think, brief, plan, write, explain, and audit Arabic content.
License
MIT. See LICENSE.
Built for the Arab world by MediaBubble · 2026
