AI Helpers

A collection of Claude Code plugins to automate and assist with various development tasks.

Discover available plugins

Installation

From the Claude Code Plugin Marketplace

1. Add the marketplace:

   /plugin marketplace add openshift-eng/ai-helpers

2. Install a plugin:

   /plugin install jira@ai-helpers

3. Use the commands:

   /jira:solve OCPBUGS-12345 origin

Updating Plugins

To get the latest plugin versions:

1. Update the marketplace (fetches latest plugin catalog):

   /plugin marketplace update ai-helpers

2. Reinstall the plugin (downloads new version):

   /plugin install <plugin>@ai-helpers

Automatic Catalog Sync

Add a SessionStart hook to automatically sync the marketplace catalog on each session. In your project's .claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "command": "claude plugin marketplace update ai-helpers",
        "timeout": 30000
      }
    ]
  }
}

Note: This only refreshes the catalog (what's available). To actually update an installed plugin to a newer version, you still need to reinstall it with /plugin install <plugin>@ai-helpers.

Other Tools

Coding agents like OpenCode, Gemini, Cursor and more can consume Claude Code
plugins using the Agent Package Manager (APM).

Example apm.yml:

name: my-project
version: 1.0.0
description: My project is great. 
target: [claude, cursor, gemini, opencode]

dependencies:
  - openshift-eng/ai-helpers/plugins/bigquery-cost-analysis

Then run apm install. It can install to your project only, or with a --global scope.

Using the Container

A container is available with Claude Code and all plugins pre-installed. This is primarily for use in OpenShift CI.

The image includes two Claude Code binaries:

• claude (default entrypoint) — installed from the stable RPM channel
• claude-latest — installed from the latest RPM channel, for trying newer features or comparing behavior between versions

Building the Container

podman build -f images/Dockerfile -t ai-helpers .

Running with Vertex AI and gcloud Authentication

To use Claude Code with Google Cloud's Vertex AI, you need to pass through your gcloud credentials and set the required environment variables:

podman run -it \
  -e CLAUDE_CODE_USE_VERTEX=1 \
  -e CLOUD_ML_REGION=your-ml-region \
  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
  -v $(pwd):/workspace \
  -w /workspace \
  ai-helpers

Environment Variables:

• CLAUDE_CODE_USE_VERTEX=1 - Enable Vertex AI integration
• CLOUD_ML_REGION - Your GCP region (e.g., us-east5)
• ANTHROPIC_VERTEX_PROJECT_ID - Your GCP project ID

Volume Mounts:

• -v ~/.config/gcloud:/home/claude/.config/gcloud:ro - Passes through your gcloud authentication (read-only)
• -v $(pwd):/workspace - Mounts your current directory into the container

Running Commands Non-Interactively

You can execute Claude Code commands directly without entering an interactive session using the -p or --print flag:

podman run -it \
  -e CLAUDE_CODE_USE_VERTEX=1 \
  -e CLOUD_ML_REGION=your-ml-region \
  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
  -v $(pwd):/workspace \
  -w /workspace \
  ai-helpers \
  --print "/hello-world:echo Hello from Claude Code!"

This will:

1. Start the container with your gcloud credentials
2. Execute the /hello-world:echo command with the provided message
3. Print the response and exit when complete

Available Plugins

For a complete list of all available plugins and commands, see the AI Helpers Marketplace.

Plugin Development

Want to contribute or create your own plugins? Check out the plugins/ directory for examples.
Make sure your commands and agents follow the conventions for the Sections structure presented in the hello-world reference implementation plugin (see hello-world:echo for an example).

Ethical Guidelines

Plugins, commands, skills, and hooks must NEVER reference real people by name, even as stylistic examples (e.g., "in the style of ").

Ethical rationale:

1. Consent: Individuals have not consented to have their identity or persona used in AI-generated content
2. Misrepresentation: AI cannot accurately replicate a person's unique voice, style, or intent
3. Intellectual Property: A person's distinctive style may be protected
4. Dignity: Using someone's identity without permission diminishes their autonomy

Instead, describe specific qualities explicitly

Good examples:

• "Write commit messages that are direct, technically precise, and focused on the rationale behind changes"
• "Explain using clear analogies, a sense of wonder, and accessible language for non-experts"
• "Code review comments that are encouraging, constructive, and focus on collaborative improvement"

When you identify a desirable characteristic (clarity, brevity, formality, humor, etc.), describe it explicitly rather than using a person as proxy.

Adding New Commands

Check for overlaps first - Before coding, validate your idea:

/utils:review-ai-helpers-overlap --idea "brief description of your command"

Collaborating on existing work instead of duplicating parallel efforts is always encouraged when overlap is found. This helps maintain a clean, non-redundant plugin collection in such an actively developed project (see /utils:review-ai-helpers-overlap for detailed usage).

When contributing new commands:

1. If your command fits an existing plugin: Add it to the appropriate plugin's commands/ directory
2. If your command doesn't have a clear parent plugin: Add it to the utils plugin (plugins/utils/commands/)
   • The utils plugin serves as a catch-all for commands that don't fit existing categories
   • Once we accumulate several related commands in utils, they can be segregated into a new targeted plugin

Creating a New Plugin

If you're contributing several related commands that warrant their own plugin:

1. Create a new directory under plugins/ with your plugin name
2. Create the plugin structure:

   plugins/your-plugin/
   ├── .claude-plugin/
   │   └── plugin.json
   └── commands/
       └── your-command.md
   

3. Register your plugin in .claude-plugin/marketplace.json

Validating Plugins

This repository uses skillsaw to validate plugin structure:

make lint

Previewing the Marketplace Site

Install the dependencies from site/requirements.txt, then run:

make site-serve

The MkDocs site is available at http://127.0.0.1:8000/ai-helpers/. GitHub
Pages builds the same generated content after changes merge to main.

Additional Documentation

• AI Helpers Marketplace - Complete list of all available plugins and commands
• CONTRIBUTING.md - Guidelines for contributing plugins, including versioning policy
• AGENTS.md - Complete guide for AI agents working with this repository
• CLAUDE.md - Claude-specific configuration and notes

License

See LICENSE for details.

{
  "name": "ai-helpers",
  "owner": {
    "name": "openshift-eng"
  },
  "plugins": [
    {
      "name": "gopls-lsp",
      "source": {
        "source": "github",
        "repo": "anthropics/claude-plugins-official",
        "path": "plugins/gopls-lsp"
      },
      "description": "Go language server for code intelligence and refactoring",
      "version": "1.0.0",
      "category": "development",
      "keywords": [
        "go",
        "gopls",
        "lsp"
      ]
    },
    {
      "name": "prodsec-skills",
      "source": {
        "source": "github",
        "repo": "RedHatProductSecurity/prodsec-skills"
      },
      "description": "Security guidance skills for AI coding assistants",
      "version": "1.0.0",
      "category": "security",
      "keywords": [
        "security",
        "prodsec"
      ]
    },
    {
      "name": "patternfly",
      "source": {
        "source": "github",
        "repo": "rh-uxd/ai-helpers",
        "path": "plugins/patternfly"
      },
      "description": "PatternFly development tools from the UXD team — component scaffolding, design guidance, auditing, migration, test generation, and an MCP server.",
      "category": "development",
      "keywords": [
        "patternfly",
        "uxd",
        "react",
        "design",
        "mcp"
      ]
    },
    {
      "name": "git",
      "source": "./plugins/git",
      "description": "Git Plugin",
      "version": "0.0.7",
      "category": "tooling",
      "keywords": [
        "git",
        "workflow",
        "automation"
      ]
    },
    {
      "name": "github",
      "source": "./plugins/github",
      "description": "GitHub utilities for image uploads, asset management, and PR automation",
      "version": "0.3.0",
      "category": "tooling",
      "keywords": [
        "github",
        "screenshots",
        "images",
        "uploads"
      ]
    },
    {
      "name": "hello-world",
      "source": "./plugins/hello-world",
      "description": "Hello World Plugin",
      "version": "1.0.3",
      "category": "tooling",
      "keywords": [
        "example",
        "template",
        "hello-world"
      ]
    },
    {
      "name": "jira",
      "source": "./plugins/jira",
      "description": "A plugin to automate tasks with Jira",
      "version": "0.9.5",
      "category": "productivity",
      "keywords": [
        "jira",
        "tickets",
        "issues",
        "project-management"
      ]
    },
    {
      "name": "ci",
      "source": "./plugins/ci",
      "description": "A plugin to work with OpenShift CI and analyze Prow job results",
      "version": "0.0.103",
      "category": "ci",
      "keywords": [
        "prow",
        "ci",
        "openshift-ci",
        "test-failures",
        "job-analysis"
      ]
    },
    {
      "name": "ci-extras",
      "source": "./plugins/ci-extras",
      "description": "MCP server and extended tooling for OpenShift CI data access",
      "version": "0.1.0",
      "category": "ci",
      "keywords": [
        "openshift-ci",
        "mcp",
        "ci",
        "sippy",
        "prow",
        "test-failures"
      ]
    },
    {
      "name": "teams",
      "source": "./plugins/teams",
      "description": "Team structure knowledge and health analysis commands for OpenShift teams",
      "version": "0.0.17",
      "category": "productivity",
      "keywords": [
        "teams",
        "health",
        "org-structure"
      ]
    },
    {
      "name": "snowflake",
      "source": "./plugins/snowflake",
      "description": "Snowflake data analysis commands for engineering metrics and reports",
      "version": "0.5.1",
      "category": "data",
      "keywords": [
        "snowflake",
        "sql",
        "metrics",
        "reporting"
      ]
    },
    {
      "name": "sosreport",
      "source": "./plugins/sosreport",
      "description": "Analyze sosreport archives for system diagnostics and troubleshooting",
      "version": "0.0.2",
      "category": "debugging",
      "keywords": [
        "sosreport",
        "diagnostics",
        "troubleshooting",
        "rhel"
      ]
    },
    {
      "name": "utils",
      "source": "./plugins/utils",
      "description": "A generic utilities plugin serving as a catch-all for various helper commands",
      "version": "0.0.13",
      "category": "tooling",
      "keywords": [
        "utilities",
        "helpers",
        "misc"
      ]
    },
    {
      "name": "olm",
      "source": "./plugins/olm",
      "description": "OLM (Operator Lifecycle Manager) plugin for operator management and debugging",
      "version": "0.1.3",
      "category": "openshift",
      "keywords": [
        "olm",
        "operators",
        "lifecycle-manager",
        "debugging"
      ]
    },
    {
      "name": "olm-team",
      "source": "./plugins/olm-team",
      "description": "OLM team development utilities and onboarding tools",
      "version": "0.2.1",
      "category": "development",
      "keywords": [
        "olm",
        "onboarding",
        "team-tools"
      ]
    },
    {
      "name": "operator-dashboard",
      "source": "./plugins/ai-operator-dashboard-generator",
      "description": "Generate OpenShift Console operator dashboard: CRD discovery, list/detail components from templates",
      "version": "0.0.1",
      "category": "openshift",
      "keywords": [
        "console",
        "dashboard",
        "operators",
        "crd"
      ]
    },
    {
      "name": "agendas",
      "source": "./plugins/agendas",
      "description": "A plugin to create various meeting agendas",
      "version": "0.0.3",
      "category": "productivity",
      "keywords": [
        "meetings",
        "agendas",
        "planning"
      ]
    },
    {
      "name": "openshift",
      "source": "./plugins/openshift",
      "description": "OpenShift development utilities and helpers",
      "version": "0.0.8",
      "category": "openshift",
      "keywords": [
        "openshift",
        "development",
        "helpers"
      ]
    },
    {
      "name": "openshift-tls-profile",
      "source": "./plugins/openshift-tls-profile",
      "description": "Implementation requirements and details for OpenShift TLS security profiles",
      "version": "0.0.2",
      "category": "openshift",
      "keywords": [
        "tls",
        "security-profiles",
        "crypto"
      ]
    },
    {
      "name": "etcd",
      "source": "./plugins/etcd",
      "description": "Etcd cluster health monitoring and performance analysis utilities",
      "version": "0.0.2",
      "category": "debugging",
      "keywords": [
        "etcd",
        "cluster-health",
        "performance"
      ]
    },
    {
      "name": "must-gather",
      "source": "./plugins/must-gather",
      "description": "A plugin to analyze and report on must-gather data",
      "version": "0.0.3",
      "category": "debugging",
      "keywords": [
        "must-gather",
        "diagnostics",
        "cluster-analysis"
      ]
    },
    {
      "name": "hcp",
      "source": "./plugins/hcp",
      "description": "Generate HyperShift cluster creation commands via hcp CLI from natural language descriptions",
      "version": "0.0.3",
      "category": "openshift",
      "keywords": [
        "hypershift",
        "hosted-control-planes",
        "cluster-creation"
      ]
    },
    {
      "name": "compliance",
      "source": "./plugins/compliance",
      "description": "Security compliance and vulnerability analysis tools for Go projects",
      "version": "0.4.0",
      "category": "security",
      "keywords": [
        "cve",
        "vulnerabilities",
        "compliance",
        "go"
      ]
    },
    {
      "name": "node-tuning",
      "source": "./plugins/node-tuning",
      "description": "Generate and analyze OpenShift node tuning profiles",
      "version": "1.0.1",
      "category": "debugging",
      "keywords": [
        "tuned",
        "node-tuning",
        "performance",
        "profiles"
      ]
    },
    {
      "name": "node",
      "source": "./plugins/node",
      "description": "Kubernetes and OpenShift node health monitoring and diagnostics",
      "version": "0.0.3",
      "category": "debugging",
      "keywords": [
        "nodes",
        "health",
        "kubernetes",
        "diagnostics"
      ]
    },
    {
      "name": "node-cve",
      "source": "./plugins/node-cve",
      "description": "CVE triage for OpenShift Node team components",
      "version": "0.0.7",
      "category": "openshift",
      "keywords": [
        "openshift",
        "cve",
        "vulnerability",
        "triage",
        "node"
      ]
    },
    {
      "name": "node-onboarding",
      "source": "./plugins/node-onboarding",
      "description": "Interactive onboarding workflows for new OpenShift Node team members",
      "version": "0.0.2",
      "category": "openshift",
      "keywords": [
        "openshift",
        "node",
        "onboarding",
        "setup"
      ]
    },
    {
      "name": "node-rpm",
      "source": "./plugins/node-rpm",
      "description": "RPM package management for OpenShift Node team components",
      "version": "0.0.2",
      "category": "openshift",
      "keywords": [
        "openshift",
        "node",
        "rpm",
        "bump",
        "cri-tools"
      ]
    },
    {
      "name": "node-bug",
      "source": "./plugins/node-bug",
      "description": "Node-specific bug triage, sub-team routing, and assignment suggestions for OpenShift Node team components",
      "version": "0.0.2",
      "category": "openshift",
      "keywords": [
        "openshift",
        "node",
        "bugs",
        "triage",
        "jira"
      ]
    },
    {
      "name": "bigquery-cost-analysis",
      "source": "./plugins/bigquery-cost-analysis",
      "description": "BigQuery cost analysis and optimization utilities",
      "version": "0.0.7",
      "category": "data",
      "keywords": [
        "bigquery",
        "sql",
        "cost-analysis",
        "optimization"
      ]
    },
    {
      "name": "bigquery-ci-data",
      "source": "./plugins/bigquery-ci-data",
      "description": "Query and analyze OpenShift CI data in BigQuery across multiple datasets and tables",
      "version": "0.0.1",
      "category": "data",
      "keywords": [
        "bigquery",
        "ci",
        "test-data",
        "autodl",
        "risk-analysis"
      ]
    },
    {
      "name": "workspaces",
      "source": "./plugins/workspaces",
      "description": "Manage isolated git worktree workspaces for multi-repo development",
      "version": "1.0.1",
      "category": "development",
      "keywords": [
        "git",
        "worktree",
        "workspace",
        "multi-repo"
      ]
    },
    {
      "name": "code-review",
      "source": "./plugins/code-review",
      "description": "Automated code quality review with language-aware analysis, pre-commit verification, and multi-specialist deep review",
      "version": "0.0.18",
      "category": "development",
      "keywords": [
        "code-review",
        "quality",
        "pre-commit",
        "linting"
      ]
    },
    {
      "name": "golang",
      "source": "./plugins/golang",
      "description": "Go development tools: gopls MCP server, LSP integration, automatic gofmt formatting, golangci-lint linting, CVE dependency patching, Go stdlib CVE triage, and OCP and OKD release Go builder, module, and Dockerfile inventories",
      "version": "0.7.0",
      "category": "development",
      "keywords": [
        "go",
        "gopls",
        "lsp",
        "linting",
        "formatting"
      ]
    },
    {
      "name": "ote-migration",
      "source": "./plugins/ote-migration",
      "description": "Automate OpenShift Tests Extension (OTE) migration for component repositories",
      "version": "0.0.3",
      "category": "development",
      "keywords": [
        "ote",
        "migration",
        "openshift-tests"
      ]
    },
    {
      "name": "console",
      "source": "./plugins/console",
      "description": "OpenShift Console dynamic plugin development utilities",
      "version": "0.0.2",
      "category": "development",
      "keywords": [
        "console",
        "dynamic-plugins",
        "frontend"
      ]
    },
    {
      "name": "rds-analyzer",
      "source": "./plugins/rds-analyzer",
      "description": "RDS Analyzer workflow: cluster-compare JSON to deviation reports (text/HTML/reporting) and Jira follow-up",
      "version": "0.0.2",
      "category": "debugging",
      "keywords": [
        "rds",
        "cluster-compare",
        "deviation-reports"
      ]
    },
    {
      "name": "ai-sbom",
      "source": "./plugins/ai-sbom",
      "description": "Generate AI Software Bill of Materials (SBOM) declarations for PR descriptions",
      "version": "0.0.1",
      "category": "development",
      "keywords": [
        "sbom",
        "ai-usage",
        "transparency"
      ]
    },
    {
      "name": "marketplace-ops",
      "source": "./plugins/marketplace-ops",
      "description": "Maintenance commands for Claude Code plugin marketplaces",
      "version": "0.1.2",
      "category": "tooling",
      "keywords": [
        "marketplace",
        "plugins",
        "maintenance"
      ]
    },
    {
      "name": "openshift-developer",
      "source": "./plugins/openshift-developer",
      "description": "Bundle of curated plugins, skills, and MCP servers useful to any OpenShift engineer",
      "version": "1.1.31",
      "category": "bundle",
      "keywords": [
        "openshift",
        "bundle",
        "meta-plugin"
      ]
    },
    {
      "name": "node-team",
      "source": "./plugins/node-team",
      "description": "OpenShift Node team assistant for development, deployment, debugging, and workflow tasks",
      "version": "1.0.0",
      "category": "openshift",
      "keywords": [
        "openshift",
        "node",
        "kubelet",
        "cri-o",
        "mco"
      ]
    },
    {
      "name": "prow-agent",
      "source": "./plugins/prow-agent",
      "description": "Utilities for Claude Code sessions running inside Prow CI jobs",
      "version": "0.0.6",
      "category": "ci",
      "keywords": [
        "prow",
        "ci",
        "metrics",
        "bigquery"
      ]
    },
    {
      "name": "agentic-docs",
      "source": "./plugins/agentic-docs",
      "description": "Create and maintain AI-optimized documentation for OpenShift",
      "version": "2.2.12"
    },
    {
      "name": "metrics",
      "source": "./plugins/metrics",
      "description": "OpenTelemetry and OpenInference telemetry pipeline for Claude Code sessions: documentation effectiveness, agent performance, tool usage, and cost metrics",
      "version": "0.3.0",
      "category": "tooling",
      "keywords": [
        "opentelemetry",
        "otel",
        "openinference",
        "metrics",
        "tracing",
        "documentation-effectiveness",
        "mlflow",
        "observability"
      ]
    },
    {
      "name": "nid-team",
      "source": "./plugins/nid-team",
      "description": "Development and workflow tools for the Network Ingress & DNS team",
      "version": "0.1.3",
      "category": "development",
      "keywords": [
        "nid",
        "ingress",
        "dns",
        "pr-triage",
        "team-tools"
      ]
    }
  ]
}