github-workflows
Work with GitHub Actions CI/CD workflows - read live syntax, monitor runs, and debug failures. Use when writing, running, or debugging GitHub Actions workflows.
Best for CI pipeline debuggingWorks with GitHubLow risk
⌘source
- author
@gsd-build- repo
- gsd-build/gsd-2
- language
- TypeScript
★7.2kstars
737forks
May 6, 2026
✦overview.md
Key Features
- ·Live syntax from GitHub docs
- ·Unified cimonitor.cjs CLI
- ·Run monitoring and failure analysis
- ·Log searching with regex
- ·Action version checking
- ·Wait for deployment jobs
Use Cases
- →Debug a failing CI run by watching logs in realtime
- →Check which action versions are used in a workflow file
- →Search logs for specific errors with grep
- →Monitor a long-running deployment until completion
- →Get a test pass/fail summary from a workflow run
Best for
- ✓CI pipeline debugging
- ✓GitHub Actions maintainers
- ✓DevOps engineers
Not ideal for
- !Non-GitHub CI systems
- !Simple one-off scripts
FAQs
name
github-workflows
description
Work with GitHub Actions CI/CD workflows - read live syntax, monitor runs, and debug failures. Use when writing, running, or debugging GitHub Actions workflows.
GitHub Workflows
Mission: Work with GitHub Actions without using stale training data. All syntax, versions, and parameters come from live sources.
Structural Principle
All CI operations go through ci_monitor.cjs. Never reach for gh CLI directly — the script wraps it with observable output.
Primary Tool: ci_monitor.cjs
Path: scripts/ci_monitor.cjs
node scripts/ci_monitor.cjs <command>
Before using any command:
- Run
--helpto discover available arguments
Routing Table:
| When You Need | Command |
|---|---|
| List recent runs | runs [--branch <name>] |
| Monitor running workflow | watch <run-id> |
| Fail fast in scripts | fail-fast <run-id> |
| See why run failed | log-failed <run-id> |
| Test pass/fail counts | test-summary <run-id> |
| Check action versions | check-actions [file] |
| Search logs | grep <run-id> --pattern <regex> |
| Wait for deployment | wait-for <run-id> <job> --keyword <text> |
Documentation Routing
Base URL: https://docs.github.com/en/actions/reference/workflows-and-actions/
Before writing any workflow syntax:
$install
1-click copynpx skills add gsd-build/gsd-2 --skill github-workflowsSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.