agentleFS
JamalMohafilJamalMohafil/claude-skills/claude-arabic/SKILL.md

claude-arabic

Skill27 starsChanged 54 days agoMITView on GitHub

One-command setup of "Claude Arabic Terminal" — makes Claude Code render Arabic / Persian / Hebrew / Urdu correctly inside VS Code (connected letters, right-to-left order) on macOS and Windows. Installs a VS Code extension plus an `arabic` launcher so the user can run `arabic claude` (with any Claude flags) and get an Arabic-capable Claude pane in the VS Code terminal area. Use when the user says "claude arabic", "Arabic looks broken / reversed / disconnected in the terminal", "install claude arabic", "RTL in VS Code terminal", or wants Claude Code to show Arabic properly in VS Code.

  • Pipes a download into a shell
  • Deletes or force-pushes

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 1

    1. Kareim-Malek/claude-arabic-terminal★ 094% same

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 0 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run the installer for the user's OS, verify it worked, and finish by telling them the single command they need from now on: arabic claude.

    line 18
  2. Very specific:

    If curl/irm is blocked, clone the repo manually and run ./install.sh or .\install.ps1 from inside it.

    line 46
  3. Very specific:

    Every Claude Code flag passes through unchanged: arabic claude --dangerously-skip-permissions, arabic claude --resume, arabic claude …

    line 64

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Claude Arabic Terminal

VS Code's terminal (xterm.js) cannot render right-to-left scripts: Arabic comes out with disconnected letters and reversed word order, and nothing in settings fixes it. This skill installs a small VS Code extension that runs Claude Code in a pseudo-terminal, keeps the screen in a headless terminal emulator, and renders it as HTML inside VS Code — so the browser engine does the Arabic shaping and bidi, exactly like claude.ai.

Repository: https://github.com/JamalMohafil/claude-arabic-terminal

Your job

Run the installer for the user's OS, verify it worked, and finish by telling them the single command they need from now on: arabic claude.

Steps

1. Check prerequisites (stop and tell the user if one is missing)

  • git, node (18+), npm — git --version, node -v, npm -v
  • Claude Code CLI — claude --version
  • VS Code with the code CLI — code --version (if code is missing on macOS: VS Code → Cmd+Shift+P → "Shell Command: Install 'code' command in PATH")

2. Run the installer

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/JamalMohafil/claude-arabic-terminal/main/install.ps1 | iex

The installer clones the repo to ~/.claude-arabic-terminal, runs npm install, links the extension into ~/.vscode/extensions/, and puts the arabic launcher in ~/.local/bin (added to PATH if needed). Re-running it updates an existing install.

If curl/irm is blocked, clone the repo manually and run ./install.sh or .\install.ps1 from inside it.

3. Verify

  • ls ~/.vscode/extensions | grep claude-arabic (Windows: dir $env:USERPROFILE\.vscode\extensions) shows jamal.claude-arabic-terminal-<version>
  • command -v arabic (Windows: Get-Command arabic) resolves — if not, the user must open a new terminal so PATH refreshes
  • ls ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds lists darwin-* / win32-*

4. Tell the user exactly this

  1. Reload VS Code: Cmd/Ctrl+Shift+P → "Developer: Reload Window"
  2. From now on, in any VS Code terminal, run:

    arabic claude

    Every Claude Code flag passes through unchanged: arabic claude --dangerously-skip-permissions, arabic claude --resume, arabic claude --model opus

  3. The first launch shows "Allow 'Claude Arabic Terminal' to open this URI?" — tick "Do not ask me again for this extension" and click Open.

Claude Code opens as an Arabic-capable pane inside the VS Code terminal area, running in the folder the command was launched from.

Troubleshooting

SymptomFix
arabic: command not foundOpen a new terminal (PATH was just updated), or run ~/.local/bin/arabic claude
URI dialog appears but nothing opensVS Code hasn't reloaded since install — Developer: Reload Window
"claude exited with code 1" immediatelyRun claude in a normal terminal first to finish login / trust the folder
Extension doesn't load on macOS (posix_spawnp failed)chmod +x ~/.claude-arabic-terminal/node_modules/node-pty/prebuilds/*/spawn-helper
Want it as an editor tab instead of the terminal areaCommand Palette → "Claude Arabic Terminal: Open in Editor Tab"

Uninstall

rm -rf ~/.claude-arabic-terminal ~/.vscode/extensions/jamal.claude-arabic-terminal-* ~/.local/bin/arabic

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.