Skip to content

docs: rewrite ocp-admin deploy & use instructions - #150

Open
r2dedios wants to merge 1 commit into
RHEcosystemAppEng:mainfrom
r2dedios:docs/ocp-admin-deploy-and-use
Open

docs: rewrite ocp-admin deploy & use instructions#150
r2dedios wants to merge 1 commit into
RHEcosystemAppEng:mainfrom
r2dedios:docs/ocp-admin-deploy-and-use

Conversation

@r2dedios

@r2dedios r2dedios commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

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 marketplacelola 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>
@r2dedios
r2dedios requested a review from dmartinol as a code owner August 3, 2026 12:54
@r2dedios r2dedios self-assigned this Aug 3, 2026
@r2dedios r2dedios added the documentation Improvements or additions to documentation label Aug 3, 2026

@dmartinol dmartinol left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

<!--
Catalog fragment — maintain via create-collection workflow (assistant + maintainer + PR review).
Golden sources: skills/*/SKILL.md, README.md, AGENTS.md
Deploy & Use instructions for the ocp-admin skill pack.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pls keep the original, as all the other catalog files have the same

- [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)
- [OpenClaw](https://github.com/openclaw/openclaw)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpenClaw is listed as a supported AI coding assistant, but it's actually a personal AI assistant gateway for messaging platforms (WhatsApp, Telegram, Slack, etc.) — not a coding assistant with MCP/editor integration like the others in this list. It likely shouldn't be listed alongside Claude Code, Copilot, Cursor, and Gemini CLI here.

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

## Deploy and use

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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/)


The pack provides 7 skills. See the [ocp-admin README](../README.md) for the full list with descriptions and usage examples.

### OS-specific setup

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really want to maintain these OS-specific instructions? Cant we just mention a generic requisite "install the following tools in your local environment" (which are probably already in the Prerequisites section)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants