github-actions-runs

Trigger, watch, list, cancel, and download GitHub Actions runs via CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/asimihsan/dotfiles --skill github-actions-runs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-actions-runs
Source: https://github.com/asimihsan/dotfiles/tree/main/chezmoi/dot_claude/skills/github-actions-runs
Command: npx skills add https://github.com/asimihsan/dotfiles --skill github-actions-runs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides tooling to trigger, watch, and fetch logs and artifacts from GitHub Actions runs using the asim-utilities Python library.

Core Features & Use Cases

  • Trigger & watch workflows: Dispatch and monitor runs, cancel on failures if needed.
  • List failures and runs: Retrieve recent runs and pinpoint failures quickly.
  • Download logs/artifacts: Retrieve outputs for auditing and debugging.

Quick Start

gh-actions-runs trigger --workflow CI --ref main --wait gh-actions-runs watch --workflow CI --ref main gh-actions-runs list --limit 20

Frequently Asked Questions about github-actions-runs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub Actions workflow runs and monitor their progress?

Automate GitHub Actions runs using the gh-actions-runs CLI to trigger workflows, watch execution in real-time, and cancel on failures. Dispatch workflows with `gh-actions-runs trigger --workflow CI --ref main --wait` and monitor active runs with the watch command across local or remote repositories.

Can I download logs and artifacts from GitHub Actions runs programmatically?

Yes, download logs and artifacts from GitHub Actions runs using the gh-actions-runs CLI or Python library. Retrieve outputs for auditing and debugging by specifying the workflow, repository, and output directory with configurable formats (human or JSON).

How do I list recent GitHub Actions failures and identify which runs failed?

List recent GitHub Actions runs and pinpoint failures quickly using `gh-actions-runs list --limit 20` to retrieve run history. Filter and inspect failures to debug CI pipeline issues and determine which workflows need attention.

What authentication does the GitHub Actions CLI require to access runs and artifacts?

Authenticate using GITHUB_TOKEN or GH_TOKEN environment variables. The gh-actions-runs CLI auto-detects your repository or accepts an explicit --repo flag, supporting authentication across local and remote repositories.

Can I output GitHub Actions run data in JSON format for integration with other tools?

Yes, configure output formats with the --format flag to produce human-readable or JSON output. Store results in a specified output directory, enabling integration with downstream analysis, reporting, and CI/CD orchestration tools.