docs: rewrite ocp-admin deploy & use instructions by r2dedios · Pull Request #150 · RHEcosystemAppEng/agentic-plugins

r2dedios · 2026-08-03T12:54:23Z

Summary

Rewrites ocp-admin/.catalog/deploy_and_use.md with validated, step-by-step installation instructions tested against Lola 0.7.0
Lists all 6 Lola-supported AI CLIs (claude-code, copilot-cli, copilot-vscode, cursor, gemini-cli, openclaw, opencode) instead of assuming Claude Code
Fixes lola marketplace → lola market command and corrects Lola repo link to LobsterTrap/lola
Adds OS-specific setup sections for Linux (Fedora/RHEL) and macOS
Installs CLI tools (regctl, cosign, syft) to ~/.local/bin — no sudo required
Removes regctl registry login from install steps (handled by skills at runtime)
Replaces inline skills table with a redirect to the pack README
Adds uninstall instructions (lola uninstall + lola market rm)
Adds Developer Preview notice

Test plan

Validated lola market add command against Lola 0.7.0
Validated lola install ocp-admin -a claude-code — installs 7 skills, 3 MCPs
Validated lola list shows installed module
Validated lola uninstall ocp-admin removes skills and MCP config
Verified 7 skills in table match ocp-admin/skills/*/ on disk

🤖 Generated with Claude Code

Rewrite the deploy_and_use.md document with validated, step-by-step installation instructions tested against Lola 0.7.0. - List all 6 Lola-supported AI CLIs instead of assuming Claude Code - Fix lola command: marketplace → market - Fix Lola repo link: LobsterTrap/lola - Add OS-specific setup sections (Linux/Fedora and macOS) - Install CLI tools (regctl, cosign, syft) to ~/.local/bin - Remove regctl registry login from install steps (handled by skills) - Remove skills table, redirect to pack README - Add uninstall instructions - Add Developer Preview notice Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

dmartinol

Thanks for your contribution! I have some doubts about these changes, as they affect a single pack, change the page layout in the catalog and create duplications (see the installation instructions).
Before merging pls consider the next comments, generate the catalog pages and review the generated sections.

dmartinol · 2026-08-03T15:28:45Z

+  Golden sources: skills/*/SKILL.md, README.md, AGENTS.md, mcps.json
 -->

+## Deploy and use


I'm concerned that it will change the layout of this pack but not other packs (these files are used to build the catalog as in https://rhecosystemappeng.github.io/agentic-catalog/)

We could update them again, but the docs update is becoming urgent

We could update them again, but the docs update is becoming urgent

From the agentic-catalog perspective, everything is fine: the installation steps are correctly reported and the RH catalog has its own settings. I don't see the urgency, unless we want to automate the deployment of these catalog items to production environment.

I meant urgent because there's people trying to start using the agentic-packs but the installation docs are wrong

I agree with @dmartinol .
I think that if we update any of the catalog files in a manner such as this, we should probably update the same files in each pack at the same time.

- Remove OS-specific setup section entirely - Move security skill dependencies to prerequisites as links - Keep install/uninstall and dev-preview banner

r2dedios · 2026-08-04T10:19:48Z

@dmartinol I updated the doc following your feedback. Please take a look

- Restore original catalog fragment HTML comment - Remove OpenClaw from supported AI CLIs (not a coding assistant)

dmartinol · 2026-08-04T15:38:39Z

@dmartinol I updated the doc following your feedback. Please take a look

If you want this to be merged, pls confirm it's not affecting the generation of agentic-catalog pages.

r2dedios · 2026-08-05T10:46:35Z

I updated the catalog script for generating the gh pages poiting to agentic-plugins repo and it worked well.

Most of all, I'd like to validate that this new docs are Ok, and if so, apply the same update to every agentic pack, so the docs are up to date

TomerFi

Thank you @r2dedios ! This is great work! We should do this for all the plugins, I just have some small comments.

TomerFi · 2026-08-07T15:16:25Z

