worktree-isolate SKILL.md skillA
worktree-isolate from open-octo/octo-agent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add open-octo/octo-agent/worktree-isolate@git:20260529.dc2cb1ePins git:20260529.dc2cb1e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- open-octo/octo-agent
- Path
internal/skills/defaults/worktree-isolate/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260529.dc2cb1e, committed May 29, 2026
- Size
- 3,229 bytes
- Repository stars
- 142
- License
- MIT
Do risky or experimental work in an isolated git worktree, then merge or discard. Use when the user wants changes tried in isolation ("试在 worktree 里改", "隔离环境跑一下", "worktree 隔离", "在临时分支上做"), or before a large/uncertain edit that shouldn't touch the main checkout. Trailing text is the task to perform in the worktree.
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
# Work in an isolated git worktree Create a throwaway git worktree on a new branch, do all the work there, verify, then either merge it back or remove it. octo has **no session-level working directory** — so the one rule that makes this work is: **address the worktree by absolute path in every tool call.** ## ⚠️ The absolute-path rule (octo-specific — read first) octo's `terminal` runs each command in a **fresh shell** in the **process's launch directory**; a `cd` does **not** carry to the next `terminal` call, and `read_file` / `edit_file` / `write_file` resolve relative paths against that same fixed directory. There is no "the session is now inside the worktree" mode. Therefore, after creating the worktree: - **Shell:** use `git -C "$WT" …` and absolute paths, or chain everything inside ONE command: `cd "$WT" && go build ./... && go test ./...`. Never split `cd "$WT"` from the work into separate `terminal` calls. - **Files:** always pass the worktree's **absolute path** to read_file / edit_file / write_file (e.g. `$WT/internal/foo.go`), never a bare relative path. Resolve `$WT` to a real absolute path once and reuse it verbatim. ## Steps 1. **Locate the repo and base.** …
Read the whole file at its exact version.
How to install
mdr add open-octo/octo-agent/worktree-isolate@sha256:ab77daf1981a9e3aThe line at the top of this page pins the label git:20260529.dc2cb1e, 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.
[](https://markdownregistry.com/a/art_v5jfck7ipmiguhak)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on May 29, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3229 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
open-octo/octo-agent · 142 stars · license MIT · pushed 2026-11-04 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_v5jfck7ipmiguhak GET https://markdownregistry.com/api/v1/resolve?ref=open-octo/octo-agent/worktree-isolate GET https://markdownregistry.com/api/v1/blob/ab77daf1981a9e3a0ad94bb64d03517adf5460ff059f8d2e4e4c1d0dfbf40cf8
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.