SKILL.md
bx-sites GitHub Actions Operations
Use this skill for CI and release operations in:
- Repository:
ortus-boxlang/bx-sites - Actions dashboard:
https://github.com/ortus-boxlang/bx-sites/actions
Workflow inventory
Primary workflows in bx-sites:
| Workflow | File | Typical purpose |
|---|---|---|
| Daily Tests | .github/workflows/cron.yml |
Scheduled daily run of test suites |
| Pull Requests | .github/workflows/pr.yml |
PR/branch validation |
| Test Suites | .github/workflows/tests.yml |
Core reusable test workflow |
| Build Snapshot | .github/workflows/snapshot.yml |
Development snapshot build after tests |
| Release | .github/workflows/release.yml |
Stable release and version/tag flow |
| Docbox | .github/workflows/docbox.yml |
API docs generation and publishing |
| Publish Docs | .github/workflows/pages.yml |
Multi-theme site build + Pages deploy |
Required troubleshooting flow
When users mention CI/build/test/workflow failures, always do this:
- List recent runs for the target workflow or repository.
- Inspect failed jobs and fetch logs.
- Identify the first actionable root cause.
- Recommend minimal remediation steps.
- If requested, trigger rerun or cancel stuck runs.
Suggested GitHub tool operations
- List workflows:
actionslist(method=listworkflows) - List runs:
actionslist(method=listworkflowruns, resourceid=<workflow id or file>) - List jobs:
actionslist(method=listworkflowjobs, resourceid=<run id>) - Read logs:
getjoblogs(jobid=<job id>, returncontent=true) - Rerun run:
actionsruntrigger(method=rerunworkflowrun, run_id=<run id>) - Rerun failed jobs:
actionsruntrigger(method=rerunfailedjobs, run_id=<run id>) - Cancel run:
actionsruntrigger(method=cancelworkflowrun, run_id=<run id>)
Output expectations
For each investigation, report:
- Workflow/run/job identifiers
- Failing step name
- Direct error excerpt from logs
- Root cause summary
- Minimal fix or rerun recommendation