open-source-pr-workflow

Prepare review-ready pull requests with standardized branch naming and structured English PR bodies.

4|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/LaiTszKin/apollo-toolkit --skill open-source-pr-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: open-source-pr-workflow
Source: https://github.com/LaiTszKin/apollo-toolkit/tree/main/open-source-pr-workflow
Command: npx skills add https://github.com/LaiTszKin/apollo-toolkit --skill open-source-pr-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Open-source contributions often stall due to inconsistent PR quality. This Skill ensures a repeatable, high-quality PR workflow by guiding you from prepared changes to a ready-to-submit PR with standardized branch naming and English PR content.

Core Features & Use Cases

  • Enforces codex/{change_type}/{changes} branch naming for all PRs.
  • Drafts and opens PRs with required sections (motivation, engineering decisions with rationale, and test results) in English.
  • Default targets for forks to the upstream repository, unless the user explicitly requests the fork.
  • Provides a structured PR body to facilitate review and collaboration.

Quick Start

Draft a compliant PR by running the tool on prepared changes and verify the branch name codex/{change_type}/{changes} before opening.

Frequently Asked Questions about open-source-pr-workflow

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

FAQPage Schema
How do I prepare a review-ready pull request for an open-source repository?

To prepare a review-ready pull request, you must enforce standardized branch naming, draft the PR body in English with motivation and engineering decisions, and run edge-case discovery and code simplification checks before opening it.

What should be included in an OSS pull request body to pass code review?

An OSS pull request body should include structured sections for motivation, engineering decisions with rationale, and test results to facilitate review and collaboration for code-affecting changes.

How do I name branches for open-source contributions?

Branches for open-source contributions should follow the codex/{change_type}/{changes} naming convention to ensure consistency before drafting and opening a pull request.

Does a fork pull request target the upstream repository by default?

Yes, fork pull requests default to targeting the upstream repository unless you explicitly request to target your own fork during the workflow.

How to automate the open-source PR workflow for existing code changes?

To automate the open-source PR workflow, apply this process to existing changes: it enforces branch naming, runs code simplification and edge-case discovery for code changes, and drafts a structured PR body.

Can I use this PR workflow for documentation changes without running code checks?

Yes, this PR workflow applies to both code and documentation changes, but the discover-edge-cases and code-simplifier checks are only enforced for code-affecting changes.