Official agent skill

Watch GitHub Actions

by NVIDIA in NVIDIA/OpenShell

Watch and monitor GitHub Actions workflow runs using the gh CLI.

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install Watch GitHub Actions

skills CLI
$ npx skills add NVIDIA/OpenShell --skill watch-github-actions -a claude-code

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

GitHub CLI
$ gh skill install NVIDIA/OpenShell watch-github-actions --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/NVIDIA/OpenShell.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/watch-github-actions .claude/skills/watch-github-actions && 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
watch-github-actions
GitHub stars
15k
Token cost
~1.8k tokens
SKILL.md length
682 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
Apache-2.0

At a glance

Watch and monitor GitHub Actions workflow runs using the gh CLI.

  • Works in 4 steps: Push your changes and create/update a PR → Watch the workflow run → If a job fails, view the failed logs → …
  • The user wants to check workflow status
  • SKILL.md covers Prerequisites, Quick Status Check, Watch a Run in Real Time and View Run Details, plus 10 more sections
  • Calls gh, git and trivy

What it does

Watch GitHub Actions is an agent skill from NVIDIA/OpenShell, published by the product's own GitHub organization. Watch and monitor GitHub Actions workflow runs using the gh CLI. Use when the user wants to check workflow status, watch a running workflow, view CI/CD jobs, or monitor build progress. Trigger keywords - watch pipeline, pipeline status, CI status, check build, monitor CI, view pipeline, pipeline progress, workflow status, actions status.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering CI/CD. It works with GitHub Actions and gRPC. The repository describes itself as: OpenShell is the safe, private runtime for autonomous AI agents. The licence is Apache-2.0.

When your agent uses it

  • The user wants to check workflow status
  • Watch a running workflow
  • View CI/CD jobs
  • Monitor build progress

Example prompts

  • “/watch-github-actions”

Workflow steps

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

  1. Push your changes and create/update a PR
  2. Watch the workflow run
  3. If a job fails, view the failed logs
  4. Rerun the failed jobs if needed

What it can do on your machine

Read from SKILL.md and the folder at commit 834b79a. 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

    Shell commands in SKILL.md call:

    • gh
    • git
    • trivy
    • nix

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

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    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

Watch GitHub Actions loads about 1.8k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 682 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
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 NVIDIA/OpenShell at commit 834b79a, republished under its Apache-2.0 licence (© NVIDIA). 682 words, ~1,809 tokens.

