# Docs Workflow Create Mr

> Create or find an existing merge request (GitLab) or pull request (GitHub) for the published documentation branch. Skipped in draft mode or when the branch was not pushed. Use when this capability is needed.

- Skill: `tomevault-io/docs-workflow-create-mr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/docs-workflow-create-mr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/docs-workflow-create-mr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/docs-workflow-create-mr

---


# Create MR/PR Step

Step skill for the docs-orchestrator pipeline. Creates a GitLab MR or GitHub PR for the feature branch pushed by the commit step.

**Skipped when `--draft` is set** or when `commit-info.json` has `pushed: false`.

## Arguments

- `$1` — JIRA ticket ID (required)
- `--base-path <path>` — Base output path (e.g., `.claude/docs/proj-123`)
- `--repo-path <path>` — Accepted for compatibility but unused (context comes from `commit-info.json`)
- `--draft` — If present, skip MR/PR creation entirely

## Input

```text
<base-path>/commit/commit-info.json
```

Produced by the commit step. Must have `pushed: true` for this step to proceed.

## Output

```text
<base-path>/create-mr/mr-info.json
<base-path>/create-mr/step-result.json
```

`mr-info.json` contains platform, MR/PR URL, action taken (`created`, `found_existing`, or `skipped`), and title. `step-result.json` is the standard sidecar with MR/PR metadata.

## Execution

Run the create-mr script, passing through all arguments:

```bash
bash ${CLAUDE_SKILL_DIR}/scripts/create_mr.sh <ticket> --base-path <base-path> [--repo-path <path>] [--draft]
```

The script handles:

1. **Draft mode check** — writes a skip record and exits if `--draft` is set
2. **Commit check** — reads `commit-info.json` and skips if branch was not pushed
3. **Context resolution** — determines platform and repo URL from `commit-info.json`, default branch from `repo-info.json` if available
4. **Existing MR/PR check** — looks for an open MR/PR from the feature branch before creating a new one
5. **MR/PR creation** — creates a GitLab MR (via `glab` CLI) or GitHub PR (via `gh` CLI)
6. **Output** — writes `mr-info.json` with the MR/PR URL and metadata, and `step-result.json` sidecar

---
> Source: [DonaghBr/redhat-docs-agent-tools](https://github.com/DonaghBr/redhat-docs-agent-tools) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->