Skip to content

Create a skill to automate Compass catalog-info.yaml generation #151

Description

@r2dedios

Context

When adding a new skill to a pack, contributors must manually create a catalog-info.yaml Compass manifest following the template documented in CLAUDE.md (section "Adding Compass Manifests for a New Skill"). This involves:

  • Setting the correct namespace matching the pack name
  • Adding the right dependsOn references (plugin, MCP servers, other skills)
  • Updating the reverse dependencyOf in the plugin manifest, MCP server manifests, and any referenced skill manifests (bidirectional policy per COMPASS-1288 workaround)
  • Adding the file as a target in the pack's catalog-info.yaml Location

This is error-prone and tedious, especially the bidirectional relationship updates across multiple files.

Proposal

Create a Claude Code skill under .claude/skills/ that automates the generation of Compass manifests for new skills. Given a skill path (e.g., ocp-admin/skills/my-new-skill/), the skill should:

  1. Read the SKILL.md frontmatter to extract name, description, and dependencies
  2. Generate the catalog-info.yaml with correct namespace, metadata, and relations
  3. Update the pack's catalog-info.yaml Location to include the new target
  4. Update the plugin's dependencyOf list
  5. Update any referenced MCP server manifests with dependencyOf entries
  6. Update any referenced skill manifests with dependencyOf entries (for orchestration skills)

Origin

Requested by @dmartinol in PR #133 review feedback.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions