diff --git a/CLAUDE.md b/CLAUDE.md index 3f3dbf10..47a137ad 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,6 +12,8 @@ Contributors work here to create, improve, and validate skills. An internal proc ``` agentic-plugins/ +├── catalog-info.yaml # Root Location — entry point for Compass ingestion +├── system.yaml # System entity (agentic-plugins) — models the whole repo ├── rh-sre/ # Site Reliability Engineering pack (reference implementation) ├── rh-developer/ # Developer tools pack ├── ocp-admin/ # OpenShift administration pack @@ -20,6 +22,7 @@ agentic-plugins/ ├── rh-ai-engineer/ # AI Engineering pack ├── rh-automation/ # Automation pack ├── rh-support-engineer/ # Support engineering pack +├── mcps/ # MCP server Compass manifests (System + 9 MCPServer entities) ├── eval/ # Skill evaluation reports (report.json + report.md per skill) ├── scripts/ # Validation and CI helper scripts ├── catalog/ # JSON Schema for .catalog/collection.yaml validation @@ -37,6 +40,8 @@ Each pack is persona-specific and follows this structure: ``` / +├── catalog-info.yaml # Location entity — indexes this pack's Compass manifests +├── -plugin.yaml # AiResource (type: plugin) — defines the pack itself ├── AGENTS.md # AI Context Module instruction routing (persona, skills, rules) ├── README.md # Pack description, persona, target marketplaces ├── mcps.json # MCP server configurations (uses env vars for credentials) @@ -45,7 +50,8 @@ Each pack is persona-specific and follows this structure: │ └── collection.json # Deterministic JSON mirror of collection.yaml ├── skills/ # Specialized task executors (including orchestration skills) │ └── / -│ └── SKILL.md # Skill definition with YAML frontmatter +│ ├── SKILL.md # Skill definition with YAML frontmatter +│ └── catalog-info.yaml # AiResource (type: skill) — Compass manifest └── docs/ # AI-optimized knowledge base (optional, rh-sre reference) ``` @@ -53,6 +59,97 @@ Each pack is persona-specific and follows this structure: Each pack's `.catalog/` directory contains metadata that describes the pack for the marketplace. This metadata stays here, alongside the skills it describes. The catalog build process reads it from this repo to assemble the unified marketplace. The golden sources are always `SKILL.md`, `AGENTS.md`, `README.md`, and `mcps.json` — `.catalog/` is derived from them, never the other way around. +### Compass / Backstage Manifests + +The repository is registered in [Red Hat Compass](https://compass.redhat.com) (internal Backstage instance) through a hierarchy of Backstage entity manifests. All manifests use `apiVersion: backstage.io/v1alpha1` except MCPServer entities which use `apiVersion: mcp/v1beta1`. + +#### Entity Kinds + +| Kind | Purpose | spec.type | Count | +|------|---------|-----------|-------| +| **Location** | Index that references other manifest files | — | 9 (1 root + 7 packs + 1 mcps) | +| **System** | Top-level grouping for the repository and MCP servers | — | 2 (`agentic-plugins`, `rh-agentic-plugins-mcps`) | +| **AiResource** | Skills and pack definitions | `plugin` (packs) / `skill` (skills) / `rule` | 7 packs + 75 skills | +| **MCPServer** | MCP server configurations | `local` | 9 | + +#### Location Hierarchy + +Compass ingests a single root Location. Everything else is discovered through delegation: + +``` +catalog-info.yaml (root Location) +├── system.yaml → System: agentic-plugins +├── ocp-admin/catalog-info.yaml → Location → ocp-admin-plugin.yaml + 7 skills +├── rh-sre/catalog-info.yaml → Location → rh-sre-plugin.yaml + 13 skills +├── rh-virt/catalog-info.yaml → Location → rh-virt-plugin.yaml + 10 skills +├── rh-developer/catalog-info.yaml → Location → rh-developer-plugin.yaml + 17 skills +├── rh-basic/catalog-info.yaml → Location → rh-basic-plugin.yaml + 6 skills +├── rh-ai-engineer/catalog-info.yaml → Location → rh-ai-engineer-plugin.yaml + 11 skills +├── rh-automation/catalog-info.yaml → Location → rh-automation-plugin.yaml + 11 skills +└── mcps/catalog-info.yaml → Location → system.yaml + 9 MCPServers +``` + +#### Entity Relationships + +- **AiResource (plugin) → System**: Each pack plugin has `spec.system: agentic-plugins` (generates `partOf` relation) +- **AiResource (skill) → AiResource (plugin)**: Each skill has `spec.dependsOn: [airesource:/]` +- **AiResource (skill) → AiResource (skill)**: Orchestration skills reference other skills via `spec.dependsOn` +- **AiResource → MCPServer**: Skills and plugins reference MCP servers via `spec.dependsOn: [mcpserver:rh-agentic-plugins-mcps/]` +- **MCPServer → System**: Each MCP server has `spec.system: rh-agentic-plugins-mcps` +- **All entities → Group**: `spec.owner: group:redhat/ecosystem-appeng` + +#### Namespaces + +Each pack uses its own namespace matching the pack name (e.g., `rh-sre`, `ocp-admin`). All MCP servers share the namespace `rh-agentic-plugins-mcps`. The root System `agentic-plugins` uses the `default` namespace. + +#### Entity Reference Formats + +- Skills: `airesource:/` +- Pack plugins: `airesource:/` +- MCP servers: `mcpserver:rh-agentic-plugins-mcps/` + +#### Adding Compass Manifests for a New Skill + +When adding a skill, create `skills//catalog-info.yaml`: +```yaml +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: + namespace: + title: + description: > + + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main//skills//SKILL.md + tags: + - ai-skill + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - + categories: + - + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:/ + # Add mcpserver and airesource dependencies as needed +``` + +Then add the file as a target in the pack's `catalog-info.yaml` Location. + ## Contributing Skills are added directly to this repository, inside an existing pack. The contributor opens a PR, skills are reviewed and merged, and maintainers own them from that point. Use `/agentic-contribution-skill` in Claude Code or follow [CONTRIBUTING.md](CONTRIBUTING.md). @@ -165,6 +262,7 @@ last_updated: YYYY-MM-DD ### Files - Skills: `skills//SKILL.md` (uppercase SKILL.md) +- Compass manifests: `catalog-info.yaml` (Locations), `-plugin.yaml` (pack AiResource), `system.yaml` (System entities) - Docs: Lowercase with dashes, categorized by directory ## Development Workflow @@ -176,7 +274,11 @@ last_updated: YYYY-MM-DD 3. Add `AGENTS.md` with persona, skill-first rule, intent routing table, MCP servers, and global rules (see [rh-ai-engineer/AGENTS.md](rh-ai-engineer/AGENTS.md) for reference) 4. Create `skills/` directory 5. Add `mcps.json` when the pack integrates MCP servers (use `${VAR}` for secrets) -6. Update main `README.md` table with link +6. Create Compass manifests: + - `-plugin.yaml` — AiResource with `type: plugin`, `system: agentic-plugins` + - `catalog-info.yaml` — Location targeting the plugin file and all skill catalog-info.yaml files +7. Add the pack's `catalog-info.yaml` as a target in the root `catalog-info.yaml` +8. Update main `README.md` table with link ### Adding a Skill @@ -192,8 +294,10 @@ last_updated: YYYY-MM-DD - Dependencies declaration 4. Include concrete examples and complete error handling 5. Update the pack's `AGENTS.md` intent routing table to include the new skill -6. Test with `Skill` tool invocation -7. Validate with `uv run python scripts/validate_skills_tier1.py /skills//SKILL.md` +6. Create `skills//catalog-info.yaml` Compass manifest (see "Adding Compass Manifests for a New Skill") +7. Add the skill's `catalog-info.yaml` as a target in the pack's `catalog-info.yaml` Location +8. Test with `Skill` tool invocation +9. Validate with `uv run python scripts/validate_skills_tier1.py /skills//SKILL.md` **Collection-Specific Standards:** - **rh-virt**: Follow `rh-virt/SKILL_TEMPLATE.md` for enhanced quality standards including mandatory Common Issues and Example Usage sections diff --git a/catalog-info.yaml b/catalog-info.yaml new file mode 100644 index 00000000..a52d1887 --- /dev/null +++ b/catalog-info.yaml @@ -0,0 +1,26 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: agentic-plugins + title: Agentic Plugins + description: > + Root catalog entry point for the agentic-plugins repository. + Points to all agentic pack locations and MCP server manifests + for Compass ingestion. + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + # Repository-level system + - ./system.yaml + # Agentic Pack Locations + - ./ocp-admin/catalog-info.yaml + - ./rh-sre/catalog-info.yaml + - ./rh-virt/catalog-info.yaml + - ./rh-developer/catalog-info.yaml + - ./rh-basic/catalog-info.yaml + - ./rh-ai-engineer/catalog-info.yaml + - ./rh-automation/catalog-info.yaml + # MCP Servers Location + - ./mcps/catalog-info.yaml diff --git a/mcps/ai-observability.yaml b/mcps/ai-observability.yaml new file mode 100644 index 00000000..3938adb4 --- /dev/null +++ b/mcps/ai-observability.yaml @@ -0,0 +1,35 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: ai-observability + title: AI Observability MCP Server + description: > + AI observability MCP server for monitoring and debugging AI/ML model + inference, performance metrics, and serving runtime health on + Red Hat OpenShift AI. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/mcps.json + tags: + - ai + - observability + - machine-learning + - monitoring + - mcp-server + links: + - url: https://github.com/rh-ai-quickstart/ai-observability-summarizer + title: Upstream Repository + icon: github +spec: + type: remote + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: [] + packages: [] + remotes: + - url: ${AI_OBSERVABILITY_MCP_URL}/mcp + environment_variables: + - description: AI observability MCP server base URL + name: AI_OBSERVABILITY_MCP_URL diff --git a/mcps/ansible-automation-platform.yaml b/mcps/ansible-automation-platform.yaml new file mode 100644 index 00000000..f62435d3 --- /dev/null +++ b/mcps/ansible-automation-platform.yaml @@ -0,0 +1,54 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: ansible-automation-platform + title: Ansible Automation Platform MCP Server + description: > + Ansible Automation Platform MCP server providing job management, + inventory management, configuration, security compliance, system + monitoring, and user management operations via remote HTTP endpoints. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/mcps.json + tags: + - ansible + - aap + - automation + - mcp-server + links: + - url: https://github.com/ansible/aap-mcp-server + title: Upstream Repository + icon: github +spec: + type: remote + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: [] + packages: [] + remotes: + - url: https://${AAP_MCP_SERVER}/job_management/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER + - url: https://${AAP_MCP_SERVER}/inventory_management/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER + - url: https://${AAP_MCP_SERVER}/configuration/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER + - url: https://${AAP_MCP_SERVER}/security_compliance/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER + - url: https://${AAP_MCP_SERVER}/system_monitoring/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER + - url: https://${AAP_MCP_SERVER}/user_management/mcp + environment_variables: + - description: AAP MCP server hostname + name: AAP_MCP_SERVER diff --git a/mcps/assisted-installer.yaml b/mcps/assisted-installer.yaml new file mode 100644 index 00000000..7410bb99 --- /dev/null +++ b/mcps/assisted-installer.yaml @@ -0,0 +1,99 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: assisted-installer + title: OpenShift Assisted Installer MCP Server + description: > + Red Hat Assisted Installer MCP server for OpenShift cluster lifecycle + management. Supports both self-managed clusters (OCP, SNO) via the + Assisted Installer API and managed service clusters (ROSA, ARO, OSD) + via the OCM API. Handles creation, configuration, installation, and + credential retrieval. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/mcps.json + tags: + - openshift + - assisted-installer + - cluster-management + - mcp-server + links: + - url: https://github.com/openshift-assisted/assisted-service-mcp + title: Upstream Repository + icon: github +spec: + type: local + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: + - type: tool + name: list_versions + description: List available OpenShift versions for installation. + - type: tool + name: create_cluster + description: Create a new OpenShift cluster definition and infrastructure environment. + - type: tool + name: cluster_info + description: Get comprehensive information about a specific cluster. + - type: tool + name: cluster_events + description: Get chronological events for cluster installation progress and diagnostics. + - type: tool + name: cluster_iso_download_url + description: Get ISO download URL for cluster boot images. + - type: tool + name: install_cluster + description: Start the OpenShift installation process for a prepared cluster. + - type: tool + name: cluster_credentials_download_url + description: Get presigned download URL for cluster credentials after installation. + - type: tool + name: cluster_logs_download_url + description: Get the logs URL for a cluster. + - type: tool + name: list_clusters + description: List all clusters for the current user. + - type: tool + name: set_cluster_platform + description: Set or update the infrastructure platform type for a cluster. + - type: tool + name: set_cluster_ssh_key + description: Set or update the SSH public key for a cluster. + - type: tool + name: set_cluster_vips + description: Configure virtual IP addresses for cluster API and ingress traffic. + - type: tool + name: set_host_role + description: Assign a specific role to a discovered host in the cluster. + - type: tool + name: host_events + description: Get events specific to a particular host for diagnostics. + - type: tool + name: list_operator_bundles + description: List available operator bundles that can be added to clusters. + - type: tool + name: add_operator_bundle_to_cluster + description: Add an operator bundle to be automatically installed with the cluster. + - type: tool + name: list_static_network_config + description: List all static network configurations for cluster hosts. + - type: tool + name: generate_nmstate_yaml + description: Generate an initial NMState YAML for static network configuration. + - type: tool + name: validate_nmstate_yaml + description: Validate an NMState YAML document before applying to hosts. + - type: tool + name: alter_static_network_config_nmstate_for_host + description: Add, replace, or delete static network configuration for a host. + packages: + - type: container + registry_name: quay.io + name: ecosystem-appeng/assisted-service-mcp + version: sha256:e3e84602c6ef2882dc0737e7ad0fafd16d39887dce9f4fb399c470b11158f486 + environment_variables: + - description: Red Hat offline token for API authentication + name: OFFLINE_TOKEN + remotes: [] diff --git a/mcps/catalog-info.yaml b/mcps/catalog-info.yaml new file mode 100644 index 00000000..19c08d01 --- /dev/null +++ b/mcps/catalog-info.yaml @@ -0,0 +1,20 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: agentic-plugins-mcps + title: Agentic Plugins MCP Servers + description: > + Points to the MCP system and all MCP server manifests + used across agentic packs. + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./openshift-mcp-server.yaml + - ./assisted-installer.yaml + - ./ansible-automation-platform.yaml + - ./ai-observability.yaml + - ./rhoai.yaml + - ./podman.yaml + - ./github.yaml diff --git a/mcps/github.yaml b/mcps/github.yaml new file mode 100644 index 00000000..cdbd79c9 --- /dev/null +++ b/mcps/github.yaml @@ -0,0 +1,36 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: github + title: GitHub MCP Server + description: > + GitHub MCP server for repository operations, pull request management, + issue tracking, and code search across GitHub repositories. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/mcps.json + tags: + - github + - developer + - source-control + - mcp-server + links: + - url: https://github.com/github/github-mcp-server + title: Upstream Repository + icon: github +spec: + type: local + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: [] + packages: + - type: container + registry_name: ghcr.io + name: github/github-mcp-server + version: "1.0.3" + environment_variables: + - description: GitHub personal access token + name: GITHUB_PERSONAL_ACCESS_TOKEN + remotes: [] diff --git a/mcps/openshift-mcp-server.yaml b/mcps/openshift-mcp-server.yaml new file mode 100644 index 00000000..57e4452c --- /dev/null +++ b/mcps/openshift-mcp-server.yaml @@ -0,0 +1,56 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: openshift-mcp-server + title: OpenShift MCP Server + description: > + Red Hat OpenShift MCP server for interacting with OpenShift Container Platform + clusters and its operators. Provides access to cluster resources, node metrics, + configuration contexts, virtualization, Helm, observability, and service mesh + toolsets depending on configuration. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/mcps.json + tags: + - openshift + - kubernetes + - cluster-operations + - mcp-server + links: + - url: https://github.com/openshift/openshift-mcp-server + title: Upstream Repository + icon: github +spec: + type: local + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: + - type: tool + name: configuration_contexts_list + description: List available kubeconfig contexts for cluster access. + - type: tool + name: resources_get + description: Get details of a specific Kubernetes resource. + - type: tool + name: resources_list + description: List Kubernetes resources by type and namespace. + - type: tool + name: nodes_top + description: Get node resource usage metrics (CPU, memory). + - type: tool + name: namespaces_list + description: List all namespaces in the cluster. + - type: tool + name: pods_list + description: List pods with status and resource information. + packages: + - type: container + registry_name: quay.io + name: ecosystem-appeng/openshift-mcp-server + version: sha256:3531cb78f51f8c7ebcdb21adc21358ab8924116994848a3ce1ff542b3fc23742 + environment_variables: + - description: Path to kubeconfig file for cluster authentication + name: KUBECONFIG + remotes: [] diff --git a/mcps/podman.yaml b/mcps/podman.yaml new file mode 100644 index 00000000..f8b28bb7 --- /dev/null +++ b/mcps/podman.yaml @@ -0,0 +1,34 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: podman + title: Podman MCP Server + description: > + Podman MCP server for container management operations. + Provides container lifecycle management, image operations, + and local container runtime interaction. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/mcps.json + tags: + - podman + - containers + - developer + - mcp-server + links: + - url: https://github.com/manusa/podman-mcp-server + title: Upstream Repository + icon: github +spec: + type: local + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: [] + packages: + - type: npx + name: podman-mcp-server + version: 0.0.15 + environment_variables: [] + remotes: [] diff --git a/mcps/rhoai.yaml b/mcps/rhoai.yaml new file mode 100644 index 00000000..1ac85747 --- /dev/null +++ b/mcps/rhoai.yaml @@ -0,0 +1,35 @@ +apiVersion: mcp/v1beta1 +kind: MCPServer +metadata: + namespace: agentic-plugins + name: rhoai + title: Red Hat OpenShift AI MCP Server + description: > + Red Hat OpenShift AI (RHOAI) MCP server for managing data science projects, + model serving, model registry, workbenches, and ML pipelines on the + OpenShift AI platform. + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/mcps.json + tags: + - rhoai + - openshift-ai + - machine-learning + - model-serving + - mcp-server + links: + - url: https://github.com/opendatahub-io/rhoai-mcp + title: Upstream Repository + icon: github +spec: + type: local + lifecycle: beta + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + primitives: [] + packages: + - type: uvx + name: rhoai-mcp + version: git+https://github.com/opendatahub-io/rhoai-mcp@31576c61b6f59280704c86dde1e3e9ed79def5e5 + environment_variables: [] + remotes: [] diff --git a/ocp-admin/catalog-info.yaml b/ocp-admin/catalog-info.yaml new file mode 100644 index 00000000..5fa5aa57 --- /dev/null +++ b/ocp-admin/catalog-info.yaml @@ -0,0 +1,26 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: ocp-admin + title: OpenShift Administration Agentic Pack + description: > + Points to all AI skill catalog entities in the ocp-admin agentic pack + for Red Hat OpenShift administration. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: ocp-admin + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: ocp-admin + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./ocp-admin-plugin.yaml + - ./skills/cluster-creator/catalog-info.yaml + - ./skills/cluster-inventory/catalog-info.yaml + - ./skills/cluster-report/catalog-info.yaml + - ./skills/container-cve-validator/catalog-info.yaml + - ./skills/coreos-cve-validator/catalog-info.yaml + - ./skills/cve-recon/catalog-info.yaml + - ./skills/image-inspect/catalog-info.yaml diff --git a/ocp-admin/ocp-admin-plugin.yaml b/ocp-admin/ocp-admin-plugin.yaml new file mode 100644 index 00000000..d1edff4f --- /dev/null +++ b/ocp-admin/ocp-admin-plugin.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: ocp-admin + namespace: ocp-admin + title: OpenShift Administration + description: > + Administration and management tools for OpenShift Container Platform + including cluster lifecycle management, multi-cluster operations, + workload orchestration, and security policies. + tags: + - ai-skill + - openshift + - cluster-management + - administration + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: ocp-admin + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: ocp-admin + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - platform-engineering + categories: + - cluster-management + - administration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:agentic-plugins/assisted-installer + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/ocp-admin/skills/cluster-creator/catalog-info.yaml b/ocp-admin/skills/cluster-creator/catalog-info.yaml new file mode 100644 index 00000000..46d6b47c --- /dev/null +++ b/ocp-admin/skills/cluster-creator/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cluster-creator + namespace: ocp-admin + title: OpenShift Cluster Creator + description: > + End-to-end OpenShift cluster creation using Red Hat Assisted Installer. + Handles SNO and HA multi-node clusters on baremetal, vsphere, oci, nutanix. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/cluster-creator/SKILL.md + + tags: + - ai-skill + - openshift + - cluster-management + - assisted-installer + - provisioning + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + - infrastructure + categories: + - automation + - provisioning + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin + - mcpserver:agentic-plugins/assisted-installer diff --git a/ocp-admin/skills/cluster-inventory/catalog-info.yaml b/ocp-admin/skills/cluster-inventory/catalog-info.yaml new file mode 100644 index 00000000..96fe21af --- /dev/null +++ b/ocp-admin/skills/cluster-inventory/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cluster-inventory + namespace: ocp-admin + title: OpenShift Cluster Inventory + description: > + List and inspect OpenShift clusters across self-managed (OCP, SNO) + and managed service (ROSA, ARO, OSD) deployments. + Read-only operations. Does NOT modify clusters. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/cluster-inventory/SKILL.md + + tags: + - ai-skill + - openshift + - cluster-management + - inventory + - monitoring + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + - infrastructure + categories: + - monitoring + - inventory + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin + - mcpserver:agentic-plugins/assisted-installer diff --git a/ocp-admin/skills/cluster-report/catalog-info.yaml b/ocp-admin/skills/cluster-report/catalog-info.yaml new file mode 100644 index 00000000..d087a7fc --- /dev/null +++ b/ocp-admin/skills/cluster-report/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cluster-report + namespace: ocp-admin + title: OpenShift Cluster Health Report + description: > + Generate a consolidated health report across multiple OpenShift clusters. + Verifies each kubeconfig context is a genuine OpenShift cluster before reporting. + Non-OpenShift contexts are skipped by default. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/cluster-report/SKILL.md + + tags: + - ai-skill + - openshift + - cluster-management + - health-check + - reporting + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + - sre + categories: + - monitoring + - reporting + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/ocp-admin/skills/container-cve-validator/catalog-info.yaml b/ocp-admin/skills/container-cve-validator/catalog-info.yaml new file mode 100644 index 00000000..f7de9b02 --- /dev/null +++ b/ocp-admin/skills/container-cve-validator/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: container-cve-validator + namespace: ocp-admin + title: Container CVE Validator + description: > + Validate a CVE against a Red Hat container image using official SBOM + attestations, Red Hat VEX data, and CVE metadata from MITRE/OSV.dev. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/container-cve-validator/SKILL.md + + tags: + - ai-skill + - openshift + - security + - cve + - sbom + - container + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + - devops + categories: + - security + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin diff --git a/ocp-admin/skills/coreos-cve-validator/catalog-info.yaml b/ocp-admin/skills/coreos-cve-validator/catalog-info.yaml new file mode 100644 index 00000000..ba4fc0c5 --- /dev/null +++ b/ocp-admin/skills/coreos-cve-validator/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: coreos-cve-validator + namespace: ocp-admin + title: CoreOS CVE Validator + description: > + Validate a CVE against Red Hat Enterprise Linux CoreOS (RHCOS) in a specific + OCP release by extracting RPM packages and checking Red Hat VEX data. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/coreos-cve-validator/SKILL.md + + tags: + - ai-skill + - openshift + - security + - cve + - coreos + - rhcos + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + - devops + categories: + - security + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin diff --git a/ocp-admin/skills/cve-recon/catalog-info.yaml b/ocp-admin/skills/cve-recon/catalog-info.yaml new file mode 100644 index 00000000..7f9b8369 --- /dev/null +++ b/ocp-admin/skills/cve-recon/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cve-recon + namespace: ocp-admin + title: CVE Reconnaissance + description: > + Query MITRE, OSV.dev, and Go vulnerability database to produce a structured + report of affected packages, ecosystems, and vulnerable version ranges for a CVE. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/cve-recon/SKILL.md + + tags: + - ai-skill + - security + - cve + - reconnaissance + - vulnerability + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - security + - reconnaissance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin diff --git a/ocp-admin/skills/image-inspect/catalog-info.yaml b/ocp-admin/skills/image-inspect/catalog-info.yaml new file mode 100644 index 00000000..dec28576 --- /dev/null +++ b/ocp-admin/skills/image-inspect/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: image-inspect + namespace: ocp-admin + title: Container Image Inspector + description: > + Fetch container image labels, validate registry ownership, resolve tag/digest + via SBOM, and report the SBOM artifact reference for a Red Hat container image. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/ocp-admin/skills/image-inspect/SKILL.md + + tags: + - ai-skill + - security + - container + - sbom + - image-inspection + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + - devops + categories: + - security + - inspection + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:ocp-admin/ocp-admin diff --git a/rh-ai-engineer/catalog-info.yaml b/rh-ai-engineer/catalog-info.yaml new file mode 100644 index 00000000..7b7fc796 --- /dev/null +++ b/rh-ai-engineer/catalog-info.yaml @@ -0,0 +1,30 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-ai-engineer + title: AI Engineering Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-ai-engineer agentic pack + for Red Hat OpenShift AI and machine learning workflows. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-ai-engineer + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-ai-engineer + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-ai-engineer-plugin.yaml + - ./skills/ai-observability/catalog-info.yaml + - ./skills/debug-inference/catalog-info.yaml + - ./skills/ds-project-setup/catalog-info.yaml + - ./skills/guardrails-config/catalog-info.yaml + - ./skills/model-deploy/catalog-info.yaml + - ./skills/model-monitor/catalog-info.yaml + - ./skills/model-registry/catalog-info.yaml + - ./skills/nim-setup/catalog-info.yaml + - ./skills/pipeline-manage/catalog-info.yaml + - ./skills/serving-runtime-config/catalog-info.yaml + - ./skills/workbench-manage/catalog-info.yaml diff --git a/rh-ai-engineer/rh-ai-engineer-plugin.yaml b/rh-ai-engineer/rh-ai-engineer-plugin.yaml new file mode 100644 index 00000000..c26e8da7 --- /dev/null +++ b/rh-ai-engineer/rh-ai-engineer-plugin.yaml @@ -0,0 +1,45 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-ai-engineer + namespace: rh-ai-engineer + title: AI Engineering + description: > + Automation tools for AI/ML engineers working with Red Hat OpenShift AI. + Deploy and manage models, pipelines, registries, workbenches, and + serving runtimes on OpenShift AI. + tags: + - ai-skill + - ai-engineering + - openshift-ai + - machine-learning + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-ai-engineer + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-ai-engineer + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - ai-engineering + categories: + - model-management + - ml-ops + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/ai-observability/catalog-info.yaml b/rh-ai-engineer/skills/ai-observability/catalog-info.yaml new file mode 100644 index 00000000..1e91f865 --- /dev/null +++ b/rh-ai-engineer/skills/ai-observability/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: ai-observability + namespace: rh-ai-engineer + title: AI Observability + description: > + Analyze AI model performance, GPU utilization, and cluster health on OpenShift AI. + Query-driven, read-only analysis that routes to the appropriate observability domain + based on user intent. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/ai-observability/SKILL.md + tags: + - ai-skill + - ai-engineering + - observability + - gpu + - monitoring + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - monitoring + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/debug-inference/catalog-info.yaml b/rh-ai-engineer/skills/debug-inference/catalog-info.yaml new file mode 100644 index 00000000..eb57d93e --- /dev/null +++ b/rh-ai-engineer/skills/debug-inference/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-inference + namespace: rh-ai-engineer + title: Debug Inference + description: > + Troubleshoot failed or slow InferenceService deployments on OpenShift AI. + Progressive diagnosis covering status conditions, events, pod logs, GPU health, + and observability analysis. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/debug-inference/SKILL.md + tags: + - ai-skill + - ai-engineering + - debugging + - inference + - troubleshooting + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/ds-project-setup/catalog-info.yaml b/rh-ai-engineer/skills/ds-project-setup/catalog-info.yaml new file mode 100644 index 00000000..12f90883 --- /dev/null +++ b/rh-ai-engineer/skills/ds-project-setup/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: ds-project-setup + namespace: rh-ai-engineer + title: DS Project Setup + description: > + Create and configure Data Science Projects on OpenShift AI with namespace setup, + S3 data connections, pipeline server, and model serving enablement. Bootstraps an + RHOAI Data Science Project with proper labels, data connections, pipeline + infrastructure, and model serving configuration. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/ds-project-setup/SKILL.md + tags: + - ai-skill + - ai-engineering + - data-science + - openshift-ai + - project-setup + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - machine-learning + categories: + - configuration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/guardrails-config/catalog-info.yaml b/rh-ai-engineer/skills/guardrails-config/catalog-info.yaml new file mode 100644 index 00000000..399f4f33 --- /dev/null +++ b/rh-ai-engineer/skills/guardrails-config/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: guardrails-config + namespace: rh-ai-engineer + title: Guardrails Config + description: > + Configure TrustyAI Guardrails Orchestrator for LLM input/output content safety on + OpenShift AI. Handles GuardrailsOrchestrator CR deployment, detector configuration + (content safety, PII, prompt injection, toxicity), orchestration policies, and + guarded endpoint validation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/guardrails-config/SKILL.md + tags: + - ai-skill + - ai-engineering + - guardrails + - content-safety + - trustyai + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - configuration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/model-deploy/catalog-info.yaml b/rh-ai-engineer/skills/model-deploy/catalog-info.yaml new file mode 100644 index 00000000..4968d22c --- /dev/null +++ b/rh-ai-engineer/skills/model-deploy/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: model-deploy + namespace: rh-ai-engineer + title: Model Deploy + description: > + Deploy AI/ML models on OpenShift AI using KServe with vLLM, NVIDIA NIM, or + Caikit+TGIS runtimes. Handles runtime selection, GPU validation, InferenceService + CR creation, and rollout monitoring. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/model-deploy/SKILL.md + tags: + - ai-skill + - ai-engineering + - model-serving + - kserve + - deployment + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/model-monitor/catalog-info.yaml b/rh-ai-engineer/skills/model-monitor/catalog-info.yaml new file mode 100644 index 00000000..10a1d334 --- /dev/null +++ b/rh-ai-engineer/skills/model-monitor/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: model-monitor + namespace: rh-ai-engineer + title: Model Monitor + description: > + Configure TrustyAI model monitoring for bias detection and data drift on deployed + InferenceServices. Handles TrustyAIService deployment, bias metric configuration + (SPD, DIR), drift metric configuration (MeanShift, FourierMMD, KS-Test, + Jensen-Shannon), threshold tuning, and monitoring validation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/model-monitor/SKILL.md + tags: + - ai-skill + - ai-engineering + - trustyai + - bias-detection + - drift-detection + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - monitoring + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/model-registry/catalog-info.yaml b/rh-ai-engineer/skills/model-registry/catalog-info.yaml new file mode 100644 index 00000000..33d2d221 --- /dev/null +++ b/rh-ai-engineer/skills/model-registry/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: model-registry + namespace: rh-ai-engineer + title: Model Registry + description: > + Register, version, and manage ML models in the OpenShift AI Model Registry. + Browse the Model Catalog, track model metadata, and promote models across + environments. Handles model registration, versioning, metadata management, + artifact tracking, and cross-environment promotion. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/model-registry/SKILL.md + tags: + - ai-skill + - ai-engineering + - model-registry + - versioning + - mlops + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - machine-learning + categories: + - management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai + - airesource:rh-ai-engineer/model-deploy diff --git a/rh-ai-engineer/skills/nim-setup/catalog-info.yaml b/rh-ai-engineer/skills/nim-setup/catalog-info.yaml new file mode 100644 index 00000000..3198edad --- /dev/null +++ b/rh-ai-engineer/skills/nim-setup/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: nim-setup + namespace: rh-ai-engineer + title: NIM Setup + description: > + Configure NVIDIA NIM platform on OpenShift AI for optimized model inference. + One-time prerequisite before deploying models with NVIDIA NIM runtime via + model-deploy. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/nim-setup/SKILL.md + tags: + - ai-skill + - ai-engineering + - nvidia-nim + - gpu + - inference + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - configuration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/pipeline-manage/catalog-info.yaml b/rh-ai-engineer/skills/pipeline-manage/catalog-info.yaml new file mode 100644 index 00000000..054e8818 --- /dev/null +++ b/rh-ai-engineer/skills/pipeline-manage/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: pipeline-manage + namespace: rh-ai-engineer + title: Pipeline Manage + description: > + Create, run, schedule, and monitor Data Science Pipelines (Kubeflow Pipelines 2.0) + on OpenShift AI. Handles pipeline server setup, pipeline run submission from YAML, + scheduling recurring runs, monitoring execution, and viewing step logs. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/pipeline-manage/SKILL.md + tags: + - ai-skill + - ai-engineering + - pipelines + - kubeflow + - mlops + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - machine-learning + categories: + - management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/serving-runtime-config/catalog-info.yaml b/rh-ai-engineer/skills/serving-runtime-config/catalog-info.yaml new file mode 100644 index 00000000..520ec7f6 --- /dev/null +++ b/rh-ai-engineer/skills/serving-runtime-config/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: serving-runtime-config + namespace: rh-ai-engineer + title: Serving Runtime Config + description: > + Configure custom ServingRuntime CRs on OpenShift AI for model serving frameworks + not covered by built-in runtimes. Handles listing existing runtimes, creating new + ServingRuntime CRs, and validating compatibility with target models. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/serving-runtime-config/SKILL.md + tags: + - ai-skill + - ai-engineering + - serving-runtime + - model-serving + - configuration + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - ai + categories: + - configuration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-ai-engineer/skills/workbench-manage/catalog-info.yaml b/rh-ai-engineer/skills/workbench-manage/catalog-info.yaml new file mode 100644 index 00000000..cb188b01 --- /dev/null +++ b/rh-ai-engineer/skills/workbench-manage/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: workbench-manage + namespace: rh-ai-engineer + title: Workbench Manage + description: > + Create and manage Jupyter notebook workbenches on OpenShift AI with image selection, + resource configuration, PVC storage, and lifecycle management. Handles Notebook CR + lifecycle including create with configurable images and resources, start/stop, + attach storage, and delete with data loss warnings. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-ai-engineer/skills/workbench-manage/SKILL.md + tags: + - ai-skill + - ai-engineering + - jupyter + - workbench + - notebook + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - machine-learning + categories: + - management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai diff --git a/rh-automation/catalog-info.yaml b/rh-automation/catalog-info.yaml new file mode 100644 index 00000000..0ba29951 --- /dev/null +++ b/rh-automation/catalog-info.yaml @@ -0,0 +1,30 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-automation + title: Automation Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-automation agentic pack + for Red Hat Ansible Automation Platform workflows. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-automation + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-automation + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-automation-plugin.yaml + - ./skills/aap-mcp-validator/catalog-info.yaml + - ./skills/execution-risk-analyzer/catalog-info.yaml + - ./skills/execution-summary/catalog-info.yaml + - ./skills/forensic-troubleshooter/catalog-info.yaml + - ./skills/governance-assessor/catalog-info.yaml + - ./skills/governance-executor/catalog-info.yaml + - ./skills/governance-readiness-assessor/catalog-info.yaml + - ./skills/governed-job-launcher/catalog-info.yaml + - ./skills/host-fact-inspector/catalog-info.yaml + - ./skills/job-failure-analyzer/catalog-info.yaml + - ./skills/resolution-advisor/catalog-info.yaml diff --git a/rh-automation/rh-automation-plugin.yaml b/rh-automation/rh-automation-plugin.yaml new file mode 100644 index 00000000..66864e9c --- /dev/null +++ b/rh-automation/rh-automation-plugin.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-automation + namespace: rh-automation + title: Automation + description: > + Automation governance for Ansible Automation Platform. Audit AAP + configuration against Red Hat best practices, run governed execution + with check mode and rollback, and perform forensic failure analysis. + tags: + - ai-skill + - ansible + - automation + - governance + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-automation + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-automation + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - operations + categories: + - automation + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/aap-mcp-validator/catalog-info.yaml b/rh-automation/skills/aap-mcp-validator/catalog-info.yaml new file mode 100644 index 00000000..874379c9 --- /dev/null +++ b/rh-automation/skills/aap-mcp-validator/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: aap-mcp-validator + namespace: rh-automation + title: AAP MCP Validator + description: > + Validate that required AAP MCP servers are accessible before executing + automation skills. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/aap-mcp-validator/SKILL.md + tags: + - ai-skill + - automation + - ansible + - validation + - mcp + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/execution-risk-analyzer/catalog-info.yaml b/rh-automation/skills/execution-risk-analyzer/catalog-info.yaml new file mode 100644 index 00000000..9b3e6d36 --- /dev/null +++ b/rh-automation/skills/execution-risk-analyzer/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: execution-risk-analyzer + namespace: rh-automation + title: Execution Risk Analyzer + description: > + Analyze execution risk by classifying inventory, scanning extra_vars for + secrets, and assessing scope. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/execution-risk-analyzer/SKILL.md + tags: + - ai-skill + - automation + - ansible + - risk-analysis + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/execution-summary/catalog-info.yaml b/rh-automation/skills/execution-summary/catalog-info.yaml new file mode 100644 index 00000000..d3c21c86 --- /dev/null +++ b/rh-automation/skills/execution-summary/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: execution-summary + namespace: rh-automation + title: Execution Summary + description: > + Generate concise execution audit reports tracking documents consulted, MCP + tools used, decisions made, and outcomes. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/execution-summary/SKILL.md + tags: + - ai-skill + - automation + - ansible + - reporting + - audit + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - reporting + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/forensic-troubleshooter/catalog-info.yaml b/rh-automation/skills/forensic-troubleshooter/catalog-info.yaml new file mode 100644 index 00000000..28ac5cc1 --- /dev/null +++ b/rh-automation/skills/forensic-troubleshooter/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: forensic-troubleshooter + namespace: rh-automation + title: Forensic Troubleshooter + description: > + Orchestrates forensic analysis of failed jobs with event extraction, host + correlation, and resolution advisory. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/forensic-troubleshooter/SKILL.md + tags: + - ai-skill + - automation + - ansible + - troubleshooting + - forensics + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/job-failure-analyzer + - airesource:rh-automation/host-fact-inspector + - airesource:rh-automation/resolution-advisor + - airesource:rh-automation/execution-summary diff --git a/rh-automation/skills/governance-assessor/catalog-info.yaml b/rh-automation/skills/governance-assessor/catalog-info.yaml new file mode 100644 index 00000000..250efd7f --- /dev/null +++ b/rh-automation/skills/governance-assessor/catalog-info.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: governance-assessor + namespace: rh-automation + title: Governance Assessor + description: > + Orchestrates AAP governance readiness assessments -- full platform audit or + scoped to specific domains. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/governance-assessor/SKILL.md + tags: + - ai-skill + - automation + - ansible + - governance + - compliance + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/governance-readiness-assessor + - airesource:rh-automation/execution-summary diff --git a/rh-automation/skills/governance-executor/catalog-info.yaml b/rh-automation/skills/governance-executor/catalog-info.yaml new file mode 100644 index 00000000..07634f0b --- /dev/null +++ b/rh-automation/skills/governance-executor/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: governance-executor + namespace: rh-automation + title: Governance Executor + description: > + Orchestrates governed job execution with risk analysis, check mode, approval, + and rollback. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/governance-executor/SKILL.md + tags: + - ai-skill + - automation + - ansible + - governance + - execution + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - execution + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/execution-risk-analyzer + - airesource:rh-automation/governed-job-launcher + - airesource:rh-automation/execution-summary diff --git a/rh-automation/skills/governance-readiness-assessor/catalog-info.yaml b/rh-automation/skills/governance-readiness-assessor/catalog-info.yaml new file mode 100644 index 00000000..7f970e46 --- /dev/null +++ b/rh-automation/skills/governance-readiness-assessor/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: governance-readiness-assessor + namespace: rh-automation + title: Governance Readiness Assessor + description: > + Assess AAP platform governance readiness -- full 7-domain audit or scoped to + specific domains. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/governance-readiness-assessor/SKILL.md + tags: + - ai-skill + - automation + - ansible + - governance + - readiness + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/governed-job-launcher/catalog-info.yaml b/rh-automation/skills/governed-job-launcher/catalog-info.yaml new file mode 100644 index 00000000..dff314ab --- /dev/null +++ b/rh-automation/skills/governed-job-launcher/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: governed-job-launcher + namespace: rh-automation + title: Governed Job Launcher + description: > + Execute governed job launches with check mode, approval gates, phased + rollout, and rollback. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/governed-job-launcher/SKILL.md + tags: + - ai-skill + - automation + - ansible + - execution + - governance + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - execution + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/host-fact-inspector/catalog-info.yaml b/rh-automation/skills/host-fact-inspector/catalog-info.yaml new file mode 100644 index 00000000..6bc484c4 --- /dev/null +++ b/rh-automation/skills/host-fact-inspector/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: host-fact-inspector + namespace: rh-automation + title: Host Fact Inspector + description: > + Correlate job failures with host system facts to determine platform drift and + resource issues. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/host-fact-inspector/SKILL.md + tags: + - ai-skill + - automation + - ansible + - inventory + - diagnostics + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/job-failure-analyzer/catalog-info.yaml b/rh-automation/skills/job-failure-analyzer/catalog-info.yaml new file mode 100644 index 00000000..019e228b --- /dev/null +++ b/rh-automation/skills/job-failure-analyzer/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: job-failure-analyzer + namespace: rh-automation + title: Job Failure Analyzer + description: > + Extract and analyze failure events from AAP jobs to classify errors and + reconstruct failure timelines. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/job-failure-analyzer/SKILL.md + tags: + - ai-skill + - automation + - ansible + - troubleshooting + - failure-analysis + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-automation/skills/resolution-advisor/catalog-info.yaml b/rh-automation/skills/resolution-advisor/catalog-info.yaml new file mode 100644 index 00000000..28eda04c --- /dev/null +++ b/rh-automation/skills/resolution-advisor/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: resolution-advisor + namespace: rh-automation + title: Resolution Advisor + description: > + Provide Red Hat documentation-backed resolution recommendations for + classified job errors. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-automation/skills/resolution-advisor/SKILL.md + tags: + - ai-skill + - automation + - ansible + - remediation + - troubleshooting + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-basic/catalog-info.yaml b/rh-basic/catalog-info.yaml new file mode 100644 index 00000000..610431f8 --- /dev/null +++ b/rh-basic/catalog-info.yaml @@ -0,0 +1,25 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-basic + title: Getting Started Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-basic agentic pack + for Red Hat product exploration and getting started workflows. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-basic + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-basic + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-basic-plugin.yaml + - ./skills/red-hat-cve-explainer/catalog-info.yaml + - ./skills/red-hat-diagnostics/catalog-info.yaml + - ./skills/red-hat-get-started/catalog-info.yaml + - ./skills/red-hat-product-lifecycle/catalog-info.yaml + - ./skills/red-hat-security-mcp-setup/catalog-info.yaml + - ./skills/red-hat-support-severity/catalog-info.yaml diff --git a/rh-basic/rh-basic-plugin.yaml b/rh-basic/rh-basic-plugin.yaml new file mode 100644 index 00000000..7bb6106c --- /dev/null +++ b/rh-basic/rh-basic-plugin.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-basic + namespace: rh-basic + title: Getting Started + description: > + Essential Red Hat skills for IT professionals. Covers CVE analysis, + diagnostics gathering, product lifecycle status, and support case + management. Works with or without MCP server configuration. + tags: + - ai-skill + - red-hat + - getting-started + - support + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-basic + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-basic + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - operations + categories: + - getting-started + - support + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-cve-explainer/catalog-info.yaml b/rh-basic/skills/red-hat-cve-explainer/catalog-info.yaml new file mode 100644 index 00000000..6530b681 --- /dev/null +++ b/rh-basic/skills/red-hat-cve-explainer/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-cve-explainer + namespace: rh-basic + title: Red Hat CVE Explainer + description: > + Explain a CVE using Red Hat's severity rating system. Looks up the CVE, + explains the rating, and suggests a course of action. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-cve-explainer/SKILL.md + tags: + - ai-skill + - red-hat + - security + - cve + - vulnerability + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - vulnerability-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-diagnostics/catalog-info.yaml b/rh-basic/skills/red-hat-diagnostics/catalog-info.yaml new file mode 100644 index 00000000..126cd371 --- /dev/null +++ b/rh-basic/skills/red-hat-diagnostics/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-diagnostics + namespace: rh-basic + title: Red Hat Diagnostics + description: > + Explain how to gather diagnostic information for Red Hat products (RHEL, + OpenShift, Ansible Automation Platform, Satellite) to share with Red Hat + Technical Support. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-diagnostics/SKILL.md + tags: + - ai-skill + - red-hat + - diagnostics + - support + - troubleshooting + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - support + categories: + - diagnostics + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-get-started/catalog-info.yaml b/rh-basic/skills/red-hat-get-started/catalog-info.yaml new file mode 100644 index 00000000..582a9c88 --- /dev/null +++ b/rh-basic/skills/red-hat-get-started/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-get-started + namespace: rh-basic + title: Red Hat Get Started + description: > + Bootstrap installer. Fetches and installs all Red Hat agent skills into + this project. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-get-started/SKILL.md + tags: + - ai-skill + - red-hat + - installer + - bootstrap + - onboarding + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - setup + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-product-lifecycle/catalog-info.yaml b/rh-basic/skills/red-hat-product-lifecycle/catalog-info.yaml new file mode 100644 index 00000000..9f9ac87f --- /dev/null +++ b/rh-basic/skills/red-hat-product-lifecycle/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-product-lifecycle + namespace: rh-basic + title: Red Hat Product Lifecycle + description: > + Explain a Red Hat product's lifecycle status, support phases, and + recommended action. Answers questions like "Is RHEL 8.6 still supported?" + or "When does OpenShift 4.14 reach end of maintenance?" + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-product-lifecycle/SKILL.md + tags: + - ai-skill + - red-hat + - lifecycle + - support + - product-management + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - support + categories: + - lifecycle-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-security-mcp-setup/catalog-info.yaml b/rh-basic/skills/red-hat-security-mcp-setup/catalog-info.yaml new file mode 100644 index 00000000..664f7c81 --- /dev/null +++ b/rh-basic/skills/red-hat-security-mcp-setup/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-security-mcp-setup + namespace: rh-basic + title: Red Hat Security MCP Setup + description: > + Add the Red Hat Security MCP server to this project. Configures the HTTP + transport endpoint and explains the Red Hat Customer Portal SSO browser + login flow. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-security-mcp-setup/SKILL.md + tags: + - ai-skill + - red-hat + - mcp + - security + - configuration + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - configuration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-basic/skills/red-hat-support-severity/catalog-info.yaml b/rh-basic/skills/red-hat-support-severity/catalog-info.yaml new file mode 100644 index 00000000..767700fd --- /dev/null +++ b/rh-basic/skills/red-hat-support-severity/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: red-hat-support-severity + namespace: rh-basic + title: Red Hat Support Severity + description: > + Help determine the correct severity level for a Red Hat support ticket, + explain SLAs, and guide what information to include. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-basic/skills/red-hat-support-severity/SKILL.md + tags: + - ai-skill + - red-hat + - support + - severity + - sla + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - support + categories: + - ticket-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-basic/rh-basic + - mcpserver:redhat/security-mcp-server diff --git a/rh-developer/catalog-info.yaml b/rh-developer/catalog-info.yaml new file mode 100644 index 00000000..af88ec02 --- /dev/null +++ b/rh-developer/catalog-info.yaml @@ -0,0 +1,36 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-developer + title: Developer Tools Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-developer agentic pack + for Red Hat application development and deployment workflows. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-developer + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-developer + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-developer-plugin.yaml + - ./skills/containerize-deploy/catalog-info.yaml + - ./skills/debug-build/catalog-info.yaml + - ./skills/debug-container/catalog-info.yaml + - ./skills/debug-network/catalog-info.yaml + - ./skills/debug-pipeline/catalog-info.yaml + - ./skills/debug-pod/catalog-info.yaml + - ./skills/debug-rbac/catalog-info.yaml + - ./skills/debug-rhel/catalog-info.yaml + - ./skills/debug-scc/catalog-info.yaml + - ./skills/deploy/catalog-info.yaml + - ./skills/detect-project/catalog-info.yaml + - ./skills/helm-deploy/catalog-info.yaml + - ./skills/incident-triage/catalog-info.yaml + - ./skills/recommend-image/catalog-info.yaml + - ./skills/rhel-deploy/catalog-info.yaml + - ./skills/s2i-build/catalog-info.yaml + - ./skills/validate-environment/catalog-info.yaml diff --git a/rh-developer/rh-developer-plugin.yaml b/rh-developer/rh-developer-plugin.yaml new file mode 100644 index 00000000..d06cb27f --- /dev/null +++ b/rh-developer/rh-developer-plugin.yaml @@ -0,0 +1,46 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-developer + namespace: rh-developer + title: Developer Tools + description: > + Build and deploy applications on Red Hat platforms. Covers project + detection, S2I builds, Helm deployments, containerization workflows, + and troubleshooting for OpenShift and RHEL targets. + tags: + - ai-skill + - developer + - openshift + - deployment + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-developer + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-developer + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - development + categories: + - build + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/containerize-deploy/catalog-info.yaml b/rh-developer/skills/containerize-deploy/catalog-info.yaml new file mode 100644 index 00000000..e664d0d5 --- /dev/null +++ b/rh-developer/skills/containerize-deploy/catalog-info.yaml @@ -0,0 +1,55 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: containerize-deploy + namespace: rh-developer + title: Containerize Deploy + description: > + Complete end-to-end workflow for containerizing and deploying applications + to OpenShift or standalone RHEL systems. Orchestrates detect-project, + s2i-build, deploy, helm-deploy, and rhel-deploy skills with user + confirmation checkpoints at each phase. Supports S2I, Podman, and Helm + deployment strategies for OpenShift, and Podman or native deployments + for RHEL hosts. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/containerize-deploy/SKILL.md + tags: + - ai-skill + - developer + - containerization + - deployment + - orchestration + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - airesource:rh-developer/detect-project + - airesource:rh-developer/recommend-image + - airesource:rh-developer/s2i-build + - airesource:rh-developer/deploy + - airesource:rh-developer/helm-deploy + - airesource:rh-developer/rhel-deploy + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-build diff --git a/rh-developer/skills/debug-build/catalog-info.yaml b/rh-developer/skills/debug-build/catalog-info.yaml new file mode 100644 index 00000000..785c31fd --- /dev/null +++ b/rh-developer/skills/debug-build/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-build + namespace: rh-developer + title: Debug Build + description: > + Diagnose OpenShift build failures including S2I builds, Docker/Podman + builds, and BuildConfig issues. Automates multi-step diagnosis including + BuildConfig validation, build pod logs, registry authentication, and + source repository access. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-build/SKILL.md + tags: + - ai-skill + - developer + - debugging + - openshift + - builds + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-container/catalog-info.yaml b/rh-developer/skills/debug-container/catalog-info.yaml new file mode 100644 index 00000000..5b646cd8 --- /dev/null +++ b/rh-developer/skills/debug-container/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-container + namespace: rh-developer + title: Debug Container + description: > + Diagnose local container issues with Podman/Docker including image pull + errors, container startup failures, OOM kills, and networking problems. + Automates multi-step diagnosis including container inspect, logs retrieval, + image analysis, and resource constraint checking. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-container/SKILL.md + tags: + - ai-skill + - developer + - debugging + - containers + - podman + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-network/catalog-info.yaml b/rh-developer/skills/debug-network/catalog-info.yaml new file mode 100644 index 00000000..ab5e0084 --- /dev/null +++ b/rh-developer/skills/debug-network/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-network + namespace: rh-developer + title: Debug Network + description: > + Diagnose OpenShift service connectivity issues including DNS resolution, + service endpoints, route ingress, and network policies. Automates + multi-step diagnosis including service endpoint verification, pod selector + matching, route status, and network policy analysis. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-network/SKILL.md + tags: + - ai-skill + - developer + - debugging + - networking + - openshift + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-pipeline/catalog-info.yaml b/rh-developer/skills/debug-pipeline/catalog-info.yaml new file mode 100644 index 00000000..c3d8a8a6 --- /dev/null +++ b/rh-developer/skills/debug-pipeline/catalog-info.yaml @@ -0,0 +1,45 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-pipeline + namespace: rh-developer + title: Debug Pipeline + description: > + Diagnose OpenShift Pipelines (Tekton) CI/CD failures including PipelineRun + failures, TaskRun step errors, workspace/PVC binding issues, and + authentication problems. Automates multi-step diagnosis including + PipelineRun status, failed TaskRun analysis, step container logs, and + related resource checks. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-pipeline/SKILL.md + tags: + - ai-skill + - developer + - debugging + - tekton + - ci-cd + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-pod/catalog-info.yaml b/rh-developer/skills/debug-pod/catalog-info.yaml new file mode 100644 index 00000000..bcacc2a4 --- /dev/null +++ b/rh-developer/skills/debug-pod/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-pod + namespace: rh-developer + title: Debug Pod + description: > + Diagnose pod failures on OpenShift including CrashLoopBackOff, + ImagePullBackOff, OOMKilled, and pending pods. Automates multi-step + diagnosis including pod status, events, logs (current and previous), + and resource constraint analysis. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-pod/SKILL.md + tags: + - ai-skill + - developer + - debugging + - pods + - openshift + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-rbac/catalog-info.yaml b/rh-developer/skills/debug-rbac/catalog-info.yaml new file mode 100644 index 00000000..822d641c --- /dev/null +++ b/rh-developer/skills/debug-rbac/catalog-info.yaml @@ -0,0 +1,45 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-rbac + namespace: rh-developer + title: Debug RBAC + description: > + Diagnose OpenShift RBAC permission failures that cause workloads to fail + with 403 Forbidden errors when accessing the Kubernetes API. Automates + multi-step diagnosis including pod logs analysis, ServiceAccount + identification, RoleBinding and ClusterRoleBinding analysis, and + remediation history for regression detection. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-rbac/SKILL.md + tags: + - ai-skill + - developer + - debugging + - rbac + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-rhel/catalog-info.yaml b/rh-developer/skills/debug-rhel/catalog-info.yaml new file mode 100644 index 00000000..a74375ed --- /dev/null +++ b/rh-developer/skills/debug-rhel/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-rhel + namespace: rh-developer + title: Debug RHEL + description: > + Diagnose RHEL system issues including systemd service failures, SELinux + denials, firewall blocking, and system resource problems. Automates + multi-step diagnosis including journalctl log analysis, SELinux denial + detection, firewall rule inspection, and systemd unit status. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-rhel/SKILL.md + tags: + - ai-skill + - developer + - debugging + - rhel + - systemd + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/debug-scc/catalog-info.yaml b/rh-developer/skills/debug-scc/catalog-info.yaml new file mode 100644 index 00000000..7ded975b --- /dev/null +++ b/rh-developer/skills/debug-scc/catalog-info.yaml @@ -0,0 +1,45 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: debug-scc + namespace: rh-developer + title: Debug SCC + description: > + Diagnose OpenShift Security Context Constraint (SCC) violations that + prevent pods from being created. Automates multi-step diagnosis including + Deployment status, ReplicaSet FailedCreate events, security context field + extraction, SCC rejection parsing, and ServiceAccount SCC binding + analysis. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/debug-scc/SKILL.md + tags: + - ai-skill + - developer + - debugging + - scc + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/deploy/catalog-info.yaml b/rh-developer/skills/deploy/catalog-info.yaml new file mode 100644 index 00000000..a61f4b6c --- /dev/null +++ b/rh-developer/skills/deploy/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: deploy + namespace: rh-developer + title: Deploy + description: > + Create Kubernetes Deployment, Service, and Route resources on OpenShift + to deploy and expose an application. Handles port detection, replica + configuration, HTTPS route creation, rollout monitoring, and rollback + on failure. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/deploy/SKILL.md + tags: + - ai-skill + - developer + - deployment + - openshift + - kubernetes + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/detect-project/catalog-info.yaml b/rh-developer/skills/detect-project/catalog-info.yaml new file mode 100644 index 00000000..eec2ec4e --- /dev/null +++ b/rh-developer/skills/detect-project/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: detect-project + namespace: rh-developer + title: Detect Project + description: > + Analyze a project folder or GitHub repository to detect programming + language, framework, and version requirements. Supports Node.js, Python, + Java, Go, Ruby, .NET, PHP, and Perl. Use before s2i-build or rhel-deploy + for build strategy recommendations. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/detect-project/SKILL.md + tags: + - ai-skill + - developer + - analysis + - project-detection + - language-detection + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - development + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/helm-deploy/catalog-info.yaml b/rh-developer/skills/helm-deploy/catalog-info.yaml new file mode 100644 index 00000000..dd3001e9 --- /dev/null +++ b/rh-developer/skills/helm-deploy/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: helm-deploy + namespace: rh-developer + title: Helm Deploy + description: > + Deploy applications to OpenShift using Helm charts. Supports both existing + charts and chart creation. Handles chart detection, values customization, + install and upgrade operations, and rollback. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/helm-deploy/SKILL.md + tags: + - ai-skill + - developer + - helm + - deployment + - openshift + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/incident-triage/catalog-info.yaml b/rh-developer/skills/incident-triage/catalog-info.yaml new file mode 100644 index 00000000..d30c94dc --- /dev/null +++ b/rh-developer/skills/incident-triage/catalog-info.yaml @@ -0,0 +1,50 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: incident-triage + namespace: rh-developer + title: Incident Triage + description: > + Structured incident investigation for OpenShift using the Five Whys + methodology, investigation guardrails, Prometheus metric analysis, and + adversarial due diligence. Orchestrates multi-resource diagnosis across + Deployments, ReplicaSets, Pods, Services, and cluster resources to trace + from observed symptoms to root cause. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/incident-triage/SKILL.md + tags: + - ai-skill + - developer + - incident-response + - triage + - openshift + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - airesource:rh-developer/debug-scc + - airesource:rh-developer/debug-rbac + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-build diff --git a/rh-developer/skills/recommend-image/catalog-info.yaml b/rh-developer/skills/recommend-image/catalog-info.yaml new file mode 100644 index 00000000..99c44b3c --- /dev/null +++ b/rh-developer/skills/recommend-image/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: recommend-image + namespace: rh-developer + title: Recommend Image + description: > + Intelligently recommend the optimal S2I builder image or container base + image for a project based on detected language, framework, use-case + requirements, security posture, and deployment target. Supports Node.js, + Python, Java, Go, Ruby, .NET, PHP, and Perl on Red Hat UBI. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/recommend-image/SKILL.md + tags: + - ai-skill + - developer + - containers + - image-selection + - ubi + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - development + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/rhel-deploy/catalog-info.yaml b/rh-developer/skills/rhel-deploy/catalog-info.yaml new file mode 100644 index 00000000..e06b132c --- /dev/null +++ b/rh-developer/skills/rhel-deploy/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rhel-deploy + namespace: rh-developer + title: RHEL Deploy + description: > + Deploy applications to standalone RHEL, Fedora, or CentOS systems using + Podman containers with systemd or native dnf builds. Handles SSH + connectivity, SELinux, firewall-cmd, and systemd unit creation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/rhel-deploy/SKILL.md + tags: + - ai-skill + - developer + - deployment + - rhel + - systemd + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/s2i-build/catalog-info.yaml b/rh-developer/skills/s2i-build/catalog-info.yaml new file mode 100644 index 00000000..7d99fd8b --- /dev/null +++ b/rh-developer/skills/s2i-build/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: s2i-build + namespace: rh-developer + title: S2I Build + description: > + Create BuildConfig and ImageStream resources on OpenShift and trigger a + Source-to-Image (S2I) build. Handles namespace verification, resource + creation with user confirmation, build monitoring with log streaming, + and failure recovery. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/s2i-build/SKILL.md + tags: + - ai-skill + - developer + - s2i + - builds + - openshift + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-developer/skills/validate-environment/catalog-info.yaml b/rh-developer/skills/validate-environment/catalog-info.yaml new file mode 100644 index 00000000..1f399451 --- /dev/null +++ b/rh-developer/skills/validate-environment/catalog-info.yaml @@ -0,0 +1,43 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: validate-environment + namespace: rh-developer + title: Validate Environment + description: > + Check and report the status of required tools and environment for + rh-developer skills. Validates tool installation (oc, helm, podman, git, + skopeo), cluster connectivity, and permissions. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-developer/skills/validate-environment/SKILL.md + tags: + - ai-skill + - developer + - validation + - environment + - prerequisites + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server diff --git a/rh-sre/catalog-info.yaml b/rh-sre/catalog-info.yaml new file mode 100644 index 00000000..2242d635 --- /dev/null +++ b/rh-sre/catalog-info.yaml @@ -0,0 +1,32 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-sre + title: Site Reliability Engineering Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-sre agentic pack + for Red Hat Site Reliability Engineering workflows. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-sre + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-sre + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-sre-plugin.yaml + - ./skills/cve-impact/catalog-info.yaml + - ./skills/cve-validation/catalog-info.yaml + - ./skills/execution-summary/catalog-info.yaml + - ./skills/fleet-inventory/catalog-info.yaml + - ./skills/job-template-creator/catalog-info.yaml + - ./skills/job-template-remediation-validator/catalog-info.yaml + - ./skills/mcp-aap-validator/catalog-info.yaml + - ./skills/mcp-lightspeed-validator/catalog-info.yaml + - ./skills/playbook-executor/catalog-info.yaml + - ./skills/playbook-generator/catalog-info.yaml + - ./skills/remediation/catalog-info.yaml + - ./skills/remediation-verifier/catalog-info.yaml + - ./skills/system-context/catalog-info.yaml diff --git a/rh-sre/rh-sre-plugin.yaml b/rh-sre/rh-sre-plugin.yaml new file mode 100644 index 00000000..360c30c3 --- /dev/null +++ b/rh-sre/rh-sre-plugin.yaml @@ -0,0 +1,45 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-sre + namespace: rh-sre + title: Site Reliability Engineering + description: > + Agentic tools and automation for managing Red Hat platforms and + infrastructure. Covers vulnerability management, fleet inventory, + system monitoring, and operational excellence for SRE workflows. + tags: + - ai-skill + - sre + - monitoring + - vulnerability-management + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-sre + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-sre + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - sre + - security + categories: + - monitoring + - vulnerability-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/cve-impact/catalog-info.yaml b/rh-sre/skills/cve-impact/catalog-info.yaml new file mode 100644 index 00000000..70f289c0 --- /dev/null +++ b/rh-sre/skills/cve-impact/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cve-impact + namespace: rh-sre + title: CVE Impact + description: > + Use for all CVE discovery and listing. Handles queries like "show critical CVEs", + "CVEs on hostname X", "remediatable vulnerabilities", "impact of CVE-X", and risk + assessment. System-level pagination and response parsing included. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/cve-impact/SKILL.md + tags: + - ai-skill + - sre + - cve + - vulnerability + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - monitoring + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/cve-validation/catalog-info.yaml b/rh-sre/skills/cve-validation/catalog-info.yaml new file mode 100644 index 00000000..d438dd9d --- /dev/null +++ b/rh-sre/skills/cve-validation/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: cve-validation + namespace: rh-sre + title: CVE Validation + description: > + Validate CVE identifiers and check remediation availability in Red Hat Lightspeed. + Use for verifying CVE validity, checking automated remediation availability, and + validating CVE lists before batch remediation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/cve-validation/SKILL.md + tags: + - ai-skill + - sre + - cve + - validation + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/execution-summary/catalog-info.yaml b/rh-sre/skills/execution-summary/catalog-info.yaml new file mode 100644 index 00000000..f92a1e14 --- /dev/null +++ b/rh-sre/skills/execution-summary/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: execution-summary + namespace: rh-sre + title: Execution Summary + description: > + Generates a concise report of agents, skills, tools, and documentation accessed + during a workflow for audit and learning purposes. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/execution-summary/SKILL.md + tags: + - ai-skill + - sre + - reporting + - audit + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - reporting + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/fleet-inventory/catalog-info.yaml b/rh-sre/skills/fleet-inventory/catalog-info.yaml new file mode 100644 index 00000000..9b9966fd --- /dev/null +++ b/rh-sre/skills/fleet-inventory/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: fleet-inventory + namespace: rh-sre + title: Fleet Inventory + description: > + Query and display Red Hat Lightspeed managed system inventory. Focuses on discovery + and listing of systems, including affected systems by CVE, RHEL version distribution, + and production system identification. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/fleet-inventory/SKILL.md + tags: + - ai-skill + - sre + - inventory + - fleet-management + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - monitoring + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/job-template-creator/catalog-info.yaml b/rh-sre/skills/job-template-creator/catalog-info.yaml new file mode 100644 index 00000000..e22f3190 --- /dev/null +++ b/rh-sre/skills/job-template-creator/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: job-template-creator + namespace: rh-sre + title: Job Template Creator + description: > + Create AAP (Ansible Automation Platform) job templates for executing playbooks. + Guides through adding playbooks to Git projects and creating job templates via + AAP Web UI for CVE remediation and other automation tasks. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/job-template-creator/SKILL.md + tags: + - ai-skill + - sre + - ansible + - automation + - aap + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - automation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/job-template-remediation-validator/catalog-info.yaml b/rh-sre/skills/job-template-remediation-validator/catalog-info.yaml new file mode 100644 index 00000000..622c1140 --- /dev/null +++ b/rh-sre/skills/job-template-remediation-validator/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: job-template-remediation-validator + namespace: rh-sre + title: Job Template Remediation Validator + description: > + Verify an AAP job template meets requirements for executing CVE remediation playbooks. + Validates template readiness before playbook-executor selects a template for execution. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/job-template-remediation-validator/SKILL.md + tags: + - ai-skill + - sre + - validation + - ansible + - aap + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/mcp-aap-validator/catalog-info.yaml b/rh-sre/skills/mcp-aap-validator/catalog-info.yaml new file mode 100644 index 00000000..5485ea3f --- /dev/null +++ b/rh-sre/skills/mcp-aap-validator/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: mcp-aap-validator + namespace: rh-sre + title: MCP AAP Validator + description: > + Validate AAP (Ansible Automation Platform) MCP server connectivity. Runs lightweight + tool calls to verify AAP MCP availability before job management or inventory operations. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/mcp-aap-validator/SKILL.md + tags: + - ai-skill + - sre + - mcp + - validation + - aap + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/mcp-lightspeed-validator/catalog-info.yaml b/rh-sre/skills/mcp-lightspeed-validator/catalog-info.yaml new file mode 100644 index 00000000..1344c1b8 --- /dev/null +++ b/rh-sre/skills/mcp-lightspeed-validator/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: mcp-lightspeed-validator + namespace: rh-sre + title: MCP Lightspeed Validator + description: > + Validate Red Hat Lightspeed MCP server connectivity. Verifies lightspeed-mcp + availability by calling get_mcp_version before CVE operations. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/mcp-lightspeed-validator/SKILL.md + tags: + - ai-skill + - sre + - mcp + - validation + - lightspeed + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - devops + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/playbook-executor/catalog-info.yaml b/rh-sre/skills/playbook-executor/catalog-info.yaml new file mode 100644 index 00000000..31227b62 --- /dev/null +++ b/rh-sre/skills/playbook-executor/catalog-info.yaml @@ -0,0 +1,44 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: playbook-executor + namespace: rh-sre + title: Playbook Executor + description: > + Execute remediation playbooks via AAP with job management, dry-run support, and + reporting. Handles Git flow (commit, push, sync) when template playbook paths differ + from generated playbooks. Use after playbook-generator. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/playbook-executor/SKILL.md + tags: + - ai-skill + - sre + - ansible + - automation + - execution + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - automation + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform + - airesource:rh-sre/mcp-aap-validator + - airesource:rh-sre/job-template-remediation-validator + - airesource:rh-sre/job-template-creator diff --git a/rh-sre/skills/playbook-generator/catalog-info.yaml b/rh-sre/skills/playbook-generator/catalog-info.yaml new file mode 100644 index 00000000..8d54b133 --- /dev/null +++ b/rh-sre/skills/playbook-generator/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: playbook-generator + namespace: rh-sre + title: Playbook Generator + description: > + Generate production-ready Ansible remediation playbooks for CVE vulnerabilities with + Red Hat best practices, error handling, and Kubernetes safety patterns. This skill only + generates playbooks; for execution, use the playbook-executor skill. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/playbook-generator/SKILL.md + tags: + - ai-skill + - sre + - ansible + - playbook + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/remediation-verifier/catalog-info.yaml b/rh-sre/skills/remediation-verifier/catalog-info.yaml new file mode 100644 index 00000000..25e40ad5 --- /dev/null +++ b/rh-sre/skills/remediation-verifier/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: remediation-verifier + namespace: rh-sre + title: Remediation Verifier + description: > + Verify CVE remediation success by checking Red Hat Lightspeed CVE status, validating + package versions, and confirming service health. Orchestrates MCP tools for + comprehensive remediation verification after playbook execution. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/remediation-verifier/SKILL.md + tags: + - ai-skill + - sre + - verification + - cve + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-sre/skills/remediation/catalog-info.yaml b/rh-sre/skills/remediation/catalog-info.yaml new file mode 100644 index 00000000..7be2de6b --- /dev/null +++ b/rh-sre/skills/remediation/catalog-info.yaml @@ -0,0 +1,50 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: remediation + namespace: rh-sre + title: Remediation + description: > + End-to-end CVE remediation orchestration skill. Handles multi-step remediation + workflows including validation, system context gathering, playbook generation, + execution, and verification. Use for all CVE remediation workflows, batch + remediation across multiple systems, and emergency security response. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/remediation/SKILL.md + tags: + - ai-skill + - sre + - remediation + - cve + - security + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - security + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform + - airesource:rh-sre/mcp-lightspeed-validator + - airesource:rh-sre/mcp-aap-validator + - airesource:rh-sre/cve-impact + - airesource:rh-sre/cve-validation + - airesource:rh-sre/system-context + - airesource:rh-sre/playbook-generator + - airesource:rh-sre/playbook-executor + - airesource:rh-sre/remediation-verifier diff --git a/rh-sre/skills/system-context/catalog-info.yaml b/rh-sre/skills/system-context/catalog-info.yaml new file mode 100644 index 00000000..26a02687 --- /dev/null +++ b/rh-sre/skills/system-context/catalog-info.yaml @@ -0,0 +1,41 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: system-context + namespace: rh-sre + title: System Context + description: > + Gather system inventory and deployment context for CVE-affected systems, including + RHEL version detection, environment classification, and deployment architecture + analysis. Orchestrates MCP tools for comprehensive system analysis. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-sre/skills/system-context/SKILL.md + tags: + - ai-skill + - sre + - inventory + - systems + - rhel + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - sre + categories: + - monitoring + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform diff --git a/rh-virt/catalog-info.yaml b/rh-virt/catalog-info.yaml new file mode 100644 index 00000000..f4a1ea2d --- /dev/null +++ b/rh-virt/catalog-info.yaml @@ -0,0 +1,29 @@ +apiVersion: backstage.io/v1alpha1 +kind: Location +metadata: + name: rh-virt + title: Virtualization Management Agentic Pack + description: > + Points to all AI skill catalog entities in the rh-virt agentic pack + for Red Hat OpenShift Virtualization management. + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-virt + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-virt + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" +spec: + targets: + - ./rh-virt-plugin.yaml + - ./skills/vm-clone/catalog-info.yaml + - ./skills/vm-create/catalog-info.yaml + - ./skills/vm-delete/catalog-info.yaml + - ./skills/vm-inventory/catalog-info.yaml + - ./skills/vm-lifecycle-manager/catalog-info.yaml + - ./skills/vm-rebalance/catalog-info.yaml + - ./skills/vm-snapshot-create/catalog-info.yaml + - ./skills/vm-snapshot-delete/catalog-info.yaml + - ./skills/vm-snapshot-list/catalog-info.yaml + - ./skills/vm-snapshot-restore/catalog-info.yaml diff --git a/rh-virt/rh-virt-plugin.yaml b/rh-virt/rh-virt-plugin.yaml new file mode 100644 index 00000000..75252a7e --- /dev/null +++ b/rh-virt/rh-virt-plugin.yaml @@ -0,0 +1,42 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: rh-virt + namespace: rh-virt + title: Red Hat Virtualization + description: > + Automation capabilities for VM lifecycle management, provisioning, + and inventory operations on OpenShift clusters using KubeVirt. + tags: + - ai-skill + - virtualization + - kubevirt + - openshift + annotations: + agentic.redhat.com/lola-module: "true" + agentic.redhat.com/lola-module-name: rh-virt + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + agentic.redhat.com/path: rh-virt + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ecosystem-appeng + system: default/agentic-plugins + disciplines: + - platform-engineering + categories: + - virtualization + - vm-lifecycle + agents: + - claude-code + - opencode + - cursor + dependsOn: + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-clone/catalog-info.yaml b/rh-virt/skills/vm-clone/catalog-info.yaml new file mode 100644 index 00000000..791b0ba9 --- /dev/null +++ b/rh-virt/skills/vm-clone/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-clone + namespace: rh-virt + title: VM Clone + description: > + Clone existing virtual machines for testing, scaling, or creating templates. + Clones VM configuration and optionally creates new storage or references existing storage. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-clone/SKILL.md + tags: + - ai-skill + - virtualization + - cloning + - templates + - provisioning + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - provisioning + categories: + - vm-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-create/catalog-info.yaml b/rh-virt/skills/vm-create/catalog-info.yaml new file mode 100644 index 00000000..8cb57fe8 --- /dev/null +++ b/rh-virt/skills/vm-create/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-create + namespace: rh-virt + title: VM Create + description: > + Create new virtual machines in OpenShift Virtualization with automatic instance type + resolution and OS selection. Handles VM creation with intelligent defaults. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-create/SKILL.md + tags: + - ai-skill + - virtualization + - provisioning + - openshift + - vm-management + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - provisioning + categories: + - vm-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-delete/catalog-info.yaml b/rh-virt/skills/vm-delete/catalog-info.yaml new file mode 100644 index 00000000..3471ba91 --- /dev/null +++ b/rh-virt/skills/vm-delete/catalog-info.yaml @@ -0,0 +1,40 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-delete + namespace: rh-virt + title: VM Delete + description: > + Permanently delete virtual machines and their associated resources from OpenShift + Virtualization. Handles permanent VM deletion with strict safety confirmations + and typed verification. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-delete/SKILL.md + tags: + - ai-skill + - virtualization + - cleanup + - decommission + - vm-management + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - operations + categories: + - vm-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-inventory/catalog-info.yaml b/rh-virt/skills/vm-inventory/catalog-info.yaml new file mode 100644 index 00000000..b01f6016 --- /dev/null +++ b/rh-virt/skills/vm-inventory/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-inventory + namespace: rh-virt + title: VM Inventory + description: > + List and view virtual machines across namespaces with status, resource usage, + and health information. Provides comprehensive VM inventory and status reporting. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-inventory/SKILL.md + tags: + - ai-skill + - virtualization + - monitoring + - reporting + - inventory + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - monitoring + categories: + - vm-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-lifecycle-manager/catalog-info.yaml b/rh-virt/skills/vm-lifecycle-manager/catalog-info.yaml new file mode 100644 index 00000000..d4e28787 --- /dev/null +++ b/rh-virt/skills/vm-lifecycle-manager/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-lifecycle-manager + namespace: rh-virt + title: VM Lifecycle Manager + description: > + Manage virtual machine lifecycle operations including start, stop, and restart. + Handles VM state transitions safely with user confirmation for each action. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-lifecycle-manager/SKILL.md + tags: + - ai-skill + - virtualization + - power-management + - operations + - lifecycle + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - operations + categories: + - vm-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-rebalance/catalog-info.yaml b/rh-virt/skills/vm-rebalance/catalog-info.yaml new file mode 100644 index 00000000..87cf8e1b --- /dev/null +++ b/rh-virt/skills/vm-rebalance/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-rebalance + namespace: rh-virt + title: VM Rebalance + description: > + Orchestrate VM migrations across cluster nodes for load balancing, maintenance, + and resource optimization. Supports manual (user-driven) and automatic (AI-driven) modes. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-rebalance/SKILL.md + tags: + - ai-skill + - virtualization + - load-balancing + - migration + - optimization + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - optimization + categories: + - cluster-optimization + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-snapshot-create/catalog-info.yaml b/rh-virt/skills/vm-snapshot-create/catalog-info.yaml new file mode 100644 index 00000000..f5b943c8 --- /dev/null +++ b/rh-virt/skills/vm-snapshot-create/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-snapshot-create + namespace: rh-virt + title: VM Snapshot Create + description: > + Create virtual machine snapshots for backup and recovery. Validates storage class + snapshot support, CSI driver capabilities, and guest agent status before snapshot creation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-snapshot-create/SKILL.md + tags: + - ai-skill + - virtualization + - backup + - snapshots + - data-protection + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - backup + categories: + - snapshot-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-snapshot-delete/catalog-info.yaml b/rh-virt/skills/vm-snapshot-delete/catalog-info.yaml new file mode 100644 index 00000000..a28c6fff --- /dev/null +++ b/rh-virt/skills/vm-snapshot-delete/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-snapshot-delete + namespace: rh-virt + title: VM Snapshot Delete + description: > + Permanently delete virtual machine snapshots to free storage space. + Requires user confirmation before deletion. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-snapshot-delete/SKILL.md + tags: + - ai-skill + - virtualization + - cleanup + - snapshots + - storage + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - operations + categories: + - snapshot-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-snapshot-list/catalog-info.yaml b/rh-virt/skills/vm-snapshot-list/catalog-info.yaml new file mode 100644 index 00000000..bf02be86 --- /dev/null +++ b/rh-virt/skills/vm-snapshot-list/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-snapshot-list + namespace: rh-virt + title: VM Snapshot List + description: > + List virtual machine snapshots across namespaces with status, age, and recovery + information. Read-only operation requiring no user confirmation. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-snapshot-list/SKILL.md + tags: + - ai-skill + - virtualization + - monitoring + - snapshots + - reporting + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - monitoring + categories: + - snapshot-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/rh-virt/skills/vm-snapshot-restore/catalog-info.yaml b/rh-virt/skills/vm-snapshot-restore/catalog-info.yaml new file mode 100644 index 00000000..d60b09ae --- /dev/null +++ b/rh-virt/skills/vm-snapshot-restore/catalog-info.yaml @@ -0,0 +1,39 @@ +apiVersion: backstage.io/v1alpha1 +kind: AiResource +metadata: + name: vm-snapshot-restore + namespace: rh-virt + title: VM Snapshot Restore + description: > + Restore virtual machines from snapshots with strict safety confirmations to prevent + data loss. Requires VM to be stopped and typed snapshot name confirmation before restore. + labels: + distribution: external + annotations: + backstage.io/source-location: >- + url:https://github.com/RHEcosystemAppEng/agentic-plugins/blob/main/rh-virt/skills/vm-snapshot-restore/SKILL.md + tags: + - ai-skill + - virtualization + - recovery + - snapshots + - data-protection + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: skill + lifecycle: beta + owner: group:redhat/ecosystem-appeng + disciplines: + - recovery + categories: + - snapshot-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-virt/rh-virt + - mcpserver:agentic-plugins/openshift-mcp-server diff --git a/system.yaml b/system.yaml new file mode 100644 index 00000000..57ec074f --- /dev/null +++ b/system.yaml @@ -0,0 +1,24 @@ +apiVersion: backstage.io/v1alpha1 +kind: System +metadata: + name: agentic-plugins + title: Agentic Plugins + description: > + Agentic skill packs and MCP server configurations for Red Hat platforms. + Provides AI-powered automation across OpenShift, Ansible, Virtualization, + AI/ML, and SRE workflows through persona-specific skill modules. + tags: + - ai-skill + - agentic + - red-hat + annotations: + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + labels: + agentic-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + owner: group:redhat/ecosystem-appeng