Disentinel/grafema / .claude/skills/approve
approve
Verified/approve — Push PR to Auto-Merge
When to Use
User says /approve after reviewing a completed task in a worker worktree.
This replaces the manual merge-to-main workflow.
What It Does
- Pushes current branch to origin
- Creates a PR against main
- Enables auto-merge (GitHub merges automatically when CI passes)
- Updates Linear issue status to "In Review"
Prerequisites
- Must be on a task branch (e.g.,
task/REG-XXX), NOT onmain - Steve Jobs review should have been completed before calling this
Steps
1. Validate State
# Get current branch
BRANCH=$(git branch --show-current)
# Must not be on main
if [ "$BRANCH" = "main" ]; then
echo "ERROR: Cannot approve from main branch"
exit 1
fi
2. Commit Uncommitted Changes (if any)
If there are uncommitted changes (staged or unstaged), commit them all:
- Run
git statusandgit diffto see what's pending - Run
git log --oneline -5to match commit message style - Stage all changed files:
git addspecific files (avoid secrets/.env) - Create a commit with a descriptive message summarizing the changes
- End the commit message with
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
If working tree is clean, skip to next step.
3. Push Branch
git push -u origin "$BRANCH"
4. Create PR
Create PR with title and body derived from the task:
- Title: Extract from Linear issue if REG-XXX is in branch name, otherwise use branch name
- Body: Include summary of changes from commits on this branch (vs main)
# Get commits unique to this branch
git log main..HEAD --oneline
# Create PR
gh pr create --title "..." --body "..."
If PR already exists, skip creation and use existing PR.
5. Enable Auto-Merge
# Get PR number
PR_URL=$(gh pr view --json url --jq '.url')
# Enable auto-merge with merge commit strategy
gh pr merge --auto --merge
This tells GitHub: "merge this PR automatically when all required status checks pass."
6. Update Linear
Extract issue ID from branch name (e.g., task/REG-123 → REG-123).
Update Linear issue status to In Review using mcp__linear__update_issue.
7. Report
Print summary:
- PR URL
- Auto-merge status: enabled
- CI checks: running (will merge when green)
- Linear status: updated to "In Review"
What Happens Next
- GitHub CI runs automatically (Tests, Typecheck & Lint, Build, Version Sync)
- When ALL checks pass → PR auto-merges to main
- If merge conflict → auto-merge fails, GitHub sends notification on the PR
- User resolves conflict by telling worker to rebase:
git rebase main && git push --force-with-lease
Notifications
Conflicts and CI failures appear as:
- GitHub notification (bell icon on github.com)
- Email (if GitHub email notifications enabled)
- Failed status check on the PR page
- Comment on PR explaining the failure reason
Multiple Workers
Multiple workers can /approve simultaneously. Since strict: false is set in branch protection:
- All PRs run CI concurrently against current main
- PRs merge in order as CI completes
- No need to wait for one PR to merge before the next starts CI
- If a merge conflict occurs after another PR merges, only that specific PR needs a rebase
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |