New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

List Components

by openshift-eng in openshift-eng/ai-helpers

List all OCPBUGS components, optionally filtered by team. An agent skill from openshift-eng/ai-helpers.

Apache-2.0Auto-check: notes

Install List Components

skills CLI
$ npx skills add openshift-eng/ai-helpers --skill list-components -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openshift-eng/ai-helpers list-components --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openshift-eng/ai-helpers.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/teams/skills/list-components .claude/skills/list-components && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
list-components
GitHub stars
120
Token cost
~1.6k tokens
SKILL.md length
555 words
Files
2
Skills in repo
118
Repo updated
First seen
Licence
Apache-2.0

At a glance

List all OCPBUGS components, optionally filtered by team. An agent skill from openshift-eng/ai-helpers.

  • Works in 3 steps: Verify Repository → Run the list-components Script → Process the Output
  • SKILL.md covers When to Use This Skill, Prerequisites, Implementation Steps and Error Handling, plus 5 more sections
  • Runs Python scripts from its folder; calls python3, jq and brew

What it does

List Components is an agent skill from openshift-eng/ai-helpers. List all OCPBUGS components, optionally filtered by team

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `list_components.py`).

It works with Python. The repository describes itself as: Developer productivity tools for Claude Code & other AI assistants. The licence is Apache-2.0.

Example prompts

  • “/list-components”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Verify Repository
  2. Run the list-components Script
  3. Process the Output

What it can do on your machine

Read from SKILL.md and the folder at commit a627176. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • jq
    • brew
    • apt-get
    • yum

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • gitlab.cee.redhat.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

List Components loads about 1.6k tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 555 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:35
    - Linux: `sudo apt-get install jq` or `sudo yum install jq`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openshift-eng/ai-helpers at commit a627176, republished under its Apache-2.0 licence (© openshift-eng). 555 words, ~1,622 tokens.

Download SKILL.mdSave it as .claude/skills/list-components/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
list-components
description
List all OCPBUGS components, optionally filtered by team

List Components

This skill provides functionality to list all OCPBUGS component names from the team component mapping, with optional filtering by team.

When to Use This Skill

Use this skill when you need to:

  • Display all OCPBUGS component names
  • Display OCPBUGS components for a specific team
  • Validate OCPBUGS component names before using them in other commands
  • Get a complete list of OCPBUGS-tracked components
  • Count how many OCPBUGS components are in the system or per team
  • Find component names for filing or querying OCPBUGS issues

Prerequisites

  1. Python 3 Installation

    • Check if installed: which python3
    • Python 3.6 or later is required
    • Comes pre-installed on most systems

  2. jq Installation

    • Check if installed: which jq
    • Required for JSON parsing
    • Usually pre-installed on most systems
    • macOS: brew install jq
    • Linux: sudo apt-get install jq or sudo yum install jq

  3. Team Component Mapping File

    • The mapping file team_component_map.json should be in the repository
    • Located at: plugins/teams/team_component_map.json
    • This file is committed to the repository - no download needed
    • To regenerate: python3 plugins/teams/generate_team_component_map.py

Implementation Steps

Step 1: Verify Repository

Ensure you are in the repository root directory:

bash
# Verify you are in the repository root
pwd
# Expected output: /path/to/ai-helpers
Step 2: Run the list-components Script

List all OCPBUGS components:

bash
python3 plugins/teams/skills/list-components/list_components.py

List OCPBUGS components for a specific team:

bash
python3 plugins/teams/skills/list-components/list_components.py --team "API Server"

Note: Use the exact team name from the list-teams command output.

Step 3: Process the Output

The script outputs JSON with the following structure:

All components:

json
{
  "total_components": 87,
  "components": [
    "Auth",
    "apiserver-auth",
    "config-operator",
    "..."
  ]
}

Components filtered by team:

json
{
  "total_components": 8,
  "components": [
    "apiserver-auth",
    "config-operator",
    "kube-apiserver",
    "kube-controller-manager",
    "kube-storage-version-migrator",
    "openshift-apiserver",
    "openshift-controller-manager / controller-manager",
    "service-ca"
  ],
  "team": "API Server"
}

Field Descriptions:

  • total_components: Total number of OCPBUGS components found
  • components: Alphabetically sorted list of OCPBUGS component names
  • team: (Optional) The team name used for filtering

Error Handling

The script handles several error scenarios:

  1. Mapping file missing:

    Error: Team component mapping file not found at ...
This file should be in the repository. Please check your installation.

    Solution: Verify repository checkout or regenerate with generate_team_component_map.py

  2. Invalid JSON in mapping:

    Error: Failed to parse mapping file. File may be corrupted.

    Solution: Regenerate the mapping file

  3. Team not found:

    Error: Team 'Invalid Team' not found in mapping.
Use list-teams to see available teams.

    Solution: Run list-teams to get correct team name, ensure exact match (case-sensitive)

  4. No OCPBUGS components for team:

    Warning: No OCPBUGS components found for team 'Team Name'.
The team may not have any OCPBUGS components assigned.

    Note: This is a warning, not an error. Some teams may not have OCPBUGS components.

Show full SKILL.md (237 more words)Show less

Output Format

The script outputs JSON to stdout:

  • Success: Exit code 0, JSON with component list
  • Error: Exit code 1, error message to stderr

Examples

Example 1: List All Components
bash
python3 plugins/teams/skills/list-components/list_components.py

Output:

json
{
  "total_components": 87,
  "components": [
    "Auth",
    "apiserver-auth",
    "..."
  ]
}
Example 2: List Components for a Specific Team
bash
python3 plugins/teams/skills/list-components/list_components.py --team "API Server"

Output:

json
{
  "total_components": 8,
  "components": [
    "apiserver-auth",
    "config-operator",
    "kube-apiserver",
    "..."
  ],
  "team": "API Server"
}
Example 3: Count Components
bash
python3 plugins/teams/skills/list-components/list_components.py | jq '.total_components'

Output:

87
Example 4: Search for Specific Component
bash
python3 plugins/teams/skills/list-components/list_components.py | jq '.components[] | select(contains("apiserver"))'

Output:

"apiserver-auth"
"kube-apiserver"
"openshift-apiserver"

Notes

  • Only OCPBUGS components are included in the mapping
  • Team names must match exactly (case-sensitive) - use list-teams to get correct names
  • When filtering by team, only components owned by that team are returned
  • Component names are case-sensitive
  • Components are returned in alphabetical order
  • The script reads from the committed mapping file (no network calls)
  • Very fast execution (< 100ms typically)
  • Mapping file location: plugins/teams/team_component_map.json
  • Component names can be used directly in OCPBUGS JIRA queries and other teams commands
  • Typical count: ~87 total components across 29 teams (may vary as components are added/removed)
  • To refresh mapping: Run python3 plugins/teams/generate_team_component_map.py

Data Source

The team and component mapping data originates from:

If data looks wrong or missing:

  1. Submit a PR to https://gitlab.cee.redhat.com/hybrid-platforms/org to correct the source data
  2. After the PR merges, regenerate the mapping file in this repository:
    python3 plugins/teams/generate_team_component_map.py
  3. Commit the updated team_component_map.json file

See Also

  • Related Skill: plugins/teams/skills/list-teams/SKILL.md
  • Related Command: /teams:list-components
  • Mapping File: plugins/teams/team_component_map.json
  • Generator Script: plugins/teams/generate_team_component_map.py

© openshift-eng, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/teams/skills/list-components of openshift-eng/ai-helpers.

  • SKILL.md
  • list_components.py

Open the folder on GitHubat commit a627176

Compare with similar skills

List Components next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

List Components compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
List Components this skillopenshift-eng/ai-helpers120—~1.6kAutomated safety check: NotesApache-2.0
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k48 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k13 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 48 repos~2k tokens
    Documents & OfficeAuto-check passed

  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 13 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes

  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed

  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    58k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed

More from openshift-eng/ai-helpers

All 118 skills in this repo

  • Investigate CI Reliability

    openshift-eng/ai-helpers

    Find and independently validate actionable reliability defects across OpenShift release jobs and presubmits, then export portable issue handoffs.

    120 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

  • Address Review PR

    openshift-eng/ai-helpers

    Fetch and address all PR review comments — categorize by priority, make code changes, post replies, and push.

    120 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

  • Categorize Activity Types

    openshift-eng/ai-helpers

    Categorize Jira issues into Red Hat Sankey Activity Type categories using MCP Jira tools.

    120 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

  • Has Review Work

    openshift-eng/ai-helpers

    Decide whether a GitHub PR has unanswered authorized review comments or new required CI failures worth a follow-up agent.

    120 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

  • Must Gather Analyzer

    openshift-eng/ai-helpers

    Analyze OpenShift must-gather diagnostic data including cluster operators, pods, nodes, and network components.

    120 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

  • Payload Autodl JSON

    openshift-eng/ai-helpers

    Schema for the autodl JSON data file produced by payload-analysis for database ingestion — you must use this skill whenever generating the autodl JSON file

    120 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about List Components

What does List Components do?

List all OCPBUGS components, optionally filtered by team. An agent skill from openshift-eng/ai-helpers. List Components is an agent skill from openshift-eng/ai-helpers.

How do I install List Components in Claude Code?

Run `npx skills add openshift-eng/ai-helpers --skill list-components -a claude-code`. Or copy the skill folder (plugins/teams/skills/list-components in openshift-eng/ai-helpers) into .claude/skills/list-components in your project. Claude Code loads it when a task matches its description.

How do I install List Components in Codex?

Run `npx skills add openshift-eng/ai-helpers --skill list-components -a codex`. Or copy the skill folder (plugins/teams/skills/list-components in openshift-eng/ai-helpers) into .agents/skills/list-components in your project. Codex loads it when a task matches its description.

Can I use List Components in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openshift-eng/ai-helpers --skill list-components -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/list-components, .gemini/skills/list-components, .github/skills/list-components and .opencode/skills/list-components in your project.

What does List Components need to run?

Going by SKILL.md and its folder, List Components needs Python for the scripts in its folder and the command-line tools its instructions call (python3, jq, brew, apt-get and yum). Our summary lists: Python 3.

Does List Components access the network?

SKILL.md names 1 domain. As links in the text: gitlab.cee.redhat.com. This is read from the text; nothing was executed.

Is List Components safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does List Components use?

List Components is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does List Components use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to List Components?

Skills that share tags, products or a category with List Components: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains List Components?

openshift-eng (a GitHub organization) maintains it in openshift-eng/ai-helpers, which has 120 GitHub stars. The repository holds 118 skills in this directory. The repository was last updated on October 6, 2026.

Source: openshift-eng/ai-helpers on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.