From github-orchestration
Use this skill when the user wants to "check CI", "wait for CI", "CI status", "retry failed checks", "cancel CI", "debug CI failure", or manage CI/CD workflows. Provides comprehensive CI checking with fail-fast patterns and preview URL extraction.
npx claudepluginhub constellos/claude-code --plugin github-orchestrationThis skill uses the workspace's default tool permissions.
Comprehensive CI/CD workflow management with fail-fast error detection and preview URL extraction.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
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