+  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI or IDE extension)
+  - [GitHub Copilot](https://docs.github.com/en/copilot) (CLI or VS Code)
+  - [Cursor](https://www.cursor.com/)
+  - [Gemini CLI](https://github.com/google-gemini/gemini-cli)


Gemini CLI was shutdown in June, see deprecations table.
I'm not sure you can still install it, but if you can or you already have it installed, you can't run it. You'll get a message requsting you to install Antigravity (agy) instead. We have APPENG-5742 to track this.

I know Gemini CLI is still listed as supported in Lola, they have LobsterTrap/lola#218 for tracking Antigravity support.
But since just running Gemini CLI gives an error, and Agy is not supported yet. I would leave Gemini off this list.

TomerFi · 2026-08-07T15:17:39Z

 -->

+## Deploy and use
+**Note:** This skill pack is released as Developer Preview. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. For more information about the support scope of Red Hat Developer Preview features, see Developer Preview Support Scope.


see Developer Preview Support Scope

Can we add a link to that?

TomerFi · 2026-08-07T15:19:19Z

+  - [GitHub Copilot](https://docs.github.com/en/copilot) (CLI or VS Code)
+  - [Cursor](https://www.cursor.com/)
+  - [Gemini CLI](https://github.com/google-gemini/gemini-cli)
+  - [OpenCode](https://github.com/opencode-ai/opencode)


Suggested change

- [OpenCode](https://github.com/opencode-ai/opencode)

- [OpenCode](https://opencode.ai/)

Nitpicking, but I think directing users to the product pages is more consistent and appropriate. Feel free to dismiss.

TomerFi · 2026-08-07T15:21:08Z

- **Offline token** from [OpenShift offline token](https://cloud.redhat.com/openshift/token) for Assisted Installer and OCM APIs
- For **`/cluster-report`**: valid **`KUBECONFIG`** with contexts that point at real OpenShift clusters (read-only MCP mode)
+- At least one supported AI coding assistant:
+  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI or IDE extension)


Suggested change

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI or IDE extension)

- [Claude Code](https://claude.com/product/claude-code) (CLI or IDE extension)

Nitpicking, but I think directing users to the product pages is more consistent and appropriate. Feel free to dismiss.

TomerFi · 2026-08-07T15:21:49Z

- For **`/cluster-report`**: valid **`KUBECONFIG`** with contexts that point at real OpenShift clusters (read-only MCP mode)
+- At least one supported AI coding assistant:
+  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI or IDE extension)
+  - [GitHub Copilot](https://docs.github.com/en/copilot) (CLI or VS Code)


Suggested change

- [GitHub Copilot](https://docs.github.com/en/copilot) (CLI or VS Code)

- [GitHub Copilot](https://github.com/features/copilot) (CLI or VS Code)

Nitpicking, but I think directing users to the product pages is more consistent and appropriate. Feel free to dismiss.

TomerFi · 2026-08-07T15:29:27Z

+- [Lola](https://github.com/LobsterTrap/lola) CLI installed
+- [Podman](https://podman.io/) (or Docker) — the MCP servers run as containers
+- A Red Hat account with access to [cloud.redhat.com](https://cloud.redhat.com)
+- For security skills (`/container-cve-validator`, `/coreos-cve-validator`, `/image-inspect`):


Not a comment on this PR, more of a general wondering. I haven't notice before now that we depend on local installations for running skills, and I don't think it's a practice we've taken in other plugins. Was this tested with cloud assitants, i.e. ChatGPT? @dmartinol

TomerFi · 2026-08-07T15:33:57Z

+
+```bash
+# Add the Red Hat Agentic marketplace (one-time setup)
+lola market add rh-agentic-collection https://raw.githubusercontent.com/RHEcosystemAppEng/agentic-catalog/main/marketplace/rh-agentic-collection.yml


Suggested change

lola market add rh-agentic-collection https://raw.githubusercontent.com/RHEcosystemAppEng/agentic-catalog/main/marketplace/rh-agentic-collection.yml

lola market add rh-agentic-plugins https://raw.githubusercontent.com/RHEcosystemAppEng/agentic-catalog/main/marketplace/rh-agentic-collection.yml

Should we have named the underlying yaml file in the catalog rh-agentic-plugins.yml instead of the existing rh-agentic-collection.yml when we did the catalog repo seperation and name change?

TomerFi · 2026-08-07T15:40:36Z

+```

-Variable **names** must match **`mcps.json`** (use **`${...}`** placeholders only in git; never commit secrets).
+This installs the skills, the `AGENTS.md` routing file, and the `mcps.json` MCP server definitions into your project.


I think this line is too specific. AGENTS.md will only be created if you choose opencode as your target, for claudecode it will be CLAUDE.md. Also the mcps.json, each target as it own file name and placments, I would stay away from mentioning file names here to avoid confusion.

Also, I think it's more commonly known as an instructions file rather than a routing file.

TomerFi · 2026-08-07T15:43:20Z

 ```

-Module path: **`ocp-admin`** in **`marketplace/rh-agentic-collection.yml`** ([agentic-catalog](https://github.com/RHEcosystemAppEng/agentic-catalog)). See the root [README.md](../../README.md) for full prerequisites and MCP setup.
+To make these persistent, add them to your shell profile (`~/.bashrc`, `~/.zshrc`).


I'm not sure I would suggest users to save KUBECONFIG="/path/to/your/kubeconfig" in thier main shell profile. 😁

TomerFi · 2026-08-07T15:43:58Z

-
-**Linux vs macOS:** OpenShift MCP `podman` args may include user-namespace flags for `KUBECONFIG` mounts; adjust per the pack **README** if Podman runs in a VM.
+```bash
+lola market rm rh-agentic-collection


Suggested change

lola market rm rh-agentic-collection

lola market rm rh-agentic-plugins

Depending on your response to #150 (comment).

r2dedios requested a review from dmartinol as a code owner August 3, 2026 12:54

r2dedios self-assigned this Aug 3, 2026

r2dedios added the documentation Improvements or additions to documentation label Aug 3, 2026

dmartinol reviewed Aug 3, 2026

View reviewed changes

docs: simplify deploy_and_use per review feedback

e45e990

- Remove OS-specific setup section entirely - Move security skill dependencies to prerequisites as links - Keep install/uninstall and dev-preview banner

docs: address review feedback on deploy_and_use

52da338

- Restore original catalog fragment HTML comment - Remove OpenClaw from supported AI CLIs (not a coding assistant)

r2dedios requested a review from TomerFi August 6, 2026 15:30

TomerFi reviewed Aug 7, 2026

View reviewed changes

	- [OpenCode](https://github.com/opencode-ai/opencode)
	- [OpenCode](https://opencode.ai/)

	- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI or IDE extension)
	- [Claude Code](https://claude.com/product/claude-code) (CLI or IDE extension)

	- [GitHub Copilot](https://docs.github.com/en/copilot) (CLI or VS Code)
	- [GitHub Copilot](https://github.com/features/copilot) (CLI or VS Code)

	lola market add rh-agentic-collection https://raw.githubusercontent.com/RHEcosystemAppEng/agentic-catalog/main/marketplace/rh-agentic-collection.yml
	lola market add rh-agentic-plugins https://raw.githubusercontent.com/RHEcosystemAppEng/agentic-catalog/main/marketplace/rh-agentic-collection.yml

	lola market rm rh-agentic-collection
	lola market rm rh-agentic-plugins

Uh oh!

Conversation

r2dedios commented Aug 3, 2026

Summary

Test plan

Uh oh!

dmartinol left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

r2dedios commented Aug 4, 2026

Uh oh!

dmartinol commented Aug 4, 2026

Uh oh!

r2dedios commented Aug 5, 2026

Uh oh!

TomerFi left a comment

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

TomerFi Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

TomerFi Aug 7, 2026 •

edited

Loading

TomerFi Aug 7, 2026 •

edited

Loading

TomerFi Aug 7, 2026 •

edited

Loading

TomerFi Aug 7, 2026 •

edited

Loading

TomerFi Aug 7, 2026 •

edited

Loading

TomerFi Aug 7, 2026 •

edited

Loading