ROSA Docs And Structure Tests

openshift/rosa docs and structure tests

Keep CLI docs, structure tests, and user-facing guidance in sync when commands or workflow docs change.

323 tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

103

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/openshift/rosa --skill ROSA Docs And Structure Tests

The instruction itself

3 sections, as written by the author

ROSA Docs And Structure Tests

Use this skill when:

Command tree or flag changes are part of the task
Help text or generated CLI docs changed
AGENTS.md, CONTRIBUTING.md, guidelines/*-guidelines.md, PR templates, or issue forms are being updated

Workflow

If the command tree changes, update cmd/rosa/structure_test/command_structure.yml.
If flags change, update the matching cmd/rosa/structure_test/command_args/**/command_args.yml.
If command help text or generated docs should change, run make generate-docs.
Keep AGENTS.md, CLAUDE.md, GEMINI.md, CONTRIBUTING.md, guidelines/ARCHITECTURE.md, and .github/pull_request_template.md aligned when workflow wording changes.
Keep issue templates specific to real ROSA workflows and reproducible reports.
For AWS-facing docs, cross-check the official ROSA and AWS docs linked from AGENTS.md.

Verification

Re-read the edited docs for stale commands, placeholders, and drift from the real workflow.
Confirm command and flag docs match the structure-test files.
Run any required local verification from CONTRIBUTING.md.

How to use it

Copy the folder

Take openshift/rosa docs and structure tests from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.