New: 98,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 Symptoms

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

List, search, and inspect Sippy Symptoms and Labels — known CI failure signatures — via the public Sippy API

Apache-2.0Auto-check passedTesting & QA

Install List Symptoms

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

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

GitHub CLI
$ gh skill install openshift-eng/ai-helpers list-symptoms --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/ci/skills/list-symptoms .claude/skills/list-symptoms && 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-symptoms
GitHub stars
120
Token cost
~1.8k tokens
SKILL.md length
595 words
Files
3
Skills in repo
118
Repo updated
First seen
Licence
Apache-2.0

At a glance

List, search, and inspect Sippy Symptoms and Labels — known CI failure signatures — via the public Sippy API

  • Works in 2 steps: Network Access: The Sippy API must be… → Python 3: Python 3.6 or later
  • Tasks that involve Failing and flaky tests
  • SKILL.md covers When to Use This Skill, Prerequisites, Implementation Steps and API Details, plus 4 more sections
  • Runs Python scripts from its folder; calls python3 and curl; reaches sippy.dptools.openshift.org

What it does

List Symptoms is an agent skill from openshift-eng/ai-helpers. List, search, and inspect Sippy Symptoms and Labels — known CI failure signatures — via the public Sippy API

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `list_symptoms.py` and `test_list_symptoms.py`).

It sits in Testing & QA, covering Failing and flaky tests. It works with Python. The repository describes itself as: Developer productivity tools for Claude Code & other AI assistants. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Failing and flaky tests

Example prompts

  • “/list-symptoms”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Network Access: The Sippy API must be accessible at https://sippy.dptools.openshift.org
  2. Python 3: Python 3.6 or later

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
    • curl

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • sippy.dptools.openshift.org

    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 Symptoms loads about 1.8k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 595 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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). 595 words, ~1,820 tokens.

Download SKILL.mdSave it as .claude/skills/list-symptoms/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
list-symptoms
description
List, search, and inspect Sippy Symptoms and Labels — known CI failure signatures — via the public Sippy API

List Symptoms

Sippy Symptoms are known-failure signatures for OpenShift CI. A symptom is a rule made of a file pattern (a glob over a CI job run's artifact files, e.g. **/build-log.txt) and a matcher (string = substring, regex = regular expression, none = file merely exists, cel = a compound CEL expression over other label names). When a symptom matches a job run's artifacts, Sippy applies one or more Labels — human-readable tags like InfraFailure — to that run. Labels appear in the Sippy UI and Spyglass and help everyone quickly recognize known failure modes without re-debugging them. You do not need any prior Sippy knowledge to use this skill.

This skill lists, searches, and fetches symptoms and labels using the public (read-only, no auth) Sippy API.

When to Use This Skill

Use this skill when you need to:

  • Browse the catalog of known CI failure signatures (symptoms)
  • Check whether a failure pattern already has a symptom before creating a new one (avoid duplicates)
  • Look up what a label like InfraFailure means, including its title, explanation, and associated Jira issues
  • Find which symptoms apply a given label
  • Inspect a single symptom or label by its ID

Prerequisites

  1. Network Access: The Sippy API must be accessible at https://sippy.dptools.openshift.org

    • No authentication required
    • Check: curl -s https://sippy.dptools.openshift.org/api/jobs/labels | head -c 200

  2. Python 3: Python 3.6 or later

    • Check: python3 --version
    • Uses only standard library (no external dependencies)

Implementation Steps

Invoke the script with the flags that match the user's question:

bash
script_path="plugins/ci/skills/list-symptoms/list_symptoms.py"

# List all symptoms (JSON by default)
python3 "$script_path"

# List all symptoms as a human-readable summary
python3 "$script_path" --format summary

# Search symptoms by text (matches id, summary, and match_string, case-insensitive)
python3 "$script_path" --search "credentials" --format summary

# Find all symptoms that apply a given label
python3 "$script_path" --label InfraFailure --format summary

# Fetch a single symptom by ID
python3 "$script_path" --id AWSCouldNotValidateAccessCredentials

# List all labels instead of symptoms
python3 "$script_path" --labels --format summary

# Fetch a single label by ID
python3 "$script_path" --labels --id InfraFailure

Flags:

  • --id <id>: fetch a single symptom (or label with --labels) by ID
  • --search <text>: case-insensitive text search over id/summary/match_string (for labels: id/label_title/explanation/bugs)
  • --label <label_id>: only symptoms that apply this label ID
  • --matcher-type {string,regex,none,cel}: only symptoms of this matcher type
  • --labels: operate on labels instead of symptoms
  • --format {json,summary}: output format (default json)

API Details

Endpoints
text
GET https://sippy.dptools.openshift.org/api/jobs/symptoms
GET https://sippy.dptools.openshift.org/api/jobs/symptoms/{id}
GET https://sippy.dptools.openshift.org/api/jobs/labels
GET https://sippy.dptools.openshift.org/api/jobs/labels/{id}
Example Symptom JSON
json
{
  "id": "AWSCouldNotValidateAccessCredentials",
  "summary": "AWS could not validate access credentials",
  "matcher_type": "string",
  "file_pattern": "build-log.txt",
  "match_string": "api error AuthFailure: AWS was not able to validate the provided access credentials",
  "label_ids": ["InfraFailure"],
  "created_by": "kenzhang",
  "updated_by": "kenzhang",
  "updated_at": "2026-04-27T16:09:12.660547Z"
}
Symptom Fields
FieldDescription
idImmutable identifier (generated from the summary on create)
summaryShort, unique human-readable description (≤200 chars)
matcher_typeOne of string, regex, none (file exists), cel (expression over label names)
file_patternGlob over the job run's artifact files, e.g. **/build-log.txt (not used for cel)
match_stringSubstring, regular expression, or CEL expression depending on matcher_type
label_idsLabel IDs applied to a run when the symptom matches
created_by, updated_by, updated_atMetadata about who created/last modified the symptom and when
Show full SKILL.md (214 more words)Show less
Label Fields
FieldDescription
idImmutable identifier (≤80 chars)
label_titleUnique human-readable title
explanationMarkdown explanation of what the label means
bugsJira issue keys associated with the label
hide_display_contextsUI contexts where the label is hidden (subset of spyglass, metrics, jaq-options)

Error Handling

Case 1: Not Found (404)
bash
python3 list_symptoms.py --id NoSuchSymptom
# Error: not found: https://sippy.dptools.openshift.org/api/jobs/symptoms/NoSuchSymptom (use list mode to see valid IDs)

Exits 1 and suggests listing symptoms/labels to find valid IDs.

Case 2: Network Error
bash
# Error: failed to connect to Sippy API: [Errno -2] Name or service not known

Exits 1. Check network connectivity to sippy.dptools.openshift.org.

Case 3: Empty Results

Filters that match nothing print [] (JSON) or No results. (summary) and exit 0 — this is not an error.

Exit Codes:

  • 0: Success (including empty results)
  • 1: Error (404, network error, etc.)

Examples

Example 1: List All Symptoms
bash
python3 plugins/ci/skills/list-symptoms/list_symptoms.py --format summary

Expected Output (excerpt):

text
Symptom: AWSCouldNotValidateAccessCredentials
  Summary:      AWS could not validate access credentials
  Matcher:      string
  File pattern: build-log.txt
  Match string: api error AuthFailure: AWS was not able to validate the provided access credentials
  Labels:       InfraFailure
  Updated by:   kenzhang at 2026-04-27T16:09:12.660547Z

Total: 42
Example 2: Search for an Existing Symptom Before Creating One
bash
python3 plugins/ci/skills/list-symptoms/list_symptoms.py --search "credentials" --format summary
Example 3: Symptoms That Apply a Label
bash
python3 plugins/ci/skills/list-symptoms/list_symptoms.py --label InfraFailure --format summary
Example 4: Fetch One Symptom by ID
bash
python3 plugins/ci/skills/list-symptoms/list_symptoms.py --id AWSCouldNotValidateAccessCredentials
Example 5: List All Labels
bash
python3 plugins/ci/skills/list-symptoms/list_symptoms.py --labels --format summary

Notes

  • --search, --label, and --matcher-type filtering is performed client-side: the script fetches the full list and filters locally
  • This skill is read-only; to create, update, or delete symptoms or labels use the manage-symptoms and manage-labels skills
  • No authentication is required — the public Sippy instance serves all read endpoints

See Also

  • Related Skill: manage-symptoms (create/update/delete symptoms)
  • Related Skill: manage-labels (create/update/delete labels)
  • Related Skill: diagnose-job-run-symptoms (explain which symptoms/labels apply to a job run)

© 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 2 other files in plugins/ci/skills/list-symptoms of openshift-eng/ai-helpers.

  • SKILL.md
  • list_symptoms.py
  • test_list_symptoms.py

Open the folder on GitHubat commit a627176

Compare with similar skills

List Symptoms 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 Symptoms compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
List Symptoms this skillopenshift-eng/ai-helpers120—~1.8kAutomated safety check: PassApache-2.0
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
CI Failure Analysisvortex-data/vortex3.2k—~810Automated safety check: PassApache-2.0
RustPython Test Failure InvestigationRustPython/RustPython22k—~467Automated safety check: PassMIT
ONNX Runtime Test Runnermicrosoft/onnxruntime22k—~1.8kAutomated safety check: PassMIT
Rota Check Periodic Jobsoracle/graalpython1.7k—~792Automated safety check: PassCustom licence

Similar skills

  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated yesterday
    Testing & QAAuto-check passed

  • CI Failure Analysis

    vortex-data/vortex

    Analyze Vortex GitHub Actions CI failures. An agent skill from vortex-data/vortex.

    3.2k GitHub stars~810 tokensUpdated today
    Testing & QAAuto-check passed

  • RustPython Test Failure Investigation

    RustPython/RustPython

    Investigates a failing RustPython test by comparing it with CPython, then either fixes it or gathers the details for an incompatibility report.

    22k GitHub stars~467 tokensUpdated yesterday
    Testing & QAAuto-check passed

  • ONNX Runtime Test Runner

    microsoft/onnxruntime

    Official

    Runs and debugs ONNX Runtime tests: Google Test executables for C++ and unittest or pytest for Python, with filters and build-directory guidance.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed

  • Rota Check Periodic Jobs

    oracle/graalpython

    Official

    Analyze current GraalPy periodic job failures for ROTA. An agent skill from oracle/graalpython.

    1.7k GitHub stars~792 tokensUpdated yesterday
    Testing & QAAuto-check passed

  • ONNX Runtime GPU Transformers Tests

    microsoft/onnxruntime

    Official

    Runs the ONNX Runtime transformers Python tests against a GPU wheel and proves the cuDNN flash attention path was used rather than a silent fallback.

    22k GitHub stars~2.9k tokensUpdated today
    Testing & QAAuto-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 3 days ago
    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 3 days ago
    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 3 days ago
    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 3 days ago
    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 3 days ago
    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 3 days ago
    Auto-check passed

Works with

Categories

Questions about List Symptoms

What does List Symptoms do?

List, search, and inspect Sippy Symptoms and Labels — known CI failure signatures — via the public Sippy API. List Symptoms is an agent skill from openshift-eng/ai-helpers.

When should I use List Symptoms?

List Symptoms fits situations like: tasks that involve Failing and flaky tests.

How do I install List Symptoms in Claude Code?

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

How do I install List Symptoms in Codex?

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

Can I use List Symptoms 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-symptoms -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-symptoms, .gemini/skills/list-symptoms, .github/skills/list-symptoms and .opencode/skills/list-symptoms in your project.

What does List Symptoms need to run?

Going by SKILL.md and its folder, List Symptoms needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and curl). Our summary lists: Python 3.

Does List Symptoms access the network?

SKILL.md names 1 domain. In commands or code: sippy.dptools.openshift.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is List Symptoms safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does List Symptoms use?

List Symptoms 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 Symptoms use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Symptoms?

Skills that share tags, products or a category with List Symptoms: Apple Container Test Runner (RustPython/RustPython, 22k stars), CI Failure Analysis (vortex-data/vortex, 3.2k stars), RustPython Test Failure Investigation (RustPython/RustPython, 22k stars) and ONNX Runtime Test Runner (microsoft/onnxruntime, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains List Symptoms?

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.