home / skills / dtinth / agent-skills / wait-for-ci

wait-for-ci skill

safe

/wait-for-ci

This skill waits for GitHub Actions checks on the current pull request, providing live updates and a final summary.

npx playbooks add skill dtinth/agent-skills --skill wait-for-ci

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

602 B

---
name: wait-for-ci
description: Use this skill to wait for checks on GitHub Actions to finish on the current pull request
---

Make sure there is an active pull request for the current branch, then run this command in the project directory (not the skill base directory):

```
mise exec deno -- deno run --allow-run=gh --allow-env https://github.com/dtinth/wait-for-ci/raw/main/wait-for-ci.ts
```

This command:

- Monitors a GitHub pull request's status checks.
- Periodically polls and prints status updates and any changes.
- When all checks are finished, prints a summary of results, and exits.

Overview

This skill waits for GitHub Actions checks to finish on the current pull request from the project directory. It runs a small Deno script that polls the PR status, prints live updates, and exits with a summary once all checks complete. Use it to avoid manually refreshing GitHub while CI runs.

How this skill works

The skill runs a Deno program that queries the GitHub API (via the gh CLI) for the active pull request linked to the current branch. It periodically polls workflow and check-run statuses, printing progress and any status changes as they occur. When every check-run reaches a terminal state, it prints a concise summary of results and exits.

When to use it

You want to monitor CI for the current branch without opening the browser.
You need a simple terminal-based live view of check-run progress for a PR.
You want a blocking step in a script that waits until CI completes.
You prefer a minimal tool that reports status changes and final results in real time.

Best practices

Run the command from the project directory (not the skill repo directory) so the script can detect the current branch and PR.
Ensure gh CLI is authenticated and available in your PATH; the script delegates API access to gh.
Run with Deno permissions as suggested: allow-run for gh and allow-env for environment variables.
Use this in CI/debug scripts or local workflows where a quick terminal status summary is useful.
Avoid running on branches without an open pull request; the tool expects an active PR for the current branch.

Example use cases

During a review session, run the tool to watch checks finish while you prepare feedback.
In a pre-merge checklist, block the next step until all required checks are green or report failures.
When debugging flaky tests, keep the terminal open to see which jobs fail as they finish.
Integrate into a local release flow to pause release steps until CI confirms the PR status.

FAQ

What command do I run to use this skill?

Run the provided Deno command from your project directory. It downloads and runs the wait-for-ci.ts script and requires gh CLI access.

What permissions or tools are required?

You need Deno to run the script and the GitHub CLI (gh) authenticated for API access. The command requests allow-run for gh and allow-env for environment variables.