Submit Pr

---
name: submit-pr
description: Push branch and create pull request with formatted checklist
user-invocable: false
---

# submit-pr

Model-invocable skill for creating pull requests.

## Purpose

Push branch and create a pull request with the quality checklist and eval results embedded in the PR body. This skill executes — it does not orchestrate.

## Input

Receive from caller (agent):

| Field | Required | Description |
|-------|----------|-------------|
| `title` | Yes | PR title (conventional commit format) |
| `base` | Yes | Base branch (e.g., `main`) |
| `checklist` | Yes | Quality checklist from analyze-pr |
| `eval_results` | No | Eval results to embed in PR body (pass/fail summary + details) |
| `draft` | No | Create as draft PR (default: false) |
| `labels` | No | Labels to add |
| `assignees` | No | Assignees to add |

## Platform Dispatch

This skill routes all platform operations through the `platform-adapter` skill. The adapter resolves the active platform from `.garura/core/config.yaml` and dispatches to the correct CLI.

Supported platforms: `github` (via `gh`), `gitlab` (via `glab`). Bitbucket is not supported in this version — the adapter will return a structured failure if `platform=bitbucket` is configured.

## Process

### 1. Push Branch

```bash
# Get current branch
branch=$(git branch --show-current)

# Check if branch has upstream, push if not
git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null || git push -u origin HEAD
```

### 2. Format PR Body

Load `~/.garura/core/memory/standards/templates/pr-body.md` and instantiate with `summary`, `checklist.required`, `checklist.optional`, `eval_results`, and the generated-by footer values. Follow the Eval Results rules in the template.

> **Direct-edit deviation note (fix-it/#209):** Format pointer substitution only. Reconcile at next `/create-play --build submit-pr` run.

### 3. Create PR

Invoke the `platform-adapter` skill with `verb: create-pr` and `args: {title: {title}, body: {body}, base: {base}, draft: {draft}, label: {label}, assignee: {assignee}}`.

### 4. Get PR Info

Invoke the `platform-adapter` skill with `verb: view-pr` and `args: {pr_number: {pr_number}}` to retrieve PR details.

## Output

Produce output using template: `templates/pr-output.md`

**IMPORTANT**: This skill produces operation results. The calling agent receives this output and decides what to do next. Do NOT instruct the agent to return or stop.

## Constraints

- NEVER modify checklist content — only format it
- NEVER run tests or builds — just create the PR
- NEVER ask for user input — return result to caller
- NEVER hardcode platform-specific CLI commands — always route through platform-adapter
- ALWAYS read platform from project config (handled by platform-adapter)
- ALWAYS include eval results in PR body when provided
- ALWAYS include the "Generated by [Garura]" footer

## Version

| Field | Value |
|-------|-------|
| Version | 2.0.0 |
| Category | operations |