Create Draft PR

SkillProductivity

Lets your agent commit code, push it, and open a draft pull request on GitHub.

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

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Create Draft PR skill

About this capability

Commit, push, and create a draft PR using the pr-description format, with UX flow context when relevant.

What this skill tells your AI

The instructions your AI receives, as published by trycompai/crm in .agents/skills/create-draft-pr/SKILL.md and read by ahel’s review.

Commit all changes, push to remote, and create a draft pull request with a focused generated description.

Steps

  1. Run git status to see changes
  2. Run git diff to understand what changed
  3. Run git log to see commit message style
  4. If on main, create a new branch in the format <initials>/<feature> or the project's branch naming convention, then switch to it
  5. Stage and commit changes with a concise message
  6. Push branch to remote with -u flag
  7. Generate the PR description using the pr-description skill's description format.
  8. If the change is user-facing, workflow-oriented, or architectural, include a concise UX flow section using the ux-flow-plan style.
  9. Create draft PR using gh pr create --draft
  10. If you created the branch (were on main), switch back to main after the PR is created

PR Body Format

Use the pr-description skill's format as the base:

## Summary

<One sentence describing the overall change>

- Additional note if needed
- Another note if needed

## Problem

Describe the issue being addressed. What was broken, missing, or suboptimal? Be specific about the root cause.

## Solution

Explain the approach taken to fix the problem. Include code snippets only when they clarify the core approach.

When relevant, add this section between Problem and Solution:

## UX Flow

```text
Current flow
└─ ...

Desired flow
└─ ...
```

Only include UX Flow when it helps explain the product behavior, user journey, or architecture boundary. Keep it short and use the ux-flow-plan tree style.

Rules

  • PR title should be succinct (no "feat:" prefix, but "fix:" is ok for bug fixes)
  • Use pr-description as the source of truth for PR body structure.
  • Include UX Flow from ux-flow-plan only when relevant; omit it for mechanical, dependency, or tiny internal changes.
  • Do NOT include a file-by-file summary of code changes.
  • Do NOT include a test plan with checkboxes.
  • Do NOT include "Generated with Claude Code" or similar footers
  • Keep the PR description concise and focused on intent and approach
  • Use HEREDOC for the PR body to preserve formatting

Signals

GitHub stars
10k
Forks
1k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
create-draft-pr-trycompai
Source
github.com/trycompai/crm