collection-compliance

Diagnose and resolve validation failures in the .catalog/ directory.

48|31|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill collection-compliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: collection-compliance
Source: https://github.com/RHEcosystemAppEng/agentic-plugins/tree/main/.claude/skills/collection-compliance
Command: npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill collection-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses and resolves validation failures in the .catalog/ directory, ensuring that the catalog meets schema, roster, banner, sample workflows, and JSON mirror requirements.

Core Features & Use Cases

  • Validation Failure Diagnose and Fix: Identify and rectify common collection compliance errors.
  • Schema Alignment: Ensure YAML content aligns with predefined schema standards.
  • Roster Verification: Confirm that all required skills are correctly listed in the catalog.
  • Banner and Collection.json Sync: Validate that collection.yaml and collection.json are in sync.
  • Fragment Provenance: Ensure that all referenced fragments are correctly formatted and sourced.
  • AI Semantic Alignment Review: Conduct a review to ensure metadata aligns with golden sources.

Quick Start

Run the collection-compliance skill with the command: uv run python scripts/validate_collection_compliance.py

Frequently Asked Questions about collection-compliance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix validation failures in my AI agent's .catalog directory?

To fix .catalog validation failures, run the Python validation script to diagnose and resolve schema, roster, banner, sample workflow, and JSON mirror errors. It aligns YAML content and metadata with predefined golden sources to ensure full catalog compliance.

What is AI semantic alignment review for catalog metadata?

AI semantic alignment review verifies that catalog metadata correctly matches golden sources. It ensures YAML content and referenced fragments meet predefined schema standards and maintain accurate provenance across the skill collection.

How do I verify my skill roster and collection.yaml are compliant?

Roster verification confirms all required skills are correctly listed in the catalog. The compliance script checks the roster and synchronizes collection.yaml with collection.json to validate banner and JSON mirror requirements.

Do I need Python to run catalog compliance checks?

Yes, Python is required to execute catalog compliance checks. You run the validation process using the command uv run python scripts/validate_collection_compliance.py to diagnose and rectify collection compliance errors.

Why are my collection.yaml and collection.json out of sync?

Collection.yaml and collection.json desync when metadata updates are not mirrored across both files. The compliance skill validates this banner and collection.json sync to ensure both formats maintain identical schema alignment.

What is the best way to ensure fragment provenance in a skill collection?

The best way to ensure fragment provenance is using a validation script to verify all referenced fragments are correctly formatted and sourced from golden sources. This maintains schema alignment and catalog compliance within the directory.