docs: add GitHub tree URL format to ralph add examples

Users browsing a GitHub repo and copying the URL get a /tree/branch/path
format. This is supported by the parser but wasn't shown in any docs
examples, making it a hidden feature. Added it to CLI reference, quick
reference, and troubleshooting.

Co-authored-by: Ralphify <noreply@ralphify.co>

Author: 2 people

docs/cli.md

@@ -138,19 +138,21 @@ The command detects your agent and installs a skill to guide the creation proces
 Add a ralph from a GitHub repository. Installs it to `.ralphify/ralphs/<name>/` so you can run it by name.
 
 ```bash
-ralph add owner/repo                    # Install repo as a ralph (or all ralphs in the repo)
-ralph add owner/repo/ralph-name         # Install a specific ralph by name
-ralph add https://github.com/owner/repo # Full GitHub URL also works
+ralph add owner/repo                                        # Install all ralphs in the repo
+ralph add owner/repo/ralph-name                             # Specific ralph by name
+ralph add https://github.com/owner/repo                     # Full GitHub URL
+ralph add https://github.com/owner/repo/tree/main/my-ralph  # URL copied from GitHub browser
 ```
 
 | Argument | Default | Description |
 |---|---|---|
-| `SOURCE` | required | GitHub source: `owner/repo` or `owner/repo/ralph-name` |
+| `SOURCE` | required | GitHub source — shorthand (`owner/repo`), subpath (`owner/repo/path`), or full GitHub URL |
 
 **How it resolves:**
 
 - `owner/repo` — if the repo root contains `RALPH.md`, installs it as a single ralph named after the repo. Otherwise, finds and installs all ralphs in the repo.
 - `owner/repo/ralph-name` — searches the repo for a directory named `ralph-name` containing `RALPH.md`. If multiple matches are found, prints the paths and asks you to use the full subpath to disambiguate.
+- `https://github.com/owner/repo/tree/branch/path` — extracts the path from the URL. This is the format you get when you copy a URL from the GitHub web UI while browsing a directory. The branch name is used only to locate the path — `ralph add` always clones the default branch.
 
 After adding, run the ralph by name:
 

docs/quick-reference.md

@@ -28,6 +28,7 @@ ralph new docs                     # AI-guided creation with name pre-filled
 
 ralph add owner/repo               # Install ralph(s) from a GitHub repo
 ralph add owner/repo/my-ralph      # Install a specific ralph by name
+ralph add https://github.com/owner/repo/tree/main/my-ralph  # URL from GitHub
 
 ralph --version                    # Show version
 ```

docs/troubleshooting.md

@@ -46,11 +46,14 @@ The agent CLI isn't installed or isn't in your shell's PATH. Verify by running `
 The source format wasn't recognized. `ralph add` accepts these formats:
 
 ```bash
-ralph add owner/repo                         # shorthand
-ralph add owner/repo/ralph-name              # specific ralph
-ralph add https://github.com/owner/repo      # full URL
+ralph add owner/repo                                        # shorthand
+ralph add owner/repo/ralph-name                             # specific ralph
+ralph add https://github.com/owner/repo                     # full URL
+ralph add https://github.com/owner/repo/tree/main/my-ralph  # URL copied from GitHub
 ```
 
+The easiest way to add a ralph from GitHub is to navigate to the directory in your browser and copy the URL — it works directly with `ralph add`.
+
 ### "git clone failed"
 
 The repository couldn't be cloned. Common causes: