Gsd-2 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.

install

source · Clone the upstream repo

git clone https://github.com/gsd-build/gsd-2

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/gsd-build/gsd-2 "$T" && mkdir -p ~/.claude/skills && cp -r "$T/src/resources/skills/github-workflows" ~/.claude/skills/gsd-build-gsd-2-github-workflows && rm -rf "$T"

manifest: src/resources/skills/github-workflows/SKILL.md

source content

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
```
--help
```
to 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:

Fetch the relevant
```
.md
```
file from the URL above
Read only the section you need

Task	File	Section
Create workflow	workflow-syntax.md	`name` , `on` , `jobs`
Set triggers	workflow-syntax.md	`on`
Set permissions	workflow-syntax.md	`permissions`
Concurrency	workflow-syntax.md	`concurrency`
Reusable workflow	workflow-syntax.md	`on.workflow_call`
Annotations	workflow-commands.md	"Setting an error/warning/notice message"
Output variables	workflow-commands.md	"Environment files"
Conditionals	expressions.md	"Operators", "Functions"
Contexts	contexts.md	"<context> context"
Events	events-that-trigger-workflows.md	Event tables

Version Verification

What	Where
Action versions	`node ci_monitor.cjs check-actions <file>`
Node.js LTS	`curl -s https://nodejs.org/dist/index.json \| jq '.[0].version'`

Validation Constraint

"No errors" is not validation. Prove observable change:

BEFORE: [specific state]
AFTER:  [different state]
EVIDENCE: [output from ci_monitor.cjs]

References

```
references/gh/SKILL.md
```
— gh CLI reference