Agent skill

Task To PR

by owainlewis in owainlewis/blueprint

Delivers specs or decided tasks as tested, independently reviewed pull requests.

MITAuto-check passedDevelopment

Install Task To PR

skills CLI
$ npx skills add owainlewis/blueprint --skill task-to-pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install owainlewis/blueprint task-to-pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/owainlewis/blueprint.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/task-to-pr .claude/skills/task-to-pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
task-to-pr
GitHub stars
412
Token cost
~1.1k tokens
SKILL.md length
652 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Delivers specs or decided tasks as tested, independently reviewed pull requests.

  • Works in 3 steps: Read the source, repository… → Confirm the outcome, scope, decisions,… → Split larger specs with /plan when…
  • Tasks that involve Pull requests
  • SKILL.md covers Prepare, Deliver and repair, Dependencies and Merge only with authority, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Task To PR is an agent skill from owainlewis/blueprint. Delivers specs or decided tasks as tested, independently reviewed pull requests. Runs the CI and review repair loop, then leaves passing pull requests open unless merging was explicitly authorized.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests. The repository describes itself as: The best agent skills in the world for software development. The licence is MIT.

When your agent uses it

  • Tasks that involve Pull requests

Example prompts

  • “Use the task-to-pr skill to deliver specs or decided tasks as tested, independently reviewed pull requests”
  • “/task-to-pr”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the source, repository instructions, relevant requirements and architecture, code, and tests. Reuse an existing branch, worktree, and…
  2. Confirm the outcome, scope, decisions, and checks are sufficient. If a consequential choice is missing, return to /spec or report the…
  3. Split larger specs with /plan when useful. Each task delivers one working result. Identify dependencies and start independent work…

What it can do on your machine

Read from SKILL.md and the folder at commit 1d74745. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Task To PR loads about 1.1k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 652 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from owainlewis/blueprint at commit 1d74745, republished under its MIT licence (© owainlewis). 652 words, ~1,149 tokens.

Download SKILL.mdSave it as .claude/skills/task-to-pr/SKILL.md (or your agent's skills folder).
name
task-to-pr
description
Delivers specs or decided tasks as tested, independently reviewed pull requests. Runs the CI and review repair loop, then leaves passing pull requests open unless merging was explicitly authorized.
user-invocable
true
argument-hint
<specs, tasks, issues, PRs, or milestone>

Task to PR

Deliver each task as one focused pull request with proof. The spec is the ticket; accept a Markdown spec, GitHub issue, or decided task with acceptance checks. Do not create a second work definition.

Prepare

  1. Read the source, repository instructions, relevant requirements and architecture, code, and tests. Reuse an existing branch, worktree, and pull request when continuing work.
  2. Confirm the outcome, scope, decisions, and checks are sufficient. If a consequential choice is missing, return to /spec or report the needed decision before implementing. Do not write specs for small, decided work.
  3. Split larger specs with /plan when useful. Each task delivers one working result. Identify dependencies and start independent work together when useful.

Deliver and repair

  1. Create or reuse an isolated branch and worktree. Start independent work from the latest remote default branch. Follow repository naming and worktree rules.
  2. Implement the task and meaningful tests for changed behavior and affected failures. Update requirements, architecture, and the spec when the change affects them. Keep intended architecture and implementation status accurate.
  3. Use /test to prove acceptance and affected rules. Fix failures before committing.
  4. Create a Conventional Commit, push, and open or update the pull request. Follow the repository PR template. Lead with the problem and result; include proof and the source link. Mark it ready for review and move a tracker ticket to Review when supported.
  5. Use /review with a fresh subagent that did not implement the change. Wait for configured CI and automated review on the current commit.
  6. Fix valid findings and failures caused by the change. Reply to review findings with the fix or evidence for making no change. Resolve a thread only when fully addressed.
  7. After changing the implementation, repeat affected /test checks and fresh /review, commit, push, and wait for CI and automated review again. Update PR proof. Continue until all available checks pass and no actionable finding remains.
  8. Report a blocker when progress requires a missing decision, permission, unavailable check, or external repair. Do not weaken tests, bypass repository rules, or claim unrun checks passed.
  9. Record final proof and the PR link in the source spec or task. Update delivery status to reflect the actual result, including whether the PR is open or merged. Update the original tracker item when one exists. Leave passing PRs open for human review by default. Pending human approval is a merge blocker, not a failed implementation check.
Show full SKILL.md (241 more words)Show less

Dependencies

Start dependent work only after each prerequisite has an open PR, a fresh Approve review, and no known blocking finding. Stack its branch on the reviewed prerequisite. If there are several prerequisites, combine them in dependency order. Keep each PR diff focused on its own task.

When a prerequisite changes or merges, update dependent branches and PR bases. Repeat affected tests, independent review, and CI against the new base.

Merge only with authority

Explicit /factory or /codex-issue-coordinator use grants their scoped merge authority. Otherwise merge only when the user asks. Automatic skill selection does not grant it. Before merging, require:

  • Complete scope and acceptance proof on the final commit.
  • Passing tests, required CI, and a fresh /review verdict of Approve.
  • No unresolved actionable review finding or consequential decision.
  • Every repository-required approval.
  • A ready, mergeable PR current with its required base.

Merge in dependency order using the repository's preferred method. Never bypass branch protection. Confirm GitHub reports the merge, then update delivery status in the source spec or task and update the original issue and project state. Remove manually created worktrees after merge or close; use the host's lifecycle tools for managed worktrees. Keep open-PR worktrees. Merge authority does not authorize deployment or release publication.

Return

Report each PR, tests, review verdict, CI state, and blocker. Stop with passing PRs open unless scoped merge authority was given. In merge mode, report verified merges and any work that still needs human action.

© owainlewis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/task-to-pr of owainlewis/blueprint.

Open the folder on GitHubat commit 1d74745

Compare with similar skills

Task To PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Task To PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Task To PR this skillowainlewis/blueprint412—~1.1kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Understand Diff AnalysisEgonex-AI/Understand-Anything86k1 repos~1.4kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed

More from owainlewis/blueprint

All 11 skills in this repo
  • Markdown PRD to HTML Renderer

    owainlewis/blueprint

    Converts a complete Markdown PRD or technical design into one verified, static HTML reading page without changing what it says.

    412 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Codex Issue Coordinator

    owainlewis/blueprint

    Lets one Codex thread run a batch of GitHub issues through separate worker threads, each with its own worktree, branch, tested pull request and gated merge.

    412 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Vertical-Slice Task Planner

    owainlewis/blueprint

    Breaks a reviewed spec into ordered, vertical-slice tasks that each fit one agent run and one pull request, grouped into milestones when useful.

    412 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Has a separate agent review a code change without editing it, checking behavior, security, regressions, complexity, tests and docs before merge.

    412 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Architecture

    owainlewis/blueprint

    Designs and maintains root ARCHITECTURE.md for the intended system, including its data model and shared technical rules.

    412 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Architecture Review

    owainlewis/blueprint

    Reviews a technical proposal before implementation through an independent subagent, returning findings, open questions and a verdict without rewriting it.

    412 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Task To PR

What does Task To PR do?

Delivers specs or decided tasks as tested, independently reviewed pull requests. Task To PR is an agent skill from owainlewis/blueprint. Delivers specs or decided tasks as tested, independently reviewed pull requests.

When should I use Task To PR?

Task To PR fits situations like: tasks that involve Pull requests.

How do I install Task To PR in Claude Code?

Run `npx skills add owainlewis/blueprint --skill task-to-pr -a claude-code`. Or copy the skill folder (skills/task-to-pr in owainlewis/blueprint) into .claude/skills/task-to-pr in your project. Claude Code loads it when a task matches its description.

How do I install Task To PR in Codex?

Run `npx skills add owainlewis/blueprint --skill task-to-pr -a codex`. Or copy the skill folder (skills/task-to-pr in owainlewis/blueprint) into .agents/skills/task-to-pr in your project. Codex loads it when a task matches its description.

Can I use Task To PR in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add owainlewis/blueprint --skill task-to-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/task-to-pr, .gemini/skills/task-to-pr, .github/skills/task-to-pr and .opencode/skills/task-to-pr in your project.

What does Task To PR need to run?

SKILL.md names no scripts, command-line tools or credentials: Task To PR is instructions for the agent only.

Does Task To PR access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Task To PR safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Task To PR use?

Task To PR is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Task To PR use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Task To PR?

Skills that share tags, products or a category with Task To PR: Finishing a Development Branch (obra/superpowers, 296k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars) and Understand Diff Analysis (Egonex-AI/Understand-Anything, 86k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Task To PR?

owainlewis (a GitHub user) maintains it in owainlewis/blueprint, which has 412 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

Source: owainlewis/blueprint on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.