skills.rest
karlmdavis
karlmdavisCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

awaiting-pr-workflows

Verifies Git and GitHub CLI PR workflows and waits for completion with exponential backoff.

1|Updated Jul 14, 2017
Search Tags:#automation#git#workflow#ci/cd#github#status#polling#pr
One-click install
npx skills add https://github.com/karlmdavis/dotfiles --skill awaiting-pr-workflows
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: awaiting-pr-workflows
Source: https://github.com/karlmdavis/dotfiles/tree/main/private_dot_claude/skills/awaiting-pr-workflows
Command: npx skills add https://github.com/karlmdavis/dotfiles --skill awaiting-pr-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually checking GitHub PR workflow status, especially under time pressure, often leads to overlooking unpushed changes, commit mismatches, or giving up too early. This Skill automates the entire waiting process, ensuring accurate status reporting and preventing common pitfalls.

Core Features & Use Cases

  • Pre-flight Checks: Automatically verifies for unpushed local changes and ensures the PR's head commit matches your local HEAD.
  • PR Existence Validation: Confirms the PR exists for the current branch and offers to create one if missing.
  • Intelligent Waiting: Patiently waits for workflows to start (up to 30s) and complete (up to 20 minutes) with exponential backoff, preventing premature reporting.
  • Use Case: You've just pushed a fix and need to confirm CI is passing before merging. Instead of constantly checking GitHub, use this Skill to automatically handle all pre-checks and wait for the final "✅ All workflows complete!" message.

Quick Start

Use the awaiting-pr-workflows skill for PR number 101 to check if all associated GitHub workflows have completed.

Frequently Asked Questions about awaiting-pr-workflows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically check if GitHub PR workflows have completed?▼

This Skill automatically checks PR workflow status by verifying unpushed changes, confirming commit correlation, and waiting for CI to complete with exponential backoff—up to 20 minutes. It eliminates manual GitHub checks and prevents premature reporting.

Can I use this to wait for CI/CD pipelines to finish after pushing code?▼

Yes. The Skill performs pre-flight checks for unpushed changes, validates the PR exists for your branch, confirms your local HEAD matches the PR's head commit, then intelligently waits for all workflows to start and complete.

What happens if my PR doesn't exist yet?▼

The Skill validates PR existence and offers to create one if missing, ensuring you can proceed without manual GitHub navigation. This integrates PR creation into the automated workflow-waiting process.

How does this prevent common mistakes when checking PR status?▼

It automates unpushed-change detection, commit correlation verification, and progressive waiting with exponential backoff using Git and GitHub CLI, catching issues like mismatched commits or incomplete local pushes before waiting for workflows.

Can I use this with my existing Git and GitHub CLI setup?▼

Yes. The Skill uses Git and GitHub CLI as its dependencies, integrating seamlessly with standard developer environments without requiring additional tools or configuration.

What's the difference between manually polling GitHub and using automated workflow waiting?▼

Automated waiting handles pre-checks, commit validation, and intelligent polling with exponential backoff in one operation, reducing oversight risk and time spent checking dashboards manually under pressure.

Related Skills

Explore More Software Engineering Skills→
paultyngpaultyng
9

push-and-watch

Push local commits, create draft pull requests, and monitor GitHub Actions CI runs.

Community
Intermediate
Svenja-devSvenja-dev
38

code-quality-gate

Enforce automated quality checks across pre-commit, CI, preview, E2E, and production stages.

Community
Advanced
aapw01aapw01

Git Workflow & CI/CD

Implement Git workflow best practices and automate CI/CD pipelines with GitHub Actions.

Community
Advanced
buvisbuvis
2

watch-ci

Monitor GitHub Actions workflow runs for the current branch and summarize failures.

Official
Intermediate