pr-author-job

Implements pending tasks in isolated branches and opens pull requests via gh.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/arayaroma/ether --skill pr-author-job-arayaroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-author-job
Source: https://github.com/arayaroma/ether/tree/main/skills/pr-author-job
Command: npx skills add https://github.com/arayaroma/ether --skill pr-author-job-arayaroma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Recurring implementation work across multiple repositories requires manual branch creation, test runs, and PR authoring each time. This Skill automates that routine by draining pending pr-author jobs from ether-pro's job store, implementing each task in an isolated branch or worktree, running the target repo's tests, and opening a pull request with gh. ## Core Features & Use Cases - Job queue draining: Pulls pending pr-author jobs from ether-pro's job store and processes each one against its target repository. - Autonomy tier gating: Checks ether job should-confirm before writing, requiring human approval on first runs and recording outcomes so the state machine can promote or demote future runs. - TDD-enforced implementation: Invokes scope estimation and test-driven development for every run, verifies the target repo's test/lint commands pass, and reconciles actual LOC against the estimate before opening the PR. - Use Case: Schedule /loop 1h /pr-author-job or a CronCreate trigger so queued tasks like "fix the null check in the auth handler" are implemented on a branch, tested, and opened as PRs overnight without manual intervention. ## Quick Start Run the PR author job to drain any pending pr-author jobs, implement each task on its own branch, and open pull requests for review.

Frequently Asked Questions about pr-author-job

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically open pull requests for pending tasks?▼

Add jobs with `ether job add --type pr-author --target /path/to/repo --params '{"task":"..."}'`, then invoke the pr-author-job skill directly, via `/loop`, or through CronCreate. Each run drains pending jobs, implements the task on a branch, runs tests, and opens a PR with `gh`.

How do I schedule recurring automated PR creation?▼

Use `/loop <interval> /pr-author-job` for a live session or CronCreate for session-only scheduling that expires after 7 days. For durable unattended operation, use an external scheduler like a systemd user timer or GitHub Actions cron invoking `claude -p "/pr-author-job"` headless.

Does the pr-author job require human approval before writing code?▼

It depends on the autonomy tier. The skill runs `ether job should-confirm --actionType write` first; confirm-tier runs wait for explicit approval, while autonomous-tier runs proceed. First runs against a new target always confirm.

Can the pr-author job work on repositories without a test suite?▼

Yes. TDD is mandatory for every run regardless of the target repo's existing setup. If the target has no test suite, the skill writes the failing test first, which is how a suite gets started, then implements code to make it pass.

What happens if the implementation exceeds the estimated scope?▼

The skill runs `git diff --stat` against the base branch and compares actual LOC to the recorded min/max estimate. If over max, it records the cause and prevention in ether-mem before opening the PR and notes the overrun in the PR body.

Does the pr-author job merge or review its own pull requests?▼

No. It only opens PRs and never merges or self-reviews. Pair it with pr-review-job on the same target, which auto-discovers open PRs and provides an independent review pass.