docs: add multi-ecosystem plugin installation instructions#4
Conversation
Provides explicit installation commands for setting up Outline Skills as a plugin or extension across Codex, Claude Code, and Gemini CLI. Co-authored-by: Antigravity <antigravity@google.com>
Greptile SummaryThis PR expands the
Confidence Score: 3/5Safe to merge only after fixing the Claude Code install command — as written, users following the instructions will hit an error. The Claude Code section instructs users to run README.md — specifically the Claude Code install block Important Files Changed
Sequence DiagramsequenceDiagram
participant User
participant Codex as Codex CLI (npx skills)
participant ClaudeCode as Claude Code
participant GeminiCLI as Gemini CLI
participant GitHub as GitHub Repo
User->>Codex: npx skills add url
Codex->>GitHub: Fetch plugin from URL
GitHub-->>Codex: Plugin installed
User->>ClaudeCode: /plugin install url (current - incorrect)
ClaudeCode-->>User: Treats URL as marketplace.json link, fails
User->>ClaudeCode: /plugin marketplace add OutlineFoundation/outline-skills
ClaudeCode->>GitHub: Clone repo, read marketplace.json
GitHub-->>ClaudeCode: Marketplace registered
User->>ClaudeCode: "/plugin install outline-skills@outline-skills"
ClaudeCode-->>User: Plugin installed
User->>GeminiCLI: gemini extensions install url
GeminiCLI->>GitHub: Fetch extension from URL
GitHub-->>GeminiCLI: Extension installed
Reviews (1): Last reviewed commit: "docs: add multi-ecosystem plugin install..." | Re-trigger Greptile |
| To install as a Claude Code plugin, run inside your interactive Claude Code session: | ||
|
|
||
| ```shell | ||
| /plugin install https://github.com/OutlineFoundation/outline-skills | ||
| ``` |
There was a problem hiding this comment.
The
/plugin install command expects a <plugin-name>@<marketplace> argument — not a raw HTTPS URL. An HTTPS URL without a .git suffix is treated by Claude Code as a direct link to a hosted marketplace.json, not as a GitHub repository. The correct flow is to first register the repo as a marketplace with /plugin marketplace add, then install the named plugin from it. The repository will also need a .claude-plugin/marketplace.json file (in addition to plugin.json) for the marketplace discovery step to work.
| To install as a Claude Code plugin, run inside your interactive Claude Code session: | |
| ```shell | |
| /plugin install https://github.com/OutlineFoundation/outline-skills | |
| ``` | |
| To install as a Claude Code plugin, run inside your interactive Claude Code session: | |
| ```shell | |
| /plugin marketplace add OutlineFoundation/outline-skills | |
| /plugin install outline-skills@outline-skills |
|
Converting to draft. I want to add the marketplace wrappers. And perhaps some screenshots. |
Provides explicit installation commands for setting up Outline Skills as a plugin or extension across Codex, Claude Code, and Gemini CLI.