actions
GitHub Actions workflow management using GitHub CLI. Trigger when user wants to check CI status ("check CI", "is the build passing"), view workflow runs ("show recent runs", "view action logs"), watch running workflows ("watch CI"), or rerun failed workflows ("rerun the build").
When & Why to Use This Skill
This Claude skill enables seamless management and monitoring of GitHub Actions workflows directly through the GitHub CLI. It streamlines the development lifecycle by allowing users to track CI/CD pipeline statuses, inspect detailed execution logs, and manage workflow reruns, ensuring high deployment reliability and faster feedback loops for engineering teams.
Use Cases
- 1. Real-time CI/CD Monitoring: Quickly verify if builds are passing or failing on specific branches ('check CI', 'is the build passing') to maintain a healthy codebase.
- 2. Efficient Debugging and Troubleshooting: Access and analyze logs for failed workflow runs ('view action logs', 'log-failed') to pinpoint and resolve integration issues without leaving the terminal.
- 3. Workflow Orchestration: Manually trigger reruns for failed jobs or watch the live progress of active deployments ('watch CI', 'rerun the build') to ensure critical updates are deployed successfully.
| name | actions |
|---|---|
| description | GitHub Actions workflow management using GitHub CLI. Trigger when user wants to check CI status ("check CI", "is the build passing"), view workflow runs ("show recent runs", "view action logs"), watch running workflows ("watch CI"), or rerun failed workflows ("rerun the build"). |
GitHub Actions
Monitor and manage GitHub Actions workflows with the gh CLI.
Prerequisites
GitHub CLI must be installed and authenticated:
gh auth status
Quick Reference
gh run list # List recent runs
gh run view 789 # View run details
gh run view 789 --log # View run logs
gh run watch 789 # Watch running workflow
gh run rerun 789 # Rerun workflow
List Workflow Runs
gh run list
gh run list --limit 10
gh run list --workflow ci.yml
gh run list --status failure
gh run list --branch main
View Run Details
gh run view 789
gh run view 789 --json status,conclusion,jobs
View Run Logs
gh run view 789 --log
gh run view 789 --log-failed # Only failed job logs
Watch Running Workflow
gh run watch 789
gh run watch 789 --exit-status # Exit with workflow status code
Rerun Workflows
gh run rerun 789
gh run rerun 789 --failed # Rerun only failed jobs
List Workflows
gh workflow list
gh workflow view ci.yml