opensource-ops

Grounds, triages, and routes external PR and issue reviews with verified identity and custody rules.

2.9k|733|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/zts212653/clowder-ai --skill opensource-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opensource-ops
Source: https://github.com/zts212653/clowder-ai/tree/main/cat-cafe-skills/opensource-ops
Command: npx skills add https://github.com/zts212653/clowder-ai --skill opensource-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a child thread is asked to review, triage, or advise on an external GitHub PR or issue, it is easy to act on unverified assumptions: trusting the thread title for PR identity, misjudging who should fix what, or writing review verdicts without maintainer authority. This Skill enforces a fail-closed workflow that grounds every judgment in provider-verified facts before any action is taken.

Core Features & Use Cases

  • Provider-neutral grounding: Uses the deployment's provider adapter (e.g., gh for GitHub) to resolve the external object into verified fields such as providerSubject, headSha, verifiedAuthorIdentity, and authenticatedRole before any judgment.
  • Custody and identity matrix: Compares verified author identity against the authenticated contributor identity and role to decide who reviews, who fixes, and who merges, with fail-closed handling for bots, ambiguous authors, and missing authentication.
  • Maintainer five-question adoption framework: Structures adopt/reject/advisory-only decisions around problem fit, vision alignment, adoption path, and custody boundaries, all citing grounded fields.
  • Reverse provenance verification: Separates external object verification from internal thread provenance, grading evidence as origin, related, or unknown and recording verified PR/issue metadata via cat_cafe_set_thread_metadata.
  • Use Case: A maintainer receives a community PR on their repository. The child thread loads this Skill, runs gh to verify the PR and author, determines the authenticated identity is a maintainer, answers the five adoption questions, registers tracking only if genuinely blocked, and routes the fix back to the external author.

Quick Start

Load the opensource-ops skill in the child thread and ground the external PR or issue with the provider adapter before making any review or custody decision.

Frequently Asked Questions about opensource-ops

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

FAQPage Schema
How do I review an external GitHub PR from a child thread?

Load the opensource-ops skill first, then use the provider adapter such as `gh` to ground the PR into verified fields like headSha, author identity, and your authenticated role. Only after grounding should you answer the five adoption questions and route review or fixes.

How to decide who should fix a community pull request?

Compare the verified author identity with the authenticated contributor identity and role. External authors own fixes by default; a local agent may only take over when the author is unresponsive, the fix is a trivial blocker, and explicit operator or maintainer authorization is recorded.

Can I record a formal review verdict on any external PR?

No. Formal verdicts via cat_cafe_record_external_review_verdict apply only when the authenticated identity is a maintainer of the target repository and the PR author is someone else. Outbound PRs and third-party audits are advisory only.

What happens when PR author identity cannot be verified?

The workflow fails closed. If the author is a bot, shared account, or unresolvable, the thread stops, marks author_kind as ambiguous, and waits for explicit operator or maintainer confirmation before any custody decision.

When should PR tracking be registered for external issues?

Register tracking only when work is genuinely blocked on an external condition such as author response, CI, or maintainer review, or when seeding a projection before a formal review verdict. Advisory and triage work does not need tracking.