cluster-inventory

List and inspect OpenShift clusters across self-managed (OCP, SNO) and managed service (ROSA, ARO, OSD) deployments. Returns cluster name, ID, version, status, platform, and creation date. Use when: - "List all clusters" - "Show cluster status" - "What clusters are available?" - "Get details of cluster [name]" - "Show cluster events for diagnostics" Read-only operations. Does NOT modify clusters.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body with clear workflow sequencing, validation checkpoints, and real progressive-disclosure references. Minor conciseness duplication and a cross-skill INDEX.md symlink keep it just below a perfect score.

Suggestions

Deduplicate the 'Required MCP Tools' list (it appears in both Prerequisites and Dependencies) and consolidate the MCP-first policy statement into one place.

Fix references/INDEX.md: it is a symlink to ../../cluster-creator/references/INDEX.md, which points into another skill's bundle; replace it with an index local to this skill's references directory.

Tighten the Output Formatting section by moving the full table/bullet templates alongside their examples rather than describing formats and re-showing them in the examples, to reduce redundant tokens.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean and purposeful (concrete tool names, parameters, output templates) without explaining concepts Claude already knows, but the 'Required MCP Tools' list is duplicated across Prerequisites and Dependencies and the MCP-first policy is restated, which could be trimmed.	4 / 5
Actionability	Provides fully executable guidance: specific MCP tool names with parameters, server selection keyed on the 'source' field, type-detection logic, and worked examples with complete expected output covering the common cases.	5 / 5
Workflow Clarity	A clearly sequenced three-step workflow (list, get details, diagnostics) with prerequisite validation (MCP servers, OFFLINE_TOKEN), per-step error handling, and batch guardrails (5-concurrent-call limit, ask before bulk detail fetch) serving as checkpoints.	5 / 5
Progressive Disclosure	Overview content is appropriately inlined and references real one-level-deep files (troubleshooting.md, pvc-capacity-planning.md, database-connection-management.md) with clear 'consult when' signals, but references/INDEX.md is a symlink into another skill's directory (../../cluster-creator/references/INDEX.md), a minor navigation gap.	4 / 5
	Total	18 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that clearly states what the skill does and when to use it with concrete natural-language triggers. It is distinctive and read-only scoped, with only minor gaps in action-verb breadth and synonym coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (OpenShift clusters across OCP/SNO/ROSA/ARO/OSD) and concrete actions (list, inspect) plus the returned fields (name, ID, version, status, platform, creation date), but the action verbs themselves are only two, so it falls just short of comprehensive coverage at anchor 5.	4 / 5
Completeness	Explicitly answers both 'what' (list and inspect clusters, returns specific fields) and 'when' (a 'Use when:' clause with concrete trigger phrases), matching the anchor 5 example closely.	5 / 5
Trigger Term Quality	Includes natural user phrasings ('List all clusters', 'Show cluster status', 'What clusters are available?', 'Get details of cluster [name]', 'Show cluster events for diagnostics') with good coverage, but is missing a few common synonyms such as troubleshooting or logs.	4 / 5
Distinctiveness Conflict Risk	Carves a clear read-only OpenShift cluster inventory niche, enumerates cluster types, and explicitly states 'Does NOT modify clusters' while deferring create/modify/delete to other skills, giving minimal conflict risk.	5 / 5
	Total	18 / 20 Passed

Validation

81%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: RHEcosystemAppEng/agentic-plugins
Path: ocp-admin/skills/cluster-inventory/SKILL.md
Commit: e46c4fa

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.