diff --git a/CLAUDE.md b/CLAUDE.md index 3f3dbf10..833dfc41 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 @@ -19,7 +21,7 @@ agentic-plugins/ ├── rh-basic/ # Getting started pack ├── 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 +39,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 +49,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 +58,111 @@ 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 + +All relationships use `dependsOn` / `dependencyOf`: + +> **Why not `partOf`/`hasPart`?** Compass only processes `partOf`/`hasPart` for standard Backstage kinds (Component, API, Resource). Custom kinds like `AiResource` and `MCPServer` can store these fields in `spec`, but they are not processed into the relation graph. Only `dependsOn`/`dependencyOf` and `ownedBy`/`ownerOf` generate actual relations for custom kinds. + +Concrete relationships in this repo: + +- **Skill → Plugin**: `dependsOn` / `dependencyOf` (a skill belongs to its plugin) +- **Plugin → System**: `dependsOn` / `dependencyOf` (a plugin belongs to the system) +- **MCPServer → System**: `dependsOn` / `dependencyOf` (an MCP server belongs to the system) +- **Skill → MCPServer**: `dependsOn` / `dependencyOf` (a skill uses an MCP server) +- **Plugin → MCPServer**: `dependsOn` / `dependencyOf` (a plugin uses an MCP server) +- **Skill → Skill**: `dependsOn` / `dependencyOf` (orchestration skills invoke other skills) +- **All entities → Group**: `spec.owner: group:redhat/ai5-marketplace` + +> **Bidirectional declaration policy:** Compass does not auto-generate inverse relations for custom entity kinds such as `AiResource` and `MCPServer` (tracked as COMPASS-1288). Until this is resolved upstream, we explicitly declare **both directions** of every relationship in our manifests. For example, if a skill declares `dependsOn: [airesource:rh-sre/rh-sre]`, the plugin must also declare `dependencyOf: [airesource:rh-sre/]`. When adding or modifying a relationship, always update both the source and target manifests. + +#### Namespaces + +Each pack uses its own namespace matching the pack name (e.g., `rh-sre`, `ocp-admin`). All MCP servers share the namespace `agentic-plugins`. The root System `agentic-plugins` uses the `default` namespace. + +#### Entity Reference Formats + +- Skills: `airesource:/` +- Pack plugins: `airesource:/` +- MCP servers: `mcpserver:agentic-plugins/` + +#### 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/ai5-marketplace + disciplines: + - + categories: + - + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:/ + # Add mcpserver and airesource (skill) dependencies as needed + - mcpserver:agentic-plugins/ +``` + +Then update **both sides** of every relationship: +1. Add the file as a target in the pack's `catalog-info.yaml` Location +2. Add the skill to the plugin's `dependencyOf` list in `-plugin.yaml` +3. Add the skill to each referenced MCP server's `dependencyOf` list in `mcps/.yaml` +4. If the skill depends on other skills, add `dependencyOf` entries in those skills' manifests + ## 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 +275,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 +287,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 +307,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..877a5693 --- /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. + annotations: + 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..de4a51f8 --- /dev/null +++ b/mcps/ai-observability.yaml @@ -0,0 +1,181 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: list_models + description: List all available AI models for analysis. + - type: tool + name: list_vllm_namespaces + description: Get list of monitored vLLM Kubernetes namespaces with observability data. + - type: tool + name: get_model_config + description: Get available LLM models configured for summarization and analysis. + - type: tool + name: get_vllm_metrics_tool + description: Get available vLLM metrics with friendly names and PromQL queries. + - type: tool + name: fetch_vllm_metrics_data + description: Fetch vLLM metrics data with time-series for dashboard display. + - type: tool + name: analyze_vllm + description: Analyze vLLM metrics and generate an AI summary using an LLM. + - type: tool + name: calculate_metrics + description: Calculate statistics (avg, min, max, latest) for provided metrics data. + - type: tool + name: list_summarization_models + description: List all configured summarization models with metadata from runtime configuration. + - type: tool + name: get_gpu_info + description: Get cluster GPU information from Prometheus DCGM metrics. + - type: tool + name: get_deployment_info + description: Get model deployment details for a model in a namespace. + - type: tool + name: chat_vllm + description: Chat about vLLM metrics by asking follow-up questions on analyzed data. + - type: tool + name: analyze_openshift + description: Analyze OpenShift metrics for a category and scope with LLM-generated summary. + - type: tool + name: fetch_openshift_metrics_data + description: Fetch OpenShift metrics data for dashboard visualization without LLM analysis. + - type: tool + name: list_openshift_namespaces + description: Get list of all OpenShift namespaces observed in Prometheus. + - type: tool + name: list_openshift_metric_groups + description: Return available OpenShift metric group categories for cluster-wide analysis. + - type: tool + name: list_openshift_namespace_metric_groups + description: Return OpenShift metric groups that support namespace-scoped analysis. + - type: tool + name: chat_openshift + description: Chat about OpenShift metrics for a specific category and scope. + - type: tool + name: search_metrics + description: Search for Prometheus metrics by pattern using semantic understanding. + - type: tool + name: get_metric_metadata + description: Get detailed metadata for a specific Prometheus metric. + - type: tool + name: get_label_values + description: Get all possible values for a specific label of a Prometheus metric. + - type: tool + name: execute_promql + description: Execute a PromQL query and return structured results. + - type: tool + name: explain_results + description: Explain PromQL query results in natural language. + - type: tool + name: suggest_queries + description: Suggest related PromQL queries based on user intent. + - type: tool + name: select_best_metric + description: Select the best metric for a user question using semantic analysis. + - type: tool + name: find_best_metric_with_metadata_v2 + description: Enhanced metric selection with improved semantic analysis and query suggestions. + - type: tool + name: find_best_metric_with_metadata + description: Find the best metric for a user question using comprehensive metadata analysis. + - type: tool + name: get_metrics_categories + description: Get all metric categories with summary counts, priorities, and example queries. + - type: tool + name: search_metrics_by_category + description: Search metrics filtered by category IDs and priority levels. + - type: tool + name: get_category_metrics_detail + description: Get category summaries or detailed metrics catalog for a single category. + - type: tool + name: convert_time_to_promql_duration + description: Convert decimal hours to Prometheus duration format for use in PromQL queries. + - type: tool + name: query_tempo_tool + description: Search Tempo traces by TraceQL query, service, operation, and time range. + - type: tool + name: get_trace_details_tool + description: Get detailed trace information including spans by trace ID. + - type: tool + name: chat_tempo_tool + description: Conversational interface for Tempo trace analysis using natural language questions. + - type: tool + name: korrel8r_query_objects + description: Execute a Korrel8r domain query and return correlated objects. + - type: tool + name: korrel8r_get_correlated + description: Return correlated objects (alerts, logs, traces, metrics) for a Korrel8r query. + - type: tool + name: get_correlated_logs + description: Fetch application and infrastructure logs for a namespace or pod via Korrel8r. + - type: tool + name: chat + description: Chat with AI models using observability tools with progress tracking. + - type: tool + name: validate_api_key + description: Validate an API key for a given provider by making a minimal server-side request. + - type: tool + name: save_api_key + description: Save or update a provider API key in a Kubernetes Secret. + - type: tool + name: check_provider_secret + description: Check if a provider API key secret exists in the cluster. + - type: tool + name: delete_provider_secret + description: Delete a provider API key secret from the cluster. + - type: tool + name: list_provider_models + description: Query a provider API to list available models for configuration. + - type: tool + name: add_model_to_config + description: Add a new model to the model configuration by updating the Kubernetes ConfigMap. + - type: tool + name: update_maas_model_api_key + description: Update API key and optionally endpoint for an existing MaaS model. + packages: [] + remotes: + - url: https://ai-observability.example.com/mcp + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:rh-ai-engineer/ai-observability + - airesource:rh-ai-engineer/debug-inference + - airesource:rh-ai-engineer/ds-project-setup + - airesource:rh-ai-engineer/guardrails-config + - airesource:rh-ai-engineer/model-deploy + - airesource:rh-ai-engineer/model-monitor + - airesource:rh-ai-engineer/model-registry + - airesource:rh-ai-engineer/nim-setup + - airesource:rh-ai-engineer/pipeline-manage + - airesource:rh-ai-engineer/rh-ai-engineer + - airesource:rh-ai-engineer/serving-runtime-config + - airesource:rh-ai-engineer/workbench-manage diff --git a/mcps/ansible-automation-platform.yaml b/mcps/ansible-automation-platform.yaml new file mode 100644 index 00000000..bf044d7b --- /dev/null +++ b/mcps/ansible-automation-platform.yaml @@ -0,0 +1,487 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: controller.job_templates_launch_retrieve + description: Retrieve single launch for a job template. + - type: tool + name: controller.job_templates_launch_create + description: Launch the job template. + - type: tool + name: controller.workflow_job_templates_launch_create + description: Launch the workflow job template. + - type: tool + name: controller.jobs_retrieve + description: Retrieve a job. + - type: tool + name: controller.workflow_jobs_retrieve + description: Retrieve a workflow job. + - type: tool + name: controller.jobs_stdout_retrieve + description: Get the standard output for the selected job. + - type: tool + name: controller.jobs_job_events_list + description: List job events of a job. + - type: tool + name: controller.jobs_cancel_create + description: Cancel a running or pending job. + - type: tool + name: controller.workflow_jobs_cancel_create + description: Cancel a running or pending workflow job. + - type: tool + name: controller.jobs_relaunch_retrieve + description: Retrieve single relaunch for a job. + - type: tool + name: controller.jobs_relaunch_create + description: Relaunch a job. + - type: tool + name: controller.workflow_jobs_relaunch_create + description: Relaunch a workflow job. + - type: tool + name: controller.jobs_list + description: A list of jobs. + - type: tool + name: eda.activation_instances_list + description: List activation instances with status, queue, and timing info. + - type: tool + name: eda.activation_instances_logs_list + description: List logs for an activation instance by ID. + - type: tool + name: controller.analytics_retrieve + description: A list of additional API endpoints related to analytics. + - type: tool + name: controller.metrics_retrieve + description: Get Prometheus metrics data. + - type: tool + name: controller.projects_list + description: A list of projects. + - type: tool + name: controller.job_templates_list + description: A list of job templates. + - type: tool + name: controller.workflow_job_templates_list + description: A list of workflow job templates. + - type: tool + name: controller.job_templates_retrieve + description: Retrieve a job template. + - type: tool + name: controller.workflow_job_templates_retrieve + description: Retrieve a workflow job template. + - type: tool + name: controller.jobs_job_host_summaries_list + description: List job host summaries of a job. + - type: tool + name: controller.workflow_jobs_list + description: A list of workflow jobs. + - type: tool + name: controller.workflow_jobs_workflow_nodes_list + description: List workflow nodes of a workflow job. + - type: tool + name: controller.job_templates_create + description: Create a job template. + - type: tool + name: controller.schedules_create + description: Create a schedule. + - type: tool + name: controller.projects_create + description: Create a project. + - type: tool + name: controller.job_templates_credentials_create + description: Create a credential of a job template. + - type: tool + name: controller.job_templates_credentials_list + description: List credentials of a job template. + - type: tool + name: controller.job_templates_survey_spec_create + description: Update job template survey specification. + - type: tool + name: controller.job_templates_notification_templates_started_create + description: Create notification templates triggered on job start. + - type: tool + name: controller.job_templates_notification_templates_success_create + description: Create notification templates triggered on job success. + - type: tool + name: controller.job_templates_notification_templates_error_create + description: Create notification templates triggered on job error. + - type: tool + name: controller.unified_job_templates_list + description: List unified job templates. + - type: tool + name: controller.projects_playbooks_retrieve + description: Retrieve single playbook for a project. + - type: tool + name: controller.workflow_job_template_nodes_credentials_list + description: List credentials of a workflow job template node. + - type: tool + name: controller.ad_hoc_commands_create + description: Create an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_list + description: List ad hoc commands. + - type: tool + name: controller.ad_hoc_commands_retrieve + description: Retrieve an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_stdout_retrieve + description: Retrieve stdout output of an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_events_list + description: List events of an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_cancel_create + description: Cancel an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_relaunch_create + description: Relaunch an ad hoc command. + - type: tool + name: controller.ad_hoc_commands_relaunch_retrieve + description: Return passwords needed to start an ad hoc command. + - type: tool + name: controller.hosts_ad_hoc_commands_create + description: Create an ad hoc command of a host. + - type: tool + name: controller.inventories_ad_hoc_commands_create + description: Create an ad hoc command for an inventory. + - type: tool + name: controller.groups_ad_hoc_commands_create + description: Create an ad hoc command for a group. + - type: tool + name: controller.inventories_list + description: A list of inventories. + - type: tool + name: controller.inventory_sources_update_create + description: Sync the inventory source. + - type: tool + name: controller.hosts_list + description: A list of hosts. + - type: tool + name: controller.hosts_retrieve + description: Retrieve a host. + - type: tool + name: controller.hosts_variable_data_retrieve + description: The extra variable configuration for this host. + - type: tool + name: controller.groups_list + description: A list of groups. + - type: tool + name: controller.groups_create + description: Create a new group. + - type: tool + name: controller.inventories_create + description: Create an inventory. + - type: tool + name: controller.hosts_create + description: Create a host. + - type: tool + name: controller.inventory_sources_create + description: Create an inventory source. + - type: tool + name: controller.hosts_ansible_facts_retrieve + description: Get Ansible facts for a host. + - type: tool + name: controller.inventory_sources_list + description: List inventory sources. + - type: tool + name: controller.inventories_inventory_sources_list + description: List inventory sources for an inventory. + - type: tool + name: controller.instance_groups_list + description: A list of instance groups. + - type: tool + name: controller.instance_groups_create + description: Create an instance group for job execution. + - type: tool + name: controller.instance_groups_retrieve + description: Retrieve an instance group. + - type: tool + name: controller.mesh_visualizer_retrieve + description: Get mesh network topology visualization data. + - type: tool + name: controller.instances_create + description: Register an execution or hop node instance. + - type: tool + name: controller.instances_retrieve + description: Retrieve an instance. + - type: tool + name: gateway.activitystream_list + description: List audit trail entries for tracking system changes and user actions. + - type: tool + name: gateway.activitystream_retrieve + description: Retrieve an audit trail entry. + - type: tool + name: gateway.authenticators_list + description: List authentication types (LDAP, SAML, OAuth). + - type: tool + name: controller.activity_stream_list + description: A list of activity stream entries. + - type: tool + name: controller.activity_stream_retrieve + description: Retrieve an activity stream entry. + - type: tool + name: gateway.status_retrieve + description: Retrieve gateway status. + - type: tool + name: gateway.feature_flags_state_retrieve + description: Retrieve feature flags state. + - type: tool + name: gateway.teams_list + description: List teams for bulk permission assignment and RBAC. + - type: tool + name: gateway.teams_retrieve + description: Retrieve a team. + - type: tool + name: gateway.teams_create + description: Create a team. + - type: tool + name: gateway.teams_update + description: Update a team. + - type: tool + name: gateway.teams_destroy + description: Delete a team. + - type: tool + name: gateway.teams_users_list + description: List all users for a team. + - type: tool + name: gateway.me_list + description: Retrieve details about the current authenticated user. + - type: tool + name: gateway.role_definitions_list + description: List RBAC roles defining permissions. + - type: tool + name: gateway.role_team_assignments_list + description: List RBAC role grants for teams. + - type: tool + name: gateway.role_user_assignments_list + description: List RBAC role grants for users. + - type: tool + name: gateway.role_user_assignments_create + description: Create an RBAC role grant for a user. + - type: tool + name: gateway.role_user_assignments_destroy + description: Delete an RBAC role grant for a user. + - type: tool + name: gateway.organizations_list + description: List organizations for access control. + - type: tool + name: gateway.organizations_retrieve + description: Retrieve an organization. + - type: tool + name: gateway.organizations_create + description: Create an organization. + - type: tool + name: gateway.organizations_update + description: Update an organization. + - type: tool + name: gateway.organizations_destroy + description: Delete an organization. + - type: tool + name: gateway.users_list + description: List platform users. + - type: tool + name: gateway.users_retrieve + description: Retrieve a platform user. + - type: tool + name: gateway.users_create + description: Create a platform user. + - type: tool + name: gateway.users_update + description: Update a platform user. + - type: tool + name: gateway.users_destroy + description: Delete a platform user. + - type: tool + name: gateway.users_teams_list + description: List all teams for a user. + - type: tool + name: gateway.authenticators_retrieve + description: Retrieve an authenticator. + - type: tool + name: gateway.authenticators_create + description: Create an authenticator. + - type: tool + name: gateway.authenticators_update + description: Update an authenticator. + - type: tool + name: gateway.authenticators_destroy + description: Delete an authenticator. + - type: tool + name: gateway.authenticator_maps_list + description: List conditional rules for granting access based on user attributes. + - type: tool + name: gateway.authenticator_maps_create + description: Create a conditional rule for granting access. + - type: tool + name: controller.users_activity_stream_list + description: List activity stream for a user. + - type: tool + name: controller.credentials_list + description: A list of credentials. + - type: tool + name: controller.credentials_create + description: Create a new credential. + - type: tool + name: controller.credentials_retrieve + description: Retrieve a credential. + - type: tool + name: controller.credentials_test_create + description: Test update the input values of an external credential. + - type: tool + name: controller.credential_types_list + description: A list of credential types. + - type: tool + name: controller.credential_types_create + description: Create a new custom credential type. + - type: tool + name: controller.credential_types_retrieve + description: Retrieve a credential type. + - type: tool + name: controller.credential_types_update + description: Update a custom credential type. + - type: tool + name: controller.credential_types_destroy + description: Delete a custom credential type. + - type: tool + name: controller.credentials_input_sources_create + description: Create new source for a credential. + - type: tool + name: controller.credential_input_sources_list + description: List credential input sources. + - type: tool + name: controller.settings_list + description: A list of settings endpoints. + - type: tool + name: controller.settings_retrieve + description: Retrieve a setting. + - type: tool + name: controller.settings_partial_update + description: Update system settings. + - type: tool + name: gateway.settings_list + description: List Gateway setting categories. + - type: tool + name: gateway.settings_getter + description: Get Gateway preferences for a category. + - type: tool + name: gateway.settings_update + description: Update Gateway preferences within a category. + - type: tool + name: controller.config_retrieve + description: Return various configuration settings. + - type: tool + name: controller.config_create + description: Add or update a subscription manifest license. + - type: tool + name: controller.notification_templates_list + description: A list of notification templates. + - type: tool + name: controller.notification_templates_create + description: Create a new notification template. + - type: tool + name: controller.notification_templates_retrieve + description: Retrieve a notification template. + - type: tool + name: controller.notification_templates_update + description: Update a notification template. + - type: tool + name: controller.notification_templates_destroy + description: Delete a notification template. + - type: tool + name: controller.execution_environments_list + description: A list of execution environments. + - type: tool + name: controller.execution_environments_create + description: Create a new execution environment. + - type: tool + name: controller.execution_environments_retrieve + description: Retrieve an execution environment. + - type: tool + name: controller.execution_environments_update + description: Update an execution environment. + - type: tool + name: controller.execution_environments_destroy + description: Delete an execution environment. + - type: tool + name: controller.organizations_execution_environments_create + description: Create an execution environment of an organization. + - type: tool + name: controller.organizations_instance_groups_create + description: Create an instance group of an organization. + - type: tool + name: controller.organizations_galaxy_credentials_create + description: Create new credential for an organization. + - type: tool + name: galaxy.ansible_content_collections_index + description: Get collection index in distribution. + - type: tool + name: galaxy.ansible_content_collections_index_versions_get_distro_base_pa + description: List collection versions in distribution. + - type: tool + name: galaxy.execution_environments_repositories_get_repositories + description: List execution environment repositories. + - type: tool + name: lightspeed.aap_rag_search + description: Search AAP documentation and knowledge base using RAG. + packages: [] + remotes: + - url: https://aap-mcp-server.example.com/job_management/mcp + - url: https://aap-mcp-server.example.com/inventory_management/mcp + - url: https://aap-mcp-server.example.com/configuration/mcp + - url: https://aap-mcp-server.example.com/security_compliance/mcp + - url: https://aap-mcp-server.example.com/system_monitoring/mcp + - url: https://aap-mcp-server.example.com/user_management/mcp + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/execution-risk-analyzer + - airesource:rh-automation/execution-summary + - airesource:rh-automation/forensic-troubleshooter + - airesource:rh-automation/governance-assessor + - airesource:rh-automation/governance-executor + - airesource:rh-automation/governance-readiness-assessor + - airesource:rh-automation/governed-job-launcher + - airesource:rh-automation/host-fact-inspector + - airesource:rh-automation/job-failure-analyzer + - airesource:rh-automation/resolution-advisor + - airesource:rh-automation/rh-automation + - airesource:rh-sre/cve-impact + - airesource:rh-sre/cve-validation + - airesource:rh-sre/execution-summary + - airesource:rh-sre/fleet-inventory + - airesource:rh-sre/job-template-creator + - airesource:rh-sre/job-template-remediation-validator + - airesource:rh-sre/mcp-aap-validator + - airesource:rh-sre/mcp-lightspeed-validator + - airesource:rh-sre/playbook-executor + - airesource:rh-sre/playbook-generator + - airesource:rh-sre/remediation + - airesource:rh-sre/remediation-verifier + - airesource:rh-sre/rh-sre + - airesource:rh-sre/system-context diff --git a/mcps/assisted-installer.yaml b/mcps/assisted-installer.yaml new file mode 100644 index 00000000..bb2d6294 --- /dev/null +++ b/mcps/assisted-installer.yaml @@ -0,0 +1,107 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + 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: [] + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:ocp-admin/cluster-creator + - airesource:ocp-admin/cluster-inventory + - airesource:ocp-admin/ocp-admin diff --git a/mcps/catalog-info.yaml b/mcps/catalog-info.yaml new file mode 100644 index 00000000..cc666afd --- /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. + annotations: + 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..98ca9a8e --- /dev/null +++ b/mcps/github.yaml @@ -0,0 +1,296 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: actions_get + description: Get details of GitHub Actions resources (workflows, runs, jobs, artifacts). + - type: tool + name: actions_list + description: List GitHub Actions workflows in a repository. + - type: tool + name: actions_run_trigger + description: Trigger GitHub Actions workflow actions. + - type: tool + name: get_job_logs + description: Get GitHub Actions workflow job logs. + - type: tool + name: get_code_scanning_alert + description: Get a code scanning alert. + - type: tool + name: list_code_scanning_alerts + description: List code scanning alerts. + - type: tool + name: get_me + description: Get my user profile. + - type: tool + name: get_team_members + description: Get team members. + - type: tool + name: get_teams + description: Get teams. + - type: tool + name: assign_copilot_to_issue + description: Assign Copilot to an issue. + - type: tool + name: request_copilot_review + description: Request Copilot review on a pull request. + - type: tool + name: get_dependabot_alert + description: Get a Dependabot alert. + - type: tool + name: list_dependabot_alerts + description: List Dependabot alerts. + - type: tool + name: get_discussion + description: Get a discussion. + - type: tool + name: get_discussion_comments + description: Get discussion comments. + - type: tool + name: list_discussion_categories + description: List discussion categories. + - type: tool + name: list_discussions + description: List discussions. + - type: tool + name: create_gist + description: Create a Gist. + - type: tool + name: get_gist + description: Get Gist content. + - type: tool + name: list_gists + description: List Gists. + - type: tool + name: update_gist + description: Update a Gist. + - type: tool + name: get_repository_tree + description: Get repository tree. + - type: tool + name: add_issue_comment + description: Add comment to an issue. + - type: tool + name: get_label + description: Get a specific label from a repository. + - type: tool + name: issue_read + description: Get issue details. + - type: tool + name: issue_write + description: Create or update an issue. + - type: tool + name: list_issue_types + description: List available issue types. + - type: tool + name: list_issues + description: List issues. + - type: tool + name: search_issues + description: Search issues. + - type: tool + name: sub_issue_write + description: Change sub-issue. + - type: tool + name: label_write + description: Write operations on repository labels. + - type: tool + name: list_label + description: List labels from a repository. + - type: tool + name: dismiss_notification + description: Dismiss a notification. + - type: tool + name: get_notification_details + description: Get notification details. + - type: tool + name: list_notifications + description: List notifications. + - type: tool + name: manage_notification_subscription + description: Manage notification subscription. + - type: tool + name: manage_repository_notification_subscription + description: Manage repository notification subscription. + - type: tool + name: mark_all_notifications_read + description: Mark all notifications as read. + - type: tool + name: search_orgs + description: Search organizations. + - type: tool + name: projects_get + description: Get details of GitHub Projects resources. + - type: tool + name: projects_list + description: List GitHub Projects resources. + - type: tool + name: projects_write + description: Modify GitHub Project items. + - type: tool + name: add_comment_to_pending_review + description: Add review comment to the latest pending pull request review. + - type: tool + name: add_reply_to_pull_request_comment + description: Add reply to pull request comment. + - type: tool + name: create_pull_request + description: Open a new pull request. + - type: tool + name: list_pull_requests + description: List pull requests. + - type: tool + name: merge_pull_request + description: Merge a pull request. + - type: tool + name: pull_request_read + description: Get details for a single pull request. + - type: tool + name: pull_request_review_write + description: Write operations on pull request reviews (create, submit, delete). + - type: tool + name: search_pull_requests + description: Search pull requests. + - type: tool + name: update_pull_request + description: Edit a pull request. + - type: tool + name: update_pull_request_branch + description: Update pull request branch. + - type: tool + name: create_branch + description: Create a branch. + - type: tool + name: create_or_update_file + description: Create or update a file. + - type: tool + name: create_repository + description: Create a repository. + - type: tool + name: delete_file + description: Delete a file. + - type: tool + name: fork_repository + description: Fork a repository. + - type: tool + name: get_commit + description: Get commit details. + - type: tool + name: get_file_contents + description: Get file or directory contents. + - type: tool + name: get_latest_release + description: Get latest release. + - type: tool + name: get_release_by_tag + description: Get a release by tag name. + - type: tool + name: get_tag + description: Get tag details. + - type: tool + name: list_branches + description: List branches. + - type: tool + name: list_commits + description: List commits. + - type: tool + name: list_releases + description: List releases. + - type: tool + name: list_tags + description: List tags. + - type: tool + name: push_files + description: Push files to a repository. + - type: tool + name: search_code + description: Search code. + - type: tool + name: search_repositories + description: Search repositories. + - type: tool + name: get_secret_scanning_alert + description: Get a secret scanning alert. + - type: tool + name: list_secret_scanning_alerts + description: List secret scanning alerts. + - type: tool + name: get_global_security_advisory + description: Get a global security advisory. + - type: tool + name: list_global_security_advisories + description: List global security advisories. + - type: tool + name: list_org_repository_security_advisories + description: List organization repository security advisories. + - type: tool + name: list_repository_security_advisories + description: List repository security advisories. + - type: tool + name: list_starred_repositories + description: List starred repositories. + - type: tool + name: star_repository + description: Star a repository. + - type: tool + name: unstar_repository + description: Unstar a repository. + - type: tool + name: search_users + description: Search users. + 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: [] + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/debug-build + - airesource:rh-developer/debug-container + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-pipeline + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-rbac + - airesource:rh-developer/debug-rhel + - airesource:rh-developer/debug-scc + - airesource:rh-developer/deploy + - airesource:rh-developer/detect-project + - airesource:rh-developer/helm-deploy + - airesource:rh-developer/incident-triage + - airesource:rh-developer/recommend-image + - airesource:rh-developer/rh-developer + - airesource:rh-developer/rhel-deploy + - airesource:rh-developer/s2i-build + - airesource:rh-developer/validate-environment diff --git a/mcps/openshift-mcp-server.yaml b/mcps/openshift-mcp-server.yaml new file mode 100644 index 00000000..9e2e4384 --- /dev/null +++ b/mcps/openshift-mcp-server.yaml @@ -0,0 +1,146 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: configuration_contexts_list + description: List available kubeconfig contexts for cluster access. + - type: tool + name: configuration_view + description: Get the current Kubernetes configuration as kubeconfig YAML. + - type: tool + name: events_list + description: List Kubernetes events from all namespaces in the cluster. + - type: tool + name: namespaces_list + description: List all namespaces in the cluster. + - type: tool + name: nodes_log + description: Get logs from a Kubernetes node (kubelet, kube-proxy, or system logs). + - type: tool + name: nodes_stats_summary + description: Get detailed resource usage statistics from a node via kubelet Summary API. + - type: tool + name: nodes_top + description: List node resource consumption (CPU and memory) from Metrics Server. + - type: tool + name: pods_delete + description: Delete a pod in a specified namespace. + - type: tool + name: pods_exec + description: Execute a command in a pod container. + - type: tool + name: pods_get + description: Get details of a specific pod. + - type: tool + name: pods_list + description: List all pods in the cluster from all namespaces. + - type: tool + name: pods_list_in_namespace + description: List all pods in a specified namespace. + - type: tool + name: pods_log + description: Get logs from a pod container. + - type: tool + name: pods_run + description: Run a new pod with a specified container image. + - type: tool + name: pods_top + description: List pod resource consumption (CPU and memory) from Metrics Server. + - type: tool + name: resources_create_or_update + description: Create or update a Kubernetes resource from YAML or JSON. + - type: tool + name: resources_delete + description: Delete a Kubernetes resource by kind and name. + - type: tool + name: resources_get + description: Get details of a specific Kubernetes resource. + - type: tool + name: resources_list + description: List Kubernetes resources by API version and kind. + - type: tool + name: resources_scale + description: Get or update the scale of a Kubernetes resource. + 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: [] + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:ocp-admin/cluster-report + - airesource:ocp-admin/ocp-admin + - airesource:rh-ai-engineer/ai-observability + - airesource:rh-ai-engineer/debug-inference + - airesource:rh-ai-engineer/ds-project-setup + - airesource:rh-ai-engineer/guardrails-config + - airesource:rh-ai-engineer/model-deploy + - airesource:rh-ai-engineer/model-monitor + - airesource:rh-ai-engineer/model-registry + - airesource:rh-ai-engineer/nim-setup + - airesource:rh-ai-engineer/pipeline-manage + - airesource:rh-ai-engineer/rh-ai-engineer + - airesource:rh-ai-engineer/serving-runtime-config + - airesource:rh-ai-engineer/workbench-manage + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/debug-build + - airesource:rh-developer/debug-container + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-pipeline + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-rbac + - airesource:rh-developer/debug-rhel + - airesource:rh-developer/debug-scc + - airesource:rh-developer/deploy + - airesource:rh-developer/detect-project + - airesource:rh-developer/helm-deploy + - airesource:rh-developer/incident-triage + - airesource:rh-developer/recommend-image + - airesource:rh-developer/rh-developer + - airesource:rh-developer/rhel-deploy + - airesource:rh-developer/s2i-build + - airesource:rh-developer/validate-environment + - airesource:rh-virt/rh-virt + - airesource:rh-virt/vm-clone + - airesource:rh-virt/vm-create + - airesource:rh-virt/vm-delete + - airesource:rh-virt/vm-inventory + - airesource:rh-virt/vm-lifecycle-manager + - airesource:rh-virt/vm-rebalance + - airesource:rh-virt/vm-snapshot-create + - airesource:rh-virt/vm-snapshot-delete + - airesource:rh-virt/vm-snapshot-list + - airesource:rh-virt/vm-snapshot-restore diff --git a/mcps/podman.yaml b/mcps/podman.yaml new file mode 100644 index 00000000..c097cc4a --- /dev/null +++ b/mcps/podman.yaml @@ -0,0 +1,96 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: container_inspect + description: Display low-level information and configuration of a container. + - type: tool + name: container_list + description: List running containers with status information. + - type: tool + name: container_logs + description: Display logs of a container by ID or name. + - type: tool + name: container_remove + description: Remove a container by ID or name. + - type: tool + name: container_run + description: Run a container with a specified image. + - type: tool + name: container_stop + description: Stop a running container by ID or name. + - type: tool + name: image_build + description: Build an image from a Dockerfile, Podmanfile, or Containerfile. + - type: tool + name: image_list + description: List container images on the local machine. + - type: tool + name: image_pull + description: Pull a container image from a registry to local storage. + - type: tool + name: image_push + description: Push a container image from local storage to a registry. + - type: tool + name: image_remove + description: Remove a container image from local storage. + - type: tool + name: network_list + description: List all available container networks. + - type: tool + name: volume_list + description: List all available container volumes. + packages: + - type: npx + name: podman-mcp-server + version: 0.0.15 + environment_variables: [] + remotes: [] + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/debug-build + - airesource:rh-developer/debug-container + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-pipeline + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-rbac + - airesource:rh-developer/debug-rhel + - airesource:rh-developer/debug-scc + - airesource:rh-developer/deploy + - airesource:rh-developer/detect-project + - airesource:rh-developer/helm-deploy + - airesource:rh-developer/incident-triage + - airesource:rh-developer/recommend-image + - airesource:rh-developer/rh-developer + - airesource:rh-developer/rhel-deploy + - airesource:rh-developer/s2i-build + - airesource:rh-developer/validate-environment diff --git a/mcps/rhoai.yaml b/mcps/rhoai.yaml new file mode 100644 index 00000000..38c9fcbd --- /dev/null +++ b/mcps/rhoai.yaml @@ -0,0 +1,325 @@ +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. + labels: + distribution: external + 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/ai5-marketplace + system: default/agentic-plugins + primitives: + - type: tool + name: analyze_training_failure + description: Analyze a training failure and suggest remediation. + - type: tool + name: check_deployment_prerequisites + description: Pre-flight checks before model deployment. + - type: tool + name: check_training_prerequisites + description: Check prerequisites before starting a training job. + - type: tool + name: cluster_summary + description: Get a compact cluster overview optimized for context windows. + - type: tool + name: create_data_science_project + description: Create a new Data Science Project. + - type: tool + name: create_pipeline_server + description: Create a pipeline server for a Data Science Project. + - type: tool + name: create_runtime + description: Create a new ClusterTrainingRuntime. + - type: tool + name: create_s3_data_connection + description: Create an S3 data connection. + - type: tool + name: create_serving_runtime + description: Create a serving runtime from a platform template. + - type: tool + name: create_storage + description: Create a new persistent storage volume (PVC). + - type: tool + name: create_workbench + description: Create a new workbench (notebook environment). + - type: tool + name: delete_data_connection + description: Delete a data connection. + - type: tool + name: delete_data_science_project + description: Delete a Data Science Project. + - type: tool + name: delete_inference_service + description: Delete a deployed model. + - type: tool + name: delete_pipeline_server + description: Delete the pipeline server from a Data Science Project. + - type: tool + name: delete_runtime + description: Delete a ClusterTrainingRuntime. + - type: tool + name: delete_storage + description: Delete a persistent storage volume (PVC). + - type: tool + name: delete_training_job + description: Delete a training job. + - type: tool + name: delete_workbench + description: Delete a workbench. + - type: tool + name: deploy_model + description: Deploy a model as an InferenceService. + - type: tool + name: deploy_quickstart + description: Deploy a Red Hat AI Quickstart to the cluster. + - type: tool + name: diagnose_resource + description: Comprehensive diagnostic for any resource in one call. + - type: tool + name: estimate_resources + description: Estimate GPU and memory requirements for training. + - type: tool + name: estimate_serving_resources + description: Estimate GPU/memory/CPU requirements for model serving. + - type: tool + name: explore_cluster + description: Complete cluster exploration in one call. + - type: tool + name: find_benchmarks_by_gpu + description: Find all benchmarks for a specific GPU type. + - type: tool + name: fix_pvc_permissions + description: Fix permissions on a PVC for training jobs. + - type: tool + name: get_catalog_model_artifacts + description: Get artifacts (storage URIs) for a model in the Model Catalog. + - type: tool + name: get_cluster_resources + description: Get cluster-wide compute resources available for training. + - type: tool + name: get_data_connection + description: Get detailed information about a data connection. + - type: tool + name: get_deployment_config + description: Generate Kubernetes deployment YAML configs for a recommended model. + - type: tool + name: get_inference_service + description: Get detailed information about a deployed model. + - type: tool + name: get_job_events + description: Get Kubernetes events for a training job. + - type: tool + name: get_job_spec + description: Get the complete specification of a training job. + - type: tool + name: get_model_artifacts + description: Get artifacts (storage URIs) for a model version. + - type: tool + name: get_model_benchmarks + description: Get benchmark data for a model. + - type: tool + name: get_model_endpoint + description: Get the inference endpoint URL for a deployed model. + - type: tool + name: get_model_version + description: Get detailed information about a specific model version. + - type: tool + name: get_pipeline_server + description: Get the pipeline server status for a Data Science Project. + - type: tool + name: get_project_details + description: Get detailed information about a Data Science Project. + - type: tool + name: get_quickstart_readme + description: Get the README.md content for a specific quickstart. + - type: tool + name: get_registered_model + description: Get detailed information about a registered model. + - type: tool + name: get_resource + description: Get any RHOAI resource by type. + - type: tool + name: get_runtime_details + description: Get detailed information about a training runtime. + - type: tool + name: get_training_job + description: Get detailed information about a specific training job. + - type: tool + name: get_training_logs + description: Get logs from a training job. + - type: tool + name: get_training_progress + description: Get real-time training progress for a job. + - type: tool + name: get_validation_metrics + description: Get validation metrics for a specific model version. + - type: tool + name: get_workbench + description: Get detailed information about a workbench. + - type: tool + name: get_workbench_url + description: Get the access URL for a workbench. + - type: tool + name: list_available_quickstarts + description: List all available Red Hat AI Quickstarts. + - type: tool + name: list_catalog_sources + description: List available sources in the Model Catalog. + - type: tool + name: list_data_connections + description: List data connections in a Data Science Project with pagination. + - type: tool + name: list_data_science_projects + description: List Data Science Projects in the cluster with pagination. + - type: tool + name: list_inference_services + description: List deployed models in a Data Science Project with pagination. + - type: tool + name: list_model_versions + description: List all versions of a registered model with pagination. + - type: tool + name: list_notebook_images + description: List available notebook images. + - type: tool + name: list_registered_models + description: List registered models in the Model Registry with pagination. + - type: tool + name: list_resource_names + description: List just resource names without full metadata. + - type: tool + name: list_resources + description: List any RHOAI resource type. + - type: tool + name: list_serving_runtimes + description: List available model serving runtimes. + - type: tool + name: list_storage + description: List persistent storage (PVCs) in a Data Science Project with pagination. + - type: tool + name: list_tool_categories + description: List all available tool categories with descriptions. + - type: tool + name: list_training_jobs + description: List training jobs in a namespace with pagination. + - type: tool + name: list_training_runtimes + description: List available training runtimes. + - type: tool + name: list_workbenches + description: List workbenches in a Data Science Project with pagination. + - type: tool + name: manage_checkpoints + description: Get checkpoint information for a training job. + - type: tool + name: manage_resource + description: Perform lifecycle actions on any resource type. + - type: tool + name: multi_resource_status + description: Get status for multiple resources in a single call. + - type: tool + name: prepare_model_deployment + description: Complete pre-flight preparation for model deployment in one call. + - type: tool + name: prepare_training + description: Complete pre-flight setup for a training job in a single call. + - type: tool + name: project_summary + description: Get a compact project status optimized for context windows. + - type: tool + name: recommend_model + description: Get LLM model recommendations from Neural Navigator. + - type: tool + name: recommend_serving_runtime + description: Recommend the best serving runtime for a model. + - type: tool + name: resource_status + description: Get quick status check for any resource. + - type: tool + name: resume_training_job + description: Resume a suspended training job. + - type: tool + name: run_container_training_job + description: Run a training job using a custom container image. + - type: tool + name: set_model_serving_mode + description: Set the model serving mode for a project. + - type: tool + name: setup_hf_credentials + description: Set up HuggingFace credentials for model/dataset access. + - type: tool + name: setup_nfs_storage + description: Get guidance on setting up NFS storage for distributed training. + - type: tool + name: setup_training_runtime + description: Set up a ClusterTrainingRuntime. + - type: tool + name: setup_training_storage + description: Create a PVC for training checkpoints and data. + - type: tool + name: start_workbench + description: Start a stopped workbench. + - type: tool + name: stop_workbench + description: Stop a running workbench. + - type: tool + name: suggest_tools + description: Get recommended tools and workflow for a given intent. + - type: tool + name: suspend_training_job + description: Suspend a running training job. + - type: tool + name: test_model_endpoint + description: "Test a deployed model's inference endpoint." + - type: tool + name: train + description: Create a training job for model fine-tuning. + - type: tool + name: training + description: Unified training operations using action parameter. + - type: tool + name: validate_training_config + description: Validate a training configuration before job creation. + - type: tool + name: wait_for_job_completion + description: Wait for a training job to reach a target status. + packages: + - type: uvx + name: rhoai-mcp + version: git+https://github.com/opendatahub-io/rhoai-mcp@31576c61b6f59280704c86dde1e3e9ed79def5e5 + environment_variables: [] + remotes: [] + dependsOn: + - system:default/agentic-plugins + dependencyOf: + - airesource:rh-ai-engineer/ai-observability + - airesource:rh-ai-engineer/debug-inference + - airesource:rh-ai-engineer/ds-project-setup + - airesource:rh-ai-engineer/guardrails-config + - airesource:rh-ai-engineer/model-deploy + - airesource:rh-ai-engineer/model-monitor + - airesource:rh-ai-engineer/model-registry + - airesource:rh-ai-engineer/nim-setup + - airesource:rh-ai-engineer/pipeline-manage + - airesource:rh-ai-engineer/rh-ai-engineer + - airesource:rh-ai-engineer/serving-runtime-config + - airesource:rh-ai-engineer/workbench-manage diff --git a/ocp-admin/catalog-info.yaml b/ocp-admin/catalog-info.yaml new file mode 100644 index 00000000..adad806c --- /dev/null +++ b/ocp-admin/catalog-info.yaml @@ -0,0 +1,25 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..8443cbb4 --- /dev/null +++ b/ocp-admin/ocp-admin-plugin.yaml @@ -0,0 +1,52 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - platform-engineering + categories: + - cluster-management + - administration + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:agentic-plugins/assisted-installer + - mcpserver:agentic-plugins/openshift-mcp-server + dependencyOf: + - airesource:ocp-admin/cluster-creator + - airesource:ocp-admin/cluster-inventory + - airesource:ocp-admin/cluster-report + - airesource:ocp-admin/container-cve-validator + - airesource:ocp-admin/coreos-cve-validator + - airesource:ocp-admin/cve-recon + - airesource:ocp-admin/image-inspect 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..0936a67d --- /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/ai5-marketplace + 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..4aa6131e --- /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/ai5-marketplace + 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..76182074 --- /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/ai5-marketplace + 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..215ada2c --- /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/ai5-marketplace + 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..cd7bb029 --- /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/ai5-marketplace + 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..db369cbd --- /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/ai5-marketplace + 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..398d4f8d --- /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/ai5-marketplace + 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..04831289 --- /dev/null +++ b/rh-ai-engineer/catalog-info.yaml @@ -0,0 +1,29 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..fb6c8aef --- /dev/null +++ b/rh-ai-engineer/rh-ai-engineer-plugin.yaml @@ -0,0 +1,57 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - ai-engineering + categories: + - model-management + - ml-ops + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai + dependencyOf: + - airesource:rh-ai-engineer/ai-observability + - airesource:rh-ai-engineer/debug-inference + - airesource:rh-ai-engineer/ds-project-setup + - airesource:rh-ai-engineer/guardrails-config + - airesource:rh-ai-engineer/model-deploy + - airesource:rh-ai-engineer/model-monitor + - airesource:rh-ai-engineer/model-registry + - airesource:rh-ai-engineer/nim-setup + - airesource:rh-ai-engineer/pipeline-manage + - airesource:rh-ai-engineer/serving-runtime-config + - airesource:rh-ai-engineer/workbench-manage 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..8e1bb269 --- /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/ai5-marketplace + 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..7867bfc2 --- /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/ai5-marketplace + 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..02165893 --- /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/ai5-marketplace + 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..aaaf5c4f --- /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/ai5-marketplace + 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..93f2d175 --- /dev/null +++ b/rh-ai-engineer/skills/model-deploy/catalog-info.yaml @@ -0,0 +1,44 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-ai-engineer/model-registry 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..3cc5bf23 --- /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/ai5-marketplace + 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..1477d238 --- /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/ai5-marketplace + disciplines: + - machine-learning + categories: + - management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-ai-engineer/rh-ai-engineer + - airesource:rh-ai-engineer/model-deploy + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/rhoai 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..a8149137 --- /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/ai5-marketplace + 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..7250befa --- /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/ai5-marketplace + 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..76a35ad7 --- /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/ai5-marketplace + 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..8dfc590b --- /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/ai5-marketplace + 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..e34e8fd4 --- /dev/null +++ b/rh-automation/catalog-info.yaml @@ -0,0 +1,29 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..3824e41a --- /dev/null +++ b/rh-automation/rh-automation-plugin.yaml @@ -0,0 +1,55 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - operations + categories: + - automation + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/execution-risk-analyzer + - airesource:rh-automation/execution-summary + - airesource:rh-automation/forensic-troubleshooter + - airesource:rh-automation/governance-assessor + - airesource:rh-automation/governance-executor + - airesource:rh-automation/governance-readiness-assessor + - airesource:rh-automation/governed-job-launcher + - airesource:rh-automation/host-fact-inspector + - airesource:rh-automation/job-failure-analyzer + - airesource:rh-automation/resolution-advisor 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..3c186330 --- /dev/null +++ b/rh-automation/skills/aap-mcp-validator/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + disciplines: + - automation + categories: + - validation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/forensic-troubleshooter + - airesource:rh-automation/governance-assessor + - airesource:rh-automation/governance-executor 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..5e6ef581 --- /dev/null +++ b/rh-automation/skills/execution-risk-analyzer/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - automation + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/governance-executor 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..eedbe52a --- /dev/null +++ b/rh-automation/skills/execution-summary/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + disciplines: + - automation + categories: + - reporting + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/forensic-troubleshooter + - airesource:rh-automation/governance-assessor + - airesource:rh-automation/governance-executor 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..68184d72 --- /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/ai5-marketplace + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - 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 + - mcpserver:agentic-plugins/ansible-automation-platform 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..890e8be5 --- /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/ai5-marketplace + disciplines: + - security + categories: + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/governance-readiness-assessor + - airesource:rh-automation/execution-summary + - mcpserver:agentic-plugins/ansible-automation-platform 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..6c494c0b --- /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/ai5-marketplace + disciplines: + - automation + categories: + - execution + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - airesource:rh-automation/aap-mcp-validator + - airesource:rh-automation/execution-risk-analyzer + - airesource:rh-automation/governed-job-launcher + - airesource:rh-automation/execution-summary + - mcpserver:agentic-plugins/ansible-automation-platform 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..6ac0f6e7 --- /dev/null +++ b/rh-automation/skills/governance-readiness-assessor/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - security + categories: + - governance + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/governance-assessor 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..58ad0039 --- /dev/null +++ b/rh-automation/skills/governed-job-launcher/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - automation + categories: + - execution + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/governance-executor 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..d14e93f9 --- /dev/null +++ b/rh-automation/skills/host-fact-inspector/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/forensic-troubleshooter 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..64bd3332 --- /dev/null +++ b/rh-automation/skills/job-failure-analyzer/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - sre + categories: + - analysis + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/forensic-troubleshooter 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..5c0d988c --- /dev/null +++ b/rh-automation/skills/resolution-advisor/catalog-info.yaml @@ -0,0 +1,41 @@ +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/ai5-marketplace + disciplines: + - sre + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-automation/forensic-troubleshooter diff --git a/rh-basic/catalog-info.yaml b/rh-basic/catalog-info.yaml new file mode 100644 index 00000000..dd0a69d0 --- /dev/null +++ b/rh-basic/catalog-info.yaml @@ -0,0 +1,24 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..72deb0b6 --- /dev/null +++ b/rh-basic/rh-basic-plugin.yaml @@ -0,0 +1,50 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - operations + categories: + - getting-started + - support + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:redhat/security-mcp-server + dependencyOf: + - airesource:rh-basic/red-hat-cve-explainer + - airesource:rh-basic/red-hat-diagnostics + - airesource:rh-basic/red-hat-get-started + - airesource:rh-basic/red-hat-product-lifecycle + - airesource:rh-basic/red-hat-security-mcp-setup + - airesource:rh-basic/red-hat-support-severity 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..9d6ac27c --- /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/ai5-marketplace + 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..4aead26d --- /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/ai5-marketplace + 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..6cd96505 --- /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/ai5-marketplace + 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..8c26fc0d --- /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/ai5-marketplace + 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..30169e8a --- /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/ai5-marketplace + 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..fe091dc0 --- /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/ai5-marketplace + 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..37121420 --- /dev/null +++ b/rh-developer/catalog-info.yaml @@ -0,0 +1,35 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..0660b891 --- /dev/null +++ b/rh-developer/rh-developer-plugin.yaml @@ -0,0 +1,64 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - development + categories: + - build + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/github + - mcpserver:redhat/red-hat-lightspeed-mcp-server + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/debug-build + - airesource:rh-developer/debug-container + - airesource:rh-developer/debug-network + - airesource:rh-developer/debug-pipeline + - airesource:rh-developer/debug-pod + - airesource:rh-developer/debug-rbac + - airesource:rh-developer/debug-rhel + - airesource:rh-developer/debug-scc + - airesource:rh-developer/deploy + - airesource:rh-developer/detect-project + - airesource:rh-developer/helm-deploy + - airesource:rh-developer/incident-triage + - airesource:rh-developer/recommend-image + - airesource:rh-developer/rhel-deploy + - airesource:rh-developer/s2i-build + - airesource:rh-developer/validate-environment 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..18e41c5a --- /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/ai5-marketplace + disciplines: + - devops + categories: + - deployment + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - 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 + - 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-build/catalog-info.yaml b/rh-developer/skills/debug-build/catalog-info.yaml new file mode 100644 index 00000000..67a85d79 --- /dev/null +++ b/rh-developer/skills/debug-build/catalog-info.yaml @@ -0,0 +1,47 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/incident-triage 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..f708e1d9 --- /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/ai5-marketplace + 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..6400711e --- /dev/null +++ b/rh-developer/skills/debug-network/catalog-info.yaml @@ -0,0 +1,47 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/incident-triage 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..28098db4 --- /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/ai5-marketplace + 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..ff15c9cf --- /dev/null +++ b/rh-developer/skills/debug-pod/catalog-info.yaml @@ -0,0 +1,47 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy + - airesource:rh-developer/incident-triage 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..7221defe --- /dev/null +++ b/rh-developer/skills/debug-rbac/catalog-info.yaml @@ -0,0 +1,47 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/incident-triage 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..281820e2 --- /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/ai5-marketplace + 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..b5e80f84 --- /dev/null +++ b/rh-developer/skills/debug-scc/catalog-info.yaml @@ -0,0 +1,47 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/incident-triage diff --git a/rh-developer/skills/deploy/catalog-info.yaml b/rh-developer/skills/deploy/catalog-info.yaml new file mode 100644 index 00000000..7efad99d --- /dev/null +++ b/rh-developer/skills/deploy/catalog-info.yaml @@ -0,0 +1,46 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..1e75db65 --- /dev/null +++ b/rh-developer/skills/detect-project/catalog-info.yaml @@ -0,0 +1,46 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..b47ae9be --- /dev/null +++ b/rh-developer/skills/helm-deploy/catalog-info.yaml @@ -0,0 +1,45 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..798c5cd7 --- /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/ai5-marketplace + disciplines: + - debugging + categories: + - debugging + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-developer/rh-developer + - 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 + - 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/recommend-image/catalog-info.yaml b/rh-developer/skills/recommend-image/catalog-info.yaml new file mode 100644 index 00000000..2f275010 --- /dev/null +++ b/rh-developer/skills/recommend-image/catalog-info.yaml @@ -0,0 +1,46 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..c792b32f --- /dev/null +++ b/rh-developer/skills/rhel-deploy/catalog-info.yaml @@ -0,0 +1,45 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..a8abc92b --- /dev/null +++ b/rh-developer/skills/s2i-build/catalog-info.yaml @@ -0,0 +1,46 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-developer/containerize-deploy 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..d22a590d --- /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/ai5-marketplace + 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..4c901f2e --- /dev/null +++ b/rh-sre/catalog-info.yaml @@ -0,0 +1,31 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..6c4d95fd --- /dev/null +++ b/rh-sre/rh-sre-plugin.yaml @@ -0,0 +1,59 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - sre + - security + categories: + - monitoring + - vulnerability-management + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-sre/cve-impact + - airesource:rh-sre/cve-validation + - airesource:rh-sre/execution-summary + - airesource:rh-sre/fleet-inventory + - airesource:rh-sre/job-template-creator + - airesource:rh-sre/job-template-remediation-validator + - airesource:rh-sre/mcp-aap-validator + - airesource:rh-sre/mcp-lightspeed-validator + - airesource:rh-sre/playbook-executor + - airesource:rh-sre/playbook-generator + - airesource:rh-sre/remediation-verifier + - airesource:rh-sre/remediation + - airesource:rh-sre/system-context 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..3685a90b --- /dev/null +++ b/rh-sre/skills/cve-impact/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation 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..d8f6e3fe --- /dev/null +++ b/rh-sre/skills/cve-validation/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation 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..51bc232c --- /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/ai5-marketplace + 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..883ca506 --- /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/ai5-marketplace + 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..9a5fea2a --- /dev/null +++ b/rh-sre/skills/job-template-creator/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/playbook-executor 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..f856b19b --- /dev/null +++ b/rh-sre/skills/job-template-remediation-validator/catalog-info.yaml @@ -0,0 +1,42 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/playbook-executor 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..fa709d77 --- /dev/null +++ b/rh-sre/skills/mcp-aap-validator/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/playbook-executor + - airesource:rh-sre/remediation 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..5a7317ff --- /dev/null +++ b/rh-sre/skills/mcp-lightspeed-validator/catalog-info.yaml @@ -0,0 +1,42 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation 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..314d7b4f --- /dev/null +++ b/rh-sre/skills/playbook-executor/catalog-info.yaml @@ -0,0 +1,46 @@ +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/ai5-marketplace + disciplines: + - automation + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - airesource:rh-sre/mcp-aap-validator + - airesource:rh-sre/job-template-remediation-validator + - airesource:rh-sre/job-template-creator + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform + dependencyOf: + - airesource:rh-sre/remediation 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..7ceb4ead --- /dev/null +++ b/rh-sre/skills/playbook-generator/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation 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..318b8aa3 --- /dev/null +++ b/rh-sre/skills/remediation-verifier/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation diff --git a/rh-sre/skills/remediation/catalog-info.yaml b/rh-sre/skills/remediation/catalog-info.yaml new file mode 100644 index 00000000..fcfc0ed0 --- /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/ai5-marketplace + disciplines: + - security + categories: + - remediation + agents: + - claude-code + - opencode + - cursor + dependsOn: + - airesource:rh-sre/rh-sre + - 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 + - mcpserver:redhat/red-hat-lightspeed-mcp-server + - mcpserver:agentic-plugins/ansible-automation-platform 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..0e7d8f36 --- /dev/null +++ b/rh-sre/skills/system-context/catalog-info.yaml @@ -0,0 +1,43 @@ +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/ai5-marketplace + 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 + dependencyOf: + - airesource:rh-sre/remediation diff --git a/rh-virt/catalog-info.yaml b/rh-virt/catalog-info.yaml new file mode 100644 index 00000000..b68feecb --- /dev/null +++ b/rh-virt/catalog-info.yaml @@ -0,0 +1,28 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 +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..37d94bd7 --- /dev/null +++ b/rh-virt/rh-virt-plugin.yaml @@ -0,0 +1,53 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + 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 + links: + - url: https://github.com/RHEcosystemAppEng/agentic-plugins + title: Source Repository + icon: github +spec: + type: plugin + lifecycle: production + owner: group:redhat/ai5-marketplace + system: default/agentic-plugins + disciplines: + - platform-engineering + categories: + - virtualization + - vm-lifecycle + agents: + - claude-code + - opencode + - cursor + dependsOn: + - system:default/agentic-plugins + - mcpserver:agentic-plugins/openshift-mcp-server + dependencyOf: + - airesource:rh-virt/vm-clone + - airesource:rh-virt/vm-create + - airesource:rh-virt/vm-delete + - airesource:rh-virt/vm-inventory + - airesource:rh-virt/vm-lifecycle-manager + - airesource:rh-virt/vm-rebalance + - airesource:rh-virt/vm-snapshot-create + - airesource:rh-virt/vm-snapshot-delete + - airesource:rh-virt/vm-snapshot-list + - airesource:rh-virt/vm-snapshot-restore 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..df33970d --- /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/ai5-marketplace + 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..014d0fe6 --- /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/ai5-marketplace + 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..5fc4cb1c --- /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/ai5-marketplace + 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..220202b6 --- /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/ai5-marketplace + 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..d031eaf3 --- /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/ai5-marketplace + 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..f01504b8 --- /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/ai5-marketplace + 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..6838dd51 --- /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/ai5-marketplace + 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..af4fc653 --- /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/ai5-marketplace + 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..adfc8377 --- /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/ai5-marketplace + 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..a56bab06 --- /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/ai5-marketplace + 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..a8909f96 --- /dev/null +++ b/system.yaml @@ -0,0 +1,36 @@ +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-plugins.redhat.com/version: "1.0" + agentic-plugins.redhat.com/repo: "agentic-plugins" + agentic.redhat.com/repository: https://github.com/RHEcosystemAppEng/agentic-plugins + github.com/project-slug: RHEcosystemAppEng/agentic-plugins + +spec: + owner: group:redhat/ai5-marketplace + dependencyOf: + - airesource:ocp-admin/ocp-admin + - airesource:rh-sre/rh-sre + - airesource:rh-virt/rh-virt + - airesource:rh-developer/rh-developer + - airesource:rh-basic/rh-basic + - airesource:rh-ai-engineer/rh-ai-engineer + - airesource:rh-automation/rh-automation + - mcpserver:agentic-plugins/ai-observability + - mcpserver:agentic-plugins/ansible-automation-platform + - mcpserver:agentic-plugins/assisted-installer + - mcpserver:agentic-plugins/github + - mcpserver:agentic-plugins/openshift-mcp-server + - mcpserver:agentic-plugins/podman + - mcpserver:agentic-plugins/rhoai