Download SKILL.mdSave it as .claude/skills/watch-github-actions/SKILL.md (or your agent's skills folder).
name
watch-github-actions
description
Watch and monitor GitHub Actions workflow runs using the gh CLI. Use when the user wants to check workflow status, watch a running workflow, view CI/CD jobs, or monitor build progress. Trigger keywords - watch pipeline, pipeline status, CI status, check build, monitor CI, view pipeline, pipeline progress, workflow status, actions status.
metadata.internal
true

Watch GitHub Actions

Monitor GitHub Actions workflow runs using the gh CLI.

Prerequisites

  • The gh CLI must be authenticated (gh auth status)
  • You must be in a git repository with a GitHub remote

Quick Status Check

List recent workflow runs for the current branch:

bash
gh run list --branch "$(git branch --show-current)"

List all recent runs:

bash
gh run list

Watch a Run in Real Time

Watch a workflow run until it completes:

bash
gh run watch

Watch a specific run:

bash
gh run watch <run-id>

This will continuously update the status until the run finishes (success, failure, or cancelled).

View Run Details

View a specific run with job details:

bash
gh run view <run-id>

View with full log output:

bash
gh run view <run-id> --log

View a failed job's log:

bash
gh run view <run-id> --log-failed

Check Runs for a Specific Branch

Current branch:

bash
gh run list --branch "$(git branch --show-current)"

Specific branch:

bash
gh run list --branch main
gh run list --branch feature-branch

Check Runs for a PR

List workflow runs associated with a PR:

bash
# Get the head branch of the PR, then list runs
BRANCH=$(gh pr view <pr-number> --json headRefName --jq '.headRefName')
gh run list --branch "$BRANCH"

Or view the checks directly on the PR:

bash
gh pr checks <pr-number>

List Recent Runs

List runs for the current project:

bash
gh run list

Filter by status:

bash
gh run list --status failure
gh run list --status success
gh run list --status in_progress

Filter by workflow:

bash
gh run list --workflow "CI"

JSON output for scripting:

bash
gh run list --json databaseId,status,headBranch,url --jq '.[] | {id: .databaseId, status: .status, branch: .headBranch, url: .url}'

View Job Logs

setup-nix retries development-shell preparation once when prepare-shell is enabled. Inspect both attempts in the job log; setup-rust assumes the shell has already been prepared. Cargo, lint, and test commands are not retried. Direct Nix builds and app dependency preparation also retry once; apps run once after preparation succeeds. Skipped dependent E2E suites indicate blocked coverage.

For Trivy Changes, inspect the Resolve PR baseline step for the base and head SHAs. PR runs compare the tested merge commit with its first parent; change detection and scans must use the same pair. On reruns, do not substitute the current main tip or the event's older PR base SHA. Merge groups and manual runs use their explicit baseline. Findings are reported by Reject new high or critical findings; distinguish those from scanner failures.

For Protobuf Compatibility, check the logged train and comparison baseline. Branch Checks compares the prospective merge tree with its target; Release Tag compares the tagged candidate with the previous stable release. Both use the shared check-protobuf-compatibility action with nix run .#check-protobuf-compatibility -- <ref>. During 0.x, a minor train permits compatibility findings as warnings; a patch train or no active train rejects them. Compare the current train's version with the latest stable release; commit messages are irrelevant. Compilation, baseline, and tool errors remain fatal. The protobuf_compatibility suite participates in the release-tag-v1 qualification profile. Both tagged pre-release and stable publication require this profile to pass. Failed, cancelled, or skipped suites block publication; build artifacts and qualification evidence remain in Actions storage for diagnosis. Source-SHA images are staging inputs for qualification. Snap builds run in parallel with qualification, but tagged stable Store uploads consume those built artifacts only after qualification passes.

View logs for a specific run:

bash
gh run view <run-id> --log

View only failed job logs:

bash
gh run view <run-id> --log-failed
Show full SKILL.md (259 more words)Show less

Wait for Run Completion (Scripting)

Watch and wait for a run to complete:

bash
RUN_ID=$(gh run list --branch "$(git branch --show-current)" --limit 1 --json databaseId --jq '.[0].databaseId')
gh run watch "$RUN_ID" --exit-status
echo "Run finished with exit code: $?"

Open Run in Browser

Open the latest run in your default browser:

bash
gh run view --web

Open a specific run:

bash
gh run view <run-id> --web

Rerun Failed Jobs

Rerun all failed jobs in a run:

bash
gh run rerun <run-id> --failed

Rerun an entire run:

bash
gh run rerun <run-id>

Useful Commands Reference

CommandDescription
gh run listList recent workflow runs
gh run list --branch <branch>List runs for a specific branch
gh run list --status failureList failed runs
gh run watchWatch latest run until completion
gh run watch <run-id>Watch a specific run until completion
gh run view <run-id>View run details and job list
gh run view <run-id> --logView full run logs
gh run view <run-id> --log-failedView only failed job logs
gh run view --webOpen run in browser
gh run rerun <run-id>Rerun a workflow run
gh run rerun <run-id> --failedRerun only failed jobs
gh run cancel <run-id>Cancel a running workflow
gh pr checks <pr-number>View PR check statuses

Common Flags

FlagDescription
-b, --branchSpecify branch (default: current branch)
--statusFilter by status (queued, in_progress, etc.)
--workflowFilter by workflow name
-L, --limitMaximum number of runs to list
-w, --webOpen in browser
--jsonOutput as JSON with specified fields
--jqFilter JSON output with jq expression

Example Workflow

  1. Push your changes and create/update a PR
  2. Watch the workflow run:
    bash
    gh run watch
  3. If a job fails, view the failed logs:
    bash
    gh run view <run-id> --log-failed
  4. Rerun the failed jobs if needed:
    bash
    gh run rerun <run-id> --failed

© NVIDIA, 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

Just SKILL.md in .agents/skills/watch-github-actions of NVIDIA/OpenShell.

Open the folder on GitHubat commit 834b79a

Compare with similar skills

Watch GitHub Actions 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.

Watch GitHub Actions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Watch GitHub Actions this skillNVIDIA/OpenShell15k—~1.8kAutomated safety check: PassApache-2.0
Compileapache/skywalking-nodejs180—~1.3kAutomated safety check: PassApache-2.0
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence
GitHub Actions Templatesbartstc/vite-ts-react-template12213 repos~1.9kAutomated safety check: PassMIT
Nushellccusage/ccusage19k—~938Automated safety check: PassCustom licence
Repo Hygiene Scan and FixQwenLM/qwen-code28k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Compile

    apache/skywalking-nodejs

    Compile / build / type-check the skywalking-nodejs agent. An agent skill from apache/skywalking-nodejs.

    180 GitHub stars~1.3k tokensUpdated 21 days ago
    Backend & APIsAuto-check passed
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • GitHub Actions Templates

    bartstc/vite-ts-react-template

    Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications.

    122 GitHub starsUsed in 13 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Nushell

    ccusage/ccusage

    Guides ccusage Nushell scripts. An agent skill from ccusage/ccusage.

    19k GitHub stars~938 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Scheduled CI skill that scans a repository for small, certain docs, test and code hygiene issues and fixes them on one branch with a commit per finding.

    28k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    259 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

More from NVIDIA/OpenShell

All 23 skills in this repo
  • Official

    Maintain and validate OpenShell's build-only Windows MSVC lane for x64 and ARM64.

    15k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Create GitHub Issue

    NVIDIA/OpenShell

    Official

    Create GitHub issues using the gh CLI. An agent skill from NVIDIA/OpenShell.

    15k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Create GitHub PR

    NVIDIA/OpenShell

    Official

    Create GitHub pull requests using the gh CLI. An agent skill from NVIDIA/OpenShell.

    15k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Debug Inference

    NVIDIA/OpenShell

    Official

    Debug inference clients that use an attached provider and its native endpoint, including hosted APIs and host-local Ollama, vLLM, SGLang, TRT-LLM, LM Studio, or NIM.

    15k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Debug Openshell Cluster

    NVIDIA/OpenShell

    Official

    Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.

    15k GitHub stars~19k tokensUpdated today
    Auto-check: notes
  • Gator Gate

    NVIDIA/OpenShell

    Official

    Validate and monitor OpenShell GitHub issues and PRs using the gator: state machine.

    15k GitHub stars~19k tokensUpdated today
    Auto-check passed

Categories

Questions about Watch GitHub Actions

What does Watch GitHub Actions do?

Watch and monitor GitHub Actions workflow runs using the gh CLI. Watch GitHub Actions is an agent skill from NVIDIA/OpenShell, published by the product's own GitHub organization. Watch and monitor GitHub Actions workflow runs using the gh CLI.

When should I use Watch GitHub Actions?

Watch GitHub Actions fits situations like: the user wants to check workflow status; watch a running workflow; view CI/CD jobs; monitor build progress.

How do I install Watch GitHub Actions in Claude Code?

Run `npx skills add NVIDIA/OpenShell --skill watch-github-actions -a claude-code`. Or copy the skill folder (.agents/skills/watch-github-actions in NVIDIA/OpenShell) into .claude/skills/watch-github-actions in your project. Claude Code loads it when a task matches its description.

How do I install Watch GitHub Actions in Codex?

Run `npx skills add NVIDIA/OpenShell --skill watch-github-actions -a codex`. Or copy the skill folder (.agents/skills/watch-github-actions in NVIDIA/OpenShell) into .agents/skills/watch-github-actions in your project. Codex loads it when a task matches its description.

Can I use Watch GitHub Actions 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 NVIDIA/OpenShell --skill watch-github-actions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/watch-github-actions, .gemini/skills/watch-github-actions, .github/skills/watch-github-actions and .opencode/skills/watch-github-actions in your project.

What does Watch GitHub Actions need to run?

Going by SKILL.md and its folder, Watch GitHub Actions needs the command-line tools its instructions call (gh, git, trivy and nix).

Does Watch GitHub Actions access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Watch GitHub Actions 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 Watch GitHub Actions use?

Watch GitHub Actions 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 Watch GitHub Actions use?

About 1.8k tokens (SKILL.md is roughly 7.2k 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 Watch GitHub Actions?

Skills that share tags, products or a category with Watch GitHub Actions: Compile (apache/skywalking-nodejs, 180 stars), Analyze GitHub Action Logs (withastro/astro, 63k stars), GitHub Actions Templates (bartstc/vite-ts-react-template, 122 stars) and Nushell (ccusage/ccusage, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Watch GitHub Actions?

NVIDIA (a GitHub organization, an official publisher) maintains it in NVIDIA/OpenShell, which has 15,188 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

Source: NVIDIA/OpenShell on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.