Disentinel/grafema / .claude/skills/approve
approve
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
SKILL.md
View on GitHub# /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
1. Pushes current branch to origin
2. Creates a PR against main
3. Enables auto-merge (GitHub merges automatically when CI passes)
4. Updates Linear issue status to "In Review"
## Prerequisites
- Must be on a task branch (e.g., `task/REG-XXX`), NOT on `main`
- Steve Jobs review should have been completed before calling this
## Steps
### 1. Validate State
```bash
# 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:
1. Run `git status` and `git diff` to see what's pending
2. Run `git log --oneline -5` to match commit message style
3. Stage all changed files: `git add` specific files (avoid secrets/.env)
4. Create a commit with a descriptive message summarizing the changes
5. 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
```bash
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)
```bash
# 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
```bash
# 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: 198k | 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 |