worktree-pr SKILL.md skillA

worktree-pr from scarletkc/agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add scarletkc/agents/worktree-pr@git:20260824.d5a3123

Pins git:20260824.d5a3123 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
scarletkc/agents
Path
skills/worktree-pr/SKILL.md
Versions recorded
5
Latest version
git:20260824.d5a3123, committed Aug 24, 2026
First version recorded
Aug 15, 2026
Size
4,696 bytes
Repository stars
225
License
Apache-2.0

Decide whether a task deserves its own git worktree and, if chosen, run it end to end: branch from the integration branch rather than the current tree, keep the main working copy untouched while the task runs, compare the result against the untouched baseline before declaring it done, and prepare it for a pull request instead of merging. Use when a request says to do the work in a new worktree or branch, when a change is large or risky enough that the main tree should stay usable, when several…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Worktree & PR

A worktree buys two things: the main working copy stays usable while the task
runs, and the untouched copy remains available as a baseline to compare
against. Both are worth real setup cost, and neither applies to every change.

This covers the isolation mechanics. How large the change itself should be is
[`scoped-change`](https://github.com/scarletkc/agents/blob/main/skills/scoped-change/SKILL.md),
and it applies inside a worktree exactly as it does anywhere else.

## Deciding

Consider a worktree when at least one holds: the task is large enough that a
half-finished state would block other work, several tasks need to progress on
the same repository at once, the result has to be compared against current
behavior, or the change is risky enough that abandoning it should cost
nothing.

Skip it when the change is small, self-contained, and reviewable in one pass.
Setting up an isolated copy for a typo fix or a one-line config edit costs
more than it saves, and the extra branch, directory, and PR are all overhead
that someone pays later. When the requester says to work directly on the
current branch, that decision is already made.

## Running
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add scarletkc/agents/worktree-pr@sha256:fafbbc4f786af283

The line at the top of this page pins the label git:20260824.d5a3123, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f5c3o7mlnlth3mjq.svg)](https://markdownregistry.com/a/art_f5c3o7mlnlth3mjq)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 15, 2026 and Aug 24, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260824.d5a3123 latest2026-08-24 d5a3123 4,696 BA view · diff
git:20260820.d4e4f4d2026-08-20 d4e4f4d 4,704 BA view · diff
git:20260815.bca45f22026-08-15 bca45f2 4,657 BA view · diff
git:20260815.59d3a0a2026-08-15 59d3a0a 4,377 BA view · diff
git:20260815.99490672026-08-15 9949067 4,030 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4696 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

scarletkc/agents · 225 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_f5c3o7mlnlth3mjq
GET https://markdownregistry.com/api/v1/resolve?ref=scarletkc/agents/worktree-pr
GET https://markdownregistry.com/api/v1/blob/fafbbc4f786af283b396db39b2de9c75e4abf6accc17a7278e3d9a20fadbc2ad

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from scarletkc/agents

AGENTS.md AGENTS.md file
scarletkc/agents · AGENTS.md
git:20260729.8b4c64c · audit A · 225 stars
CLAUDE.md CLAUDE.md file
scarletkc/agents · CLAUDE.md
git:20260712.c889f7d · audit B · 225 stars
antigravity-cli SKILL.md skill
scarletkc/agents · skills/antigravity-cli/SKILL.md · Delegate bounded investigation, review, or implementation tasks to Antigravity CLI from a supervising agent. Includes a…
git:20260911.6bd4c6a · audit B · 225 stars
ask-to-plan SKILL.md skill
scarletkc/agents · skills/ask-to-plan/SKILL.md · Guide a user from an unclear idea to an actionable plan through the agent harness's native ask tool and clickable…
git:20260912.38254d6 · audit A · 225 stars
codex-cli SKILL.md skill
scarletkc/agents · skills/codex-cli/SKILL.md · When handing work to the Codex CLI earns its cost, and how to size the run: second-model review, bounded implementation…
git:20260824.d5a3123 · audit A · 225 stars
devin-cli SKILL.md skill
scarletkc/agents · skills/devin-cli/SKILL.md · Delegate bounded coding tasks to the local Devin CLI over ACP from a supervising agent such as Claude Code or Codex…
git:20261018.2e55254 · audit B · 225 stars
grok-cli SKILL.md skill
scarletkc/agents · skills/grok-cli/SKILL.md · Delegate bounded tasks to Grok Build from a supervising agent such as Codex. Use when the user asks Grok to…
git:20260911.0fe4be4 · audit B · 225 stars
marketing-copy SKILL.md skill
scarletkc/agents · skills/marketing-copy/SKILL.md · Write outbound promotional copy for a product or project: launch and update posts for community platforms and social…
git:20260824.d5a3123 · audit A · 225 stars
product-writing SKILL.md skill
scarletkc/agents · skills/product-writing/SKILL.md · Write, edit, or review UI copy, CLI messages, help text, code comments, and technical documentation covering product…
git:20260907.7531b02 · audit A · 225 stars
scoped-change SKILL.md skill
scarletkc/agents · skills/scoped-change/SKILL.md · Judgment rules for locating the correct boundary of a requested change: staying inert outside it while completing every…
git:20260824.d5a3123 · audit A · 225 stars
talk-like-scarletkc SKILL.md skill
scarletkc/agents · skills/talk-like-scarletkc/SKILL.md · 按 scarletkc 本人的自然表达习惯代写、改写、润色和翻译文本,适用于推文、评论、聊天消息、模型或工具体验文、项目介绍、GitHub 文本和正式通信。用户要求撰写可直接使用的成稿、去除 AI…
git:20261021.3be29ae · audit A · 225 stars
ux-writing SKILL.md skill
scarletkc/agents · skills/ux-writing/SKILL.md · Judgment rules for user-facing text and docs: CLI and diagnostic output, error and help text, README and docs…
git:20260824.d5a3123 · audit A · 225 stars

Every file in scarletkc/agents

Browse by kind, by grade A, or by owner.