Improve create-pr skill with cross-platform support and best practices

[JamesNK]

Description

Improve the create-pr AI skill to follow best practices and work cross-platform.

Changes:

• Keyword-rich description for better agent discovery (includes trigger phrases like "create PR", "open PR", "submit PR")
• Example requests section to help agent match user intent
• Prerequisites section to check for gh CLI and auth before starting
• Cross-platform commands with both bash and PowerShell syntax, plus explanation of differences (GH_PAGER=cat is bash-only; PowerShell needs $env:GH_PAGER)
• GH_PAGER explanation so agents understand why it's needed
• Temp file cleanup step after PR creation
• Error handling table covering common failures (gh not found, auth issues, push rejected)

Checklist

• Is this feature complete?
  • Yes. Ready to ship.
  • No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • Yes
  • No
• Did you add public API?
  • Yes
  • No
• Does the change make any security assumptions or guarantees?
  • Yes
  • No
• Does the change require an update in our Aspire docs?
  • Yes
  • No

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 15748

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 15748"

[Copilot]

Pull request overview

Updates the .github/skills/create-pr skill documentation to better guide agents in creating pull requests using the repo template, with clearer discovery keywords and cross-platform (bash/PowerShell) command guidance.

Changes:

• Expands skill metadata and adds “Example requests” to improve intent matching/discovery.
• Adds prerequisite checks (gh installed + authenticated) and a more structured step-by-step procedure.
• Documents bash + PowerShell variants for gh pr create, adds GH_PAGER rationale, cleanup guidance, and an error-handling table.

[aspire-repo-bot]

No documentation PR is required for this change.

Reason: This PR improves an internal AI skill (create-pr) used by the development tooling. It contains no public API additions, new user-facing features, configuration changes, or behavioral changes that affect Aspire end-users. The change is internal infrastructure only, and the PR author also indicated docs updates are not needed.

Generated by PR Documentation Check · ● 85.3K · ◷