Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From github-orchestration
Manages GitHub Actions CI/CD for PRs: checks status, waits with fail-fast patterns, extracts Vercel/Netlify preview URLs, retries failures, debugs issues.
npx claudepluginhub constellos/claude-code --plugin github-orchestrationHow this skill is triggered — by the user, by Claude, or both
Slash command
/github-orchestration:ci-orchestrationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Comprehensive CI/CD workflow management with fail-fast error detection and preview URL extraction.
Polls GitHub PR CI checks at intervals until completion or timeout. Useful for checking CI status, waiting for passes, monitoring builds, or verifying PR green status.
Waits for CI/CD pipelines (GitHub Actions, GitLab CI, Vercel) to finish after pushing code, then reports results. Useful for push-then-verify workflows.
Monitors GitHub Actions CI runs until completion, reporting pass/fail/timeout verdicts per run. Useful after pushing code or checking PR build status.
Share bugs, ideas, or general feedback.
Comprehensive CI/CD workflow management with fail-fast error detection and preview URL extraction.
CI Orchestration provides explicit control over GitHub Actions and other CI systems. Monitor check status, extract preview URLs, debug failures, and manage workflow retries with intelligent fail-fast patterns.
# Check PR status
gh pr checks 42
# Watch and wait
gh pr checks 42 --watch
# Get JSON output
gh pr view 42 --json statusCheckRollup
The existing ci-status.ts utility provides comprehensive preview URL extraction:
import { extractPreviewUrls } from '../shared/hooks/utils/ci-status.js';
// Extract from CI output
const urls = extractPreviewUrls(ciOutput);
// Returns: { web: 'https://...', marketing: 'https://...' }
# Wait with fail-fast
awaitCIWithFailFast "$PWD" 42 10 # 10 minute timeout
# Detects:
# - Merge conflicts
# - Branch divergence
# - Failed checks
# - Workflow errors
# Get latest workflow run
RUN_ID=$(gh run list --branch $(git branch --show-current) --limit 1 --json databaseId -q '.[0].databaseId')
# Re-run failed jobs
gh run rerun $RUN_ID --failed
| Hook | Behavior |
|---|---|
| await-pr-status | Waits for CI after gh pr create |
| commit-task-await-ci-status | Auto-commits and checks CI on SubagentStop |
| commit-session-await-ci-status | Blocking CI check on Stop |
From ci-status.ts:
awaitCIWithFailFast(cwd, prNumber, timeout) - Wait with fail-fastextractPreviewUrls(output) - Parse Vercel/Netlify URLsgetLatestCIRun(cwd, branch) - Get workflow run IDformatCiChecksTable(checks) - Format as markdown table# Create PR
PR=$(gh pr create --title "Add feature" --body "..." --json number -q .number)
# Wait for CI
awaitCIWithFailFast "$PWD" $PR 10
# Extract preview URLs
CHECKS=$(gh pr view $PR --json statusCheckRollup -q '.statusCheckRollup')
PREVIEW=$(extractPreviewUrls "$CHECKS")
echo "Preview: $PREVIEW"
# Get failed checks
gh pr checks 42 --json name,conclusion,detailsUrl \
--jq '.[] | select(.conclusion=="FAILURE") | {name, url: .detailsUrl}'
# View logs
gh run view $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --log-failed
MAX_RETRIES=3
RETRY=0
while [ $RETRY -lt $MAX_RETRIES ]; do
if gh pr checks $PR --watch; then
echo "✓ CI passed"
break
fi
RETRY=$((RETRY + 1))
if [ $RETRY -lt $MAX_RETRIES ]; then
echo "Retry $RETRY/$MAX_RETRIES..."
gh run rerun $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --failed
fi
done