Skill

docs-workflow-prepare-branch

Creates fresh git branch from latest upstream default before docs updates in UPDATE-IN-PLACE mode. Skips in --draft; checks dirty tree, fetches latest.

Git

Bash

Jira

git-workflow

automation

npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin docs-tools

Configuration

Model: claude-haiku-4-5@20251001

Tool Access

This skill is limited to using the following tools:

BashRead

Preview

Step skill for the docs-orchestrator pipeline. Creates a clean working branch from the latest upstream default branch before the writing step modifies repo files.

Supporting Assets

scripts/prepare_branch.sh

SKILL.md

Similar Skills

create-branch

Creates Git feature branch or worktree from base branch before writing artifacts. Infers name like feat/kebab-topic from context and confirms options with user.

1 file1 tool

vgv-wingspan

create-branch

666

Creates git branches following Sentry naming conventions (<prefix>/<type>/<description>) from args, git diff/status, or generic. Classifies type, picks base, avoids collisions.

sentry-skills

docs-orchestrator

Orchestrates documentation workflows from YAML step lists, running skills sequentially with progress state, iterations, confirmations, and JIRA/PR integration.

3 files10 tools

docs-tools

Stats

Parent Repo Stars14

Parent Repo Forks11

Last CommitMar 24, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Prepare Branch Step

Step skill for the docs-orchestrator pipeline. Creates a clean working branch from the latest upstream default branch before the writing step modifies repo files.

Only runs in UPDATE-IN-PLACE mode. When --draft is set, this step is a no-op (mark completed immediately).

Arguments

$1 — JIRA ticket ID (required)

--base-path <path> — Base output path (e.g., .claude/docs/proj-123)

--draft — If present, skip branch creation entirely

Input

None. This step has no upstream file dependencies.

Output

<base-path>/prepare-branch/branch-info.md

Contains the branch name created and the base ref used.

Execution

Run the branch preparation script, passing through all arguments:

bash scripts/prepare_branch.sh <ticket> --base-path <base-path> [--draft]

The script handles:

Argument parsing — extracts ticket ID, --base-path, and --draft flag

Draft mode — writes a skip note and exits early if --draft is set

Default branch detection — tries upstream remote first, falls back to origin, detects HEAD branch with fallback to main/master

Uncommitted changes check — stops with an error if working tree is dirty (never force-checkouts)

Fetch — fetches latest from remote; warns but continues if fetch fails (network/auth issues)

Branch creation — creates <ticket-id-lowercase> branch from remote default; switches to existing branch if it already exists

Output — writes branch-info.md with branch name, base ref, and timestamp

Prepare Branch Step

Step skill for the docs-orchestrator pipeline. Creates a clean working branch from the latest upstream default branch before the writing step modifies repo files.

Only runs in UPDATE-IN-PLACE mode. When --draft is set, this step is a no-op (mark completed immediately).

Arguments

$1 — JIRA ticket ID (required)
--base-path <path> — Base output path (e.g., .claude/docs/proj-123)
--draft — If present, skip branch creation entirely

Input

None. This step has no upstream file dependencies.

Output

<base-path>/prepare-branch/branch-info.md

Contains the branch name created and the base ref used.

Execution

Run the branch preparation script, passing through all arguments:

bash scripts/prepare_branch.sh <ticket> --base-path <base-path> [--draft]

The script handles:

Argument parsing — extracts ticket ID, --base-path, and --draft flag
Draft mode — writes a skip note and exits early if --draft is set
Default branch detection — tries upstream remote first, falls back to origin, detects HEAD branch with fallback to main/master
Uncommitted changes check — stops with an error if working tree is dirty (never force-checkouts)
Fetch — fetches latest from remote; warns but continues if fetch fails (network/auth issues)
Branch creation — creates <ticket-id-lowercase> branch from remote default; switches to existing branch if it already exists
Output — writes branch-info.md with branch name, base ref, and timestamp