Open Pull Request

SkillDev tools

Use when the user wants to open a pull request or finish a branch handoff. Read the PR template, inspect changes vs main, run the release skill first if the branch name looks like a version, validate the branch with the shared repo checks, open a draft PR targeting main, and return the preview deployment URL when one applies.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Open Pull Request skill

What this skill tells your AI

The instructions your AI receives, as published by zacharyfmarion/openscad-studio in .agents/skills/pr/SKILL.md and read by ahel’s review.

  1. Read .github/PULL_REQUEST_TEMPLATE.md and understand its required sections.
  2. Inspect what has changed on this branch vs main. If there are unrelated changes, stop and ask the user what to do.
  3. If the branch name looks like a release branch or versioned release workflow, run the release skill first before continuing.
  4. Choose the right validation scopes for the changed files and run them through scripts/validate-changes.sh.
  5. Prefer bash scripts/validate-changes.sh --scope baseline for normal TS or workflow changes. Add scopes when needed:
    • --scope formatter for formatter behavior changes
    • --scope rust for apps/ui/src-tauri or other desktop-only changes
    • --scope e2e-web for materially changed user-facing web flows
  6. If formatting fixes are still needed before validation, run pnpm format intentionally first, then rerun the validation helper in check mode. Do not rely on the helper to mutate files unless you explicitly choose --fix.
  7. Draft a PR title and body that follow the template exactly, filling each section from the actual branch changes, validations run, validations skipped, and tests added.
  8. Open or update a draft PR against main:
    • Create with gh pr create --draft --base main when no PR exists for the branch.
    • Update the existing PR body when one already exists.
  9. After the PR exists, wait for the Deploy PR Preview workflow when the change is web-relevant.
  10. Return:
  • the full PR URL
  • the preview URL when one applies
  • any explicit follow-up if the preview deploy or sticky comment failed

Preview Expectations

  • Web-relevant PRs should publish to https://pr-<number>.openscad-studio.pages.dev
  • Docs-only and desktop-only PRs may skip preview deployment
  • If Cloudflare deploy succeeds but the sticky comment fails, report that separately instead of pretending the preview is unavailable

Signals

GitHub stars
232
Forks
33
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
pr-zacharyfmarion
Source
github.com/zacharyfmarion/openscad-studio