worktrees SKILL.md skillA

worktrees from kurrent-io/kcap is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kurrent-io/kcap/worktrees@git:20261103.5025b95

Pins git:20261103.5025b95 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kurrent-io/kcap
Path
kcap/skills/worktrees/SKILL.md
Versions recorded
2
Latest version
git:20261103.5025b95, committed Nov 3, 2026
First version recorded
Oct 28, 2026
Size
5,338 bytes
Repository stars
31
License
a license file GitHub does not identify

This skill should be used when git worktrees break across a sandbox or container and its host: you are running in a sandbox, container or VM that mounts the repository from the host; git says `.git file does not reference a repository`; a worktree is missing or `git worktree list` marks it prunable; the host (desktop app, IDE, the user's own git) cannot open a worktree an agent made; or the SessionStart context asks about relative worktree links. Covers enabling and undoing relative 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

# Worktrees across a sandbox and its host

Unless configured otherwise, git links a worktree to its repository by
**absolute path**, in two files:

- `<worktree>/.git` holds `gitdir: /abs/path/.git/worktrees/<name>`
- `.git/worktrees/<name>/gitdir` holds `/abs/path/<worktree>/.git`

A sandbox (container or VM) that mounts the host's filesystem usually sees
the repository at a different path from the host. Each side's absolute links
resolve only on that side, so a worktree made in the sandbox can't be opened
on the host and the other way round. Git on the other side also marks it
prunable, and `git gc` eventually prunes its metadata
(`gc.worktreePruneExpire`, 3 months by default)

## Relative worktree links

Git 2.48 added relative links. Relative links only help when the worktree
and the repository's `.git` sit inside the same mounted tree, which is true
for worktrees under `.capacitor/worktrees/` and `.claude/worktrees/`

**Before enabling, tell the user the cost:** the first relative write sets
`extensions.relativeWorktrees` and raises `core.repositoryformatversion` from
0 to 1. Git older than 2.48 then refuses to open the repository at all, the
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kurrent-io/kcap/worktrees@sha256:bb2f194e8aaf082c

The line at the top of this page pins the label git:20261103.5025b95, 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_cpende3j725bgnw3.svg)](https://markdownregistry.com/a/art_cpende3j725bgnw3)

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

Versions

The registry has recorded 2 versions of this file, between Oct 28, 2026 and Nov 3, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261103.5025b95 latest2026-11-03 5025b95 5,338 BA view · diff
git:20261028.ec40a8c2026-10-28 ec40a8c 5,131 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 (5338 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

kurrent-io/kcap · 31 stars · license a license file GitHub does not identify · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cpende3j725bgnw3
GET https://markdownregistry.com/api/v1/resolve?ref=kurrent-io/kcap/worktrees
GET https://markdownregistry.com/api/v1/blob/bb2f194e8aaf082c25200f28d8825d6dad1f26f9edef1b7053d0c03782ca1446

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 kurrent-io/kcap

CLAUDE.md CLAUDE.md file
kurrent-io/kcap · CLAUDE.md
git:20261031.6163a78 · audit A · 31 stars
kcap-recording SKILL.md skill
kurrent-io/kcap · kcap/muse-assistant/kcap-recording/SKILL.md · Record this user's Muse chats into kcap as private sessions, with their explicit written consent, through `kcap…
git:20261020.c6e5247 · audit A · 31 stars
agent-flows SKILL.md skill
kurrent-io/kcap · kcap/skills/agent-flows/SKILL.md · Use this skill to drive a structured agent *flow*: a separate hosted participant agent runs a definition from the…
git:20261029.ab14ff3 · audit A · 31 stars
connect-capacitor SKILL.md skill
kurrent-io/kcap · kcap/skills/connect-capacitor/SKILL.md · Compatibility redirect to the connect-kcap skill for previously shared links.
git:20261020.c6e5247 · audit A · 31 stars
connect-kcap SKILL.md skill
kurrent-io/kcap · kcap/skills/connect-kcap/SKILL.md · This skill should be used when the user asks to "connect kcap", "set up kcap", "install kcap", "log in to kcap"…
git:20261101.c9b59c2 · audit A · 31 stars
disable SKILL.md skill
kurrent-io/kcap · kcap/skills/disable/SKILL.md · This skill should be used when the user asks to "disable recording", "stop recording", "delete this session", "don't…
git:20260603.b07d25b · audit A · 31 stars
errors SKILL.md skill
kurrent-io/kcap · kcap/skills/errors/SKILL.md · This skill should be used when the user asks to "show errors", "extract errors", "what went wrong", "find tool errors"…
git:20261020.c6e5247 · audit A · 31 stars
eval-watch SKILL.md skill
kurrent-io/kcap · kcap/skills/eval-watch/SKILL.md · Follow a kcap import that setup just started and the evals landing on it — "Follow my kcap import" (the prompt `kcap…
git:20261020.c6e5247 · audit A · 31 stars
guided-tour SKILL.md skill
kurrent-io/kcap · kcap/skills/guided-tour/SKILL.md · Guided tour of kcap for someone who has it installed but does not yet know what it does for them — "what does kcap do…
git:20261026.d563619 · audit A · 31 stars
hide SKILL.md skill
kurrent-io/kcap · kcap/skills/hide/SKILL.md · This skill should be used when the user asks to "hide this session", "make this private", "hide session", "owner only"…
git:20261020.c6e5247 · audit A · 31 stars
pages SKILL.md skill
kurrent-io/kcap · kcap/skills/pages/SKILL.md · This skill should be used whenever the user asks for an artifact, a page, a report, a dashboard, a comparison, a mockup…
git:20261028.50581cb · audit A · 31 stars
plans SKILL.md skill
kurrent-io/kcap · kcap/skills/plans/SKILL.md · This skill should be used whenever you write or read a plan, spec or design document, when you start executing a plan…
git:20261020.c6e5247 · audit A · 31 stars

Every file in kurrent-io/kcap

Other files named worktrees

worktrees SKILL.md skill
kurrent-io/kcap-cli · kcap/skills/worktrees/SKILL.md · This skill should be used when git worktrees break across a sandbox or container and its host: you are running in a…
git:20261028.ec40a8c · audit A · 31 stars

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