ptoas-publish-pr

Publish scoped PTOAS changes as a draft GitHub pull request.

30|74|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/hw-native-sys/PTOAS --skill ptoas-publish-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ptoas-publish-pr
Source: https://github.com/hw-native-sys/PTOAS/tree/main/.codex/skills/ptoas-publish-pr
Command: npx skills add https://github.com/hw-native-sys/PTOAS --skill ptoas-publish-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns intended local PTOAS changes into a focused GitHub pull request while preventing unrelated worktree files from being included and preserving the repository's fork and upstream remote structure.

Core Features & Use Cases

  • Repository Safety Checks: Inspects branches, worktree state, remotes, and GitHub CLI authentication before publishing.
  • Scoped Git Workflow: Creates a feature branch when needed, stages only intended files, validates affected skills, commits changes, and pushes to the user's fork.
  • Pull Request Creation: Opens or updates a draft pull request against the canonical PTOAS repository and reports the branch, commit, push status, PR URL, and validation performed.
  • Use Case: Use it after modifying PTOAS source code or skill files when you need to publish only the relevant changes from a worktree that may contain unrelated files.

Quick Start

Use the PTOAS publish PR skill to validate and publish the intended local changes as a draft pull request against the canonical repository.

Frequently Asked Questions about ptoas-publish-pr

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

FAQPage Schema
How do I publish a GitHub pull request with only specific files from my worktree?

To publish a GitHub pull request with only specific worktree files, stage only the intended local changes, validate them, commit, and push to a fork remote to open a focused draft PR. This prevents unrelated worktree files from being included in the pull request.

What is the best way to create a pull request from a fork without including untracked files?

Creating a pull request from a fork without untracked files requires scoped staging, where only intended changes are committed to a feature branch and pushed to the fork remote. The worktree safety mechanism ensures unrelated files remain excluded from the final GitHub pull request.

Do I need GitHub CLI to create a draft pull request against an upstream repository?

Yes, you need GitHub CLI to create a draft pull request against an upstream repository. Authenticated GitHub credentials and correctly configured origin and upstream remotes are also required to push changes from your fork and open the PR against the canonical repository.

How does scoped git staging work for feature branch commits?

Scoped git staging works by selectively adding only the intended modified files to the index, creating a feature branch when needed, and committing those specific changes. This workflow isolates targeted modifications from unrelated worktree files before pushing to a remote fork.

Why does my pull request validation fail before pushing to a fork?

Your pull request validation may fail because quick_validate.py detected issues with affected skills before pushing to your fork. The repository safety checks also inspect branches, worktree state, remotes, and GitHub CLI authentication, halting the process if prerequisites are not met.