Promote to Main

Promote integration to main with comprehensive changelog and PR creation. Use when user says "promote to main", "open promotion PR", "integration to main", or "create release PR to main". Runs pre-flight checks, change inventory, architecture diagrams, and creates a rich PR with release notes and traceability.

5 stars 1 forksGit & Code Review

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add TalonT-Org/AutoSkillit --skill promote-to-main
Manual install
git clone --depth 1 https://github.com/TalonT-Org/AutoSkillit.git /tmp/AutoSkillit
mkdir -p ~/.claude/skills
cp -r /tmp/AutoSkillit/.claude/skills/promote-to-main ~/.claude/skills/promote-to-main

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Promote to Main

Orchestrate the integration-to-main promotion workflow. This skill discovers everything
that changed on integration since it diverged from main, runs pre-flight quality checks,
performs change inventory, generates architecture diagrams, synthesizes release notes,
and creates a comprehensive promotion PR.

## Arguments

```
/autoskillit:promote-to-main [batch_branch] [base_branch] [--dry-run]
```

- `batch_branch` (optional) — source branch to promote. Defaults to `integration`.
- `base_branch` (optional) — target branch. Defaults to `main`.
- `--dry-run` — generate the full PR body without creating a PR.

## When to Use

- When the develop branch is stable and ready to be promoted to main
- After feature PRs, bug fixes, and cleanup work have been collected and tested on develop
- This is the final gate before changes land on main

## Critical Constraints

**NEVER:**
- Create files outside `.autoskillit/temp/promote-to-main/`
- Modify any source code — this skill is read-only analysis + PR creation
- Fail silently if `gh` is unavailable — output `pr_url = ` (empty) and exit successfully
- Push or merge anything — this skill only creates the PR
- Skip pre-flight checks — a failing pre-flight must block PR creation
- Use the Bash tool for file reads — use Read, Grep, Glob for all codebase inspection
- Use `gh pr create --body` inline — always use `--body-file`

**ALWAYS:**
- Run ALL pre-flight checks before any analysis work
Read the full skill on GitHub

Details

Skill name
promote-to-main
Path
.claude/skills/promote-to-main/SKILL.md
License
MIT
Repo updated
8 November 2026

FAQ

What does the Promote to Main skill do?

Promote integration to main with comprehensive changelog and PR creation. Use when user says "promote to main", "open promotion PR", "integration to main", or "create release PR to main". Runs pre-flight checks, change inventory, architecture diagrams, and creates a rich PR with release notes and traceability.

How do I install the Promote to Main skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add TalonT-Org/AutoSkillit --skill promote-to-main. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Promote to Main popular?

It lives in TalonT-Org/AutoSkillit, which has 5 GitHub stars and 1 forks.

Related skills

Analyze Prs

5

TalonT-Org/AutoSkillit

Analyze all open PRs targeting a base branch — determine merge order, identify file overlaps, and tag each PR as simple or needs_check for complexity. Use at the start of a PR consolidation workflow.

Git & Code Review

Arch Lens C4 Container

5

TalonT-Org/AutoSkillit

Create C4 Container architecture diagram showing static structure, building blocks, and technology choices. Anatomical lens answering "How is it built?

Software Development

Arch Lens Concurrency

5

TalonT-Org/AutoSkillit

Create Concurrency architecture diagram showing parallel execution patterns, thread pools, synchronization, and barriers. Physiological lens answering "How does parallelism work?

Software Development

Resolve Merge Conflicts

5

TalonT-Org/AutoSkillit

Goal-aware resolution of rebase conflicts when merging a conflict-resolution worktree back into the integration branch. Analyzes the intent of each side of a conflict, resolves it in-place when confidence is HIGH or MEDIUM, and escalates when LOW.

Git & Code Review

Process Issues

5

TalonT-Org/AutoSkillit

Execute recipe sessions batch-by-batch for triaged GitHub issues. Reads the triage-issues output manifest, processes each batch sequentially, and launches the appropriate recipe for each issue. Use when user says "process issues", "run issues", or "execute pipeline for issues".

Git & Code Review

Resolve Review

5

TalonT-Org/AutoSkillit

Fetch PR review comments, run intent validation (ACCEPT/REJECT/DISCUSS) before applying fixes, and post inline replies. MCP-only — used exclusively by recipe orchestration via run_skill after review_pr reports changes_requested or needs_human verdict.

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.