[MRagabMob]

Adds "just ask your agent to install it" as README item 1, with the (easiest, recommended) badge moved off the AGENTS.md item. Items renumber to 1–7.

Verified, not assumed

Tested on both agents before documenting:

Agent	What actually happens
OpenAI Codex	Invokes its own $skill-installer, installs 17 files to ~/.codex/skills/paymob-integration
Claude Code	Copies the skill to ~/.claude/skills/paymob-integration/ and the three slash commands into ~/.claude/commands/ (creating that directory)

Three things testing surfaced that reading the docs would not have

The prompt has to carry the subdirectory. Codex did resolve skills/paymob-integration unaided — but only after searching the web and inspecting the repo layout, and its target directory already existed. An agent that guesses wrong installs the multi-agent plugin package as if it were a standalone skill. The documented prompt therefore includes /tree/main/skills/paymob-integration so nothing is left to inference.

A fresh session is required. Skills and commands are read at session start, so they do not appear in the session that installed them. This is the single most likely reason a user concludes the install failed, and it was undocumented.

This path does not give you the MCP server. Claude Code deliberately declined to register it, correctly — it is a persistent config change pointing at a live financial service. That is the real trade-off against the plugin install, so item 1 states it plainly and routes anyone wanting live account access to item 7 rather than leaving them to discover the gap later. Item 1 also notes the name collision you get from installing both ways: two paymob-integration skills with identical descriptions.

Also in here

• /reload-plugins is now documented. A shell claude plugin install does not take effect in a running session. This was missing and is a predictable support burden.
• marketplace.json gains a description. claude plugin validate . --strict — Anthropic's own validator, run against this repo — failed with No marketplace description provided. It now passes. validate.py enforces the field so it cannot regress.

On claude plugin marketplace add

I flagged in #8 that this might not exist as a shell command: both the plugins-reference and cli-reference pages enumerate claude plugin subcommands and neither lists marketplace.

That was wrong, and the README is correct as-is. I resolved it by fetching the published CLI and asking it directly:

$ claude plugin marketplace --help
Commands:
  add [options] <source>      Add a marketplace from a URL, path, or GitHub repo
  list [options]              List all configured marketplaces
  remove|rm [options] <name>  Remove a configured marketplace
  update [options] [name]     Update marketplace(s) from their source

add also takes --scope and --sparse. The docs are simply incomplete. No change made to the install commands or to the validate.py required string — recording it here so the question doesn't get reopened.

Test plan

• python scripts/validate.py passes
• claude plugin validate . --strict passes (failed before the description fix)
• python scripts/package_skill.py builds
• All 13 validate_install_docs required substrings intact through the renumbering
• Headings read 1–7 with exactly one easiest, recommended; #live-access--paymob-mcp-server and #installation anchors resolve to real headings (validate.py does not check #anchor targets, so this was checked by hand)

Sequencing

Stacked behind two open PRs, both of which should land first:

• Fix command reference paths so they resolve outside a plugin install #9 fixes the command reference paths. It matters here: the ask-an-agent path this PR promotes is exactly the install shape where ${CLAUDE_PLUGIN_ROOT} is never expanded, so without Fix command reference paths so they resolve outside a plugin install #9 the commands it installs cannot read their reference files.
• Document that kiosk and BNPL have no sandbox test path; fix /paymob-test-cards overpromising #8 corrects the kiosk/BNPL sandbox claims.

Both touch README.md, but in different sections from this PR, so conflicts are unlikely. Happy to rebase whichever lands last.