promote

SkillDev tools

Lets your agent create a pull request between two branches with a structured changelog for releases.

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

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the promote skill

About this skill

Create a changelog-style promotion PR between two branches. Use for release promotions or branch-to-branch merges with a structured changelog.

What this skill tells your AI

The instructions your AI receives, as published by dedalus-labs/wingman in .agents/skills/promote/SKILL.md and read by ahel’s review.

Context (auto-detected)

  • Commits to promote: !git log --oneline origin/main..HEAD 2>/dev/null || echo "(no commits ahead of main)"

Rules

  • Default: promote current branch → main
  • --from <branch> overrides source (default: current branch)
  • --to <branch> overrides target (default: main)
  • --dry-run prints the PR body without creating it
  • Commits are grouped by conventional commit type into changelog sections

Changelog Sections

PrefixSection
featFeatures
fixBug Fixes
refactorRefactors
perfPerformance
testTests
docsDocumentation
chore, ciChores

Unrecognized prefixes go under Chores.

Task

  1. Parse $ARGUMENTS for --from, --to, --dry-run
  2. Fetch the latest from origin for both branches
  3. Get the commit list: git log --format="%H %s" origin/<to>..origin/<from>
  4. If no commits, report that target is up to date and stop
  5. Build the changelog body:
    • Group commits by section using the table above
    • Each bullet: * **scope:** description ([short-hash](commit-url)) or * description ([short-hash](commit-url)) if unscoped
    • Include a "Full Changelog" comparison link
    • Order sections: Features, Bug Fixes, Refactors, Performance, Tests, Documentation, Chores
  6. If --dry-run, print the body and stop
  7. Create the PR via gh pr create --base <to> --head <from> --title "chore(release): promote <from> → <to>" --body "..."
  8. Return the PR URL

Signals

GitHub stars
182
Forks
6
Last commit
Apr 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Key
promote-dedalus-labs
Source
github.com/dedalus-labs/wingman