feat: add PR CI watch skill

[colinaaa]

Summary

• add a reusable skill that triggers after GitHub PR creation to delegate CI monitoring to a subagent
• document the subagent workflow around gh pr checks <pr> --watch so the main agent only resumes when CI succeeds or fails
• add repository instructions to keep future updates aligned with the watch-based pattern

Summary by CodeRabbit

• Documentation
  • Added documentation for the PR CI watch skill, providing guidance on monitoring pull request CI status and workflows.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 291f549

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Two new documentation files are added to define and instruct the PR CI watch subagent skill. The first file provides maintenance guidelines, while the second specifies the skill's purpose, control flow, terminal outcomes, and operational requirements for monitoring GitHub PR checks.

Changes

Cohort / File(s)	Summary
PR CI Watch Subagent Documentation .github/pr-ci-watch-subagent.instructions.md, .github/skills/pr-ci-watch-subagent/SKILL.md	Two documentation files establish a new skill for monitoring PR CI checks using gh pr checks <pr> --watch. Instructions file applies guidance to the skill directory; SKILL.md defines use cases, control flow, terminal states, result reporting format, and operational details.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A subagent hops into view,
Watching checks turn green or blue,
With structured reports and GitHub CLI,
PR status flows swift and high,
Documentation now complete—hip hooray! 🎉

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: add PR CI watch skill' is clear and directly summarizes the main change—adding a new reusable skill for monitoring PR CI status.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 291f549fc3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Scope watch command to required checks

The skill defines success as "all required checks passed," but the recommended command gh pr checks <pr> --watch watches all checks by default. In repositories with optional checks, a non-required failure will be reported as CI failure even when required branch-protection checks are green, so the main agent can incorrectly tell users the PR failed. Either add --required to the watch command or change the documented success criteria to match all checks.

Useful? React with 👍 / 👎.