New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Worktree

by kortix-ai in kortix-ai/suna

How to do feature work in this repo with git worktrees via pnpm worktree.

Custom licenceAuto-check: notesDevelopment

Install Worktree

skills CLI
$ npx skills add kortix-ai/suna --skill worktree -a claude-code

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

GitHub CLI
$ gh skill install kortix-ai/suna worktree --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/kortix-ai/suna.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/worktree .claude/skills/worktree && 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
worktree
GitHub stars
20k
Token cost
~4.2k tokens
SKILL.md length
2,095 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

How to do feature work in this repo with git worktrees via pnpm worktree.

  • Mentions worktrees
  • SKILL.md covers THE RULE — one canonical…, Agent quick start…, Prerequisite for --db: the… and All commands (non-interactive), plus 3 more sections
  • Calls pnpm, git and stripe; needs STRIPE_SECRET_KEY
  • Isolated/parallel dev instances

What it does

Worktree is an agent skill from kortix-ai/suna. How to do feature work in this repo with git worktrees via pnpm worktree. Each worktree gets its own branch, its own block of app ports, its own nodemodules, and by default shares the primary checkout's standard local Supabase DB for fast setup; pass --db only when a separate Supabase project/data plane is needed. Load WHENEVER starting a feature, bugfix, refactor, experiment, or any change you'll want to run/test in isolation; whenever the user mentions worktrees, isolated/parallel dev instances, running…

Its SKILL.md is about 4.2k 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 Git worktrees. It works with pnpm and Supabase. The repository describes itself as: The open-source AI Operating System.

When your agent uses it

  • Mentions worktrees
  • Isolated/parallel dev instances
  • Running multiple branches at once
  • Spin up a worktree

Example prompts

  • “spin up a worktree”
  • “/worktree”

Requirements

  • Docker
  • A credential in STRIPE_SECRET_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 0b76bd5. 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

    Shell commands in SKILL.md call:

    • pnpm
    • git
    • stripe
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, git and gh, which can reach the network depending on how they are called.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • STRIPE_SECRET_KEY

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

Context cost

Worktree loads about 4.2k tokens when it runs. Until then it costs about 197 tokens; SKILL.md has 2,095 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:151
    IPE_SECRET_KEY` in the worktree's local `.env` (billing won't boot

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,095 words (~4,210 tokens).

“Multi-instance dev environments for this monorepo. One command from a clean checkout provisions a collision-free app stack on its own branch: unique ports for web/api/gateway, its own node_modules + pnpm store, and a tunnel for cloud sandbox callbacks. By default…”

— opening of SKILL.md by kortix-ai, Custom licence
name
worktree

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/worktree of kortix-ai/suna.

Open the folder on GitHubat commit 0b76bd5

Compare with similar skills

Worktree 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.

Worktree compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Worktree this skillkortix-ai/suna20k—~4.2kAutomated safety check: NotesCustom licence
DevSpace Manual QA SetupWaishnav/devspace5.2k—~440Automated safety check: PassMIT
Kanvibe Release Deployrookedsysc/kanvibe143—~12kAutomated safety check: NotesAGPL-3.0
Rudder Worktree Preview MaintainerUndertone0809/rudder292—~2.1kAutomated safety check: PassApache-2.0
Worktrees and Dev Serverspierrecomputer/pierre6.2k—~573Automated safety check: NotesApache-2.0
Verifytheopenco/llmgateway1.7k—~1kAutomated safety check: PassCustom licence

Similar skills

  • DevSpace Manual QA Setup

    Waishnav/devspace

    Prepares the current DevSpace checkout or worktree for isolated local manual QA, covering QA state seeding, UI asset builds and snapshot resets.

    5.2k GitHub stars~440 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Kanvibe Release Deploy

    rookedsysc/kanvibe

    A skill your agent uses whenever releasing or deploying KanVibe desktop from a clean, up-to-date dev checkout: ask only for the target version and release-note approval, then let the AI update…

    143 GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check: notes

  • Rudder Worktree Preview Maintainer

    Undertone0809/rudder

    A skill your agent uses when starting the current Rudder checkout as a temporary managed local preview with a stable URL, readiness check, logs, stop command, and cleanup path for manual inspection…

    292 GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed

  • Worktrees and Dev Servers

    pierrecomputer/pierre

    Explains the Pierre repo's moonx root:wt helper for managed git worktrees, per-worktree port offsets, and cleaning up stale dev servers and test fixtures.

    6.2k GitHub stars~573 tokensUpdated today
    DevelopmentAuto-check: notes

  • Verify

    theopenco/llmgateway

    Build, launch, and drive the LLM Gateway stack in an isolated worktree environment to verify API, gateway, dashboard, playground, or screenshot changes.

    1.7k GitHub stars~1k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Worktree Stack

    LanternOps/breeze

    A skill your agent uses when an agent needs a running, seeded, Playwright-ready Breeze stack for the current git worktree.

    131 GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check: notes

More from kortix-ai/suna

All 19 skills in this repo

  • Ponytail Review

    kortix-ai/suna

    Code review focused exclusively on over-engineering. An agent skill from kortix-ai/suna.

    20k GitHub starsUsed in 4 repos~593 tokens
    Auto-check passed

  • Contributing

    kortix-ai/suna

    The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…

    20k GitHub starsUsed in 1 repo~3k tokens
    Auto-check: warnings

  • Kortix Brand

    kortix-ai/suna

    Load FIRST for anything that carries the Kortix look or voice: product or mobile UI, copy of any kind, decks, social, images, email, CLI output, anything with the logo, and reviews of these.

    20k GitHub stars~4k tokensUpdated today
    Auto-check passed

  • Testing

    kortix-ai/suna

    A skill your agent uses for every Kortix test task, behavior change, bug fix, refactor, API route change, CLI change, SDK change, browser journey, test failure, coverage question, local benchmark…

    20k GitHub stars~3.6k tokensUpdated today
    Auto-check: notes

  • Claude Code

    kortix-ai/suna

    Drive Anthropic's Claude Code CLI (claude -p) as a non-interactive coding sub-agent from inside Codex.

    20k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed

  • Learnings

    kortix-ai/suna

    The project's episodic memory: a timestamped ledger of rules paid for with real outages and near-misses, one entry per incident.

    20k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Worktree

What does Worktree do?

How to do feature work in this repo with git worktrees via pnpm worktree. Worktree is an agent skill from kortix-ai/suna. How to do feature work in this repo with git worktrees via pnpm worktree.

When should I use Worktree?

Worktree fits situations like: mentions worktrees; isolated/parallel dev instances; running multiple branches at once; spin up a worktree.

How do I install Worktree in Claude Code?

Run `npx skills add kortix-ai/suna --skill worktree -a claude-code`. Or copy the skill folder (.agents/skills/worktree in kortix-ai/suna) into .claude/skills/worktree in your project. Claude Code loads it when a task matches its description.

How do I install Worktree in Codex?

Run `npx skills add kortix-ai/suna --skill worktree -a codex`. Or copy the skill folder (.agents/skills/worktree in kortix-ai/suna) into .agents/skills/worktree in your project. Codex loads it when a task matches its description.

Can I use Worktree 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 kortix-ai/suna --skill worktree -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/worktree, .gemini/skills/worktree, .github/skills/worktree and .opencode/skills/worktree in your project.

What does Worktree need to run?

Going by SKILL.md and its folder, Worktree needs the command-line tools its instructions call (pnpm, git, stripe and gh) and credentials named STRIPE_SECRET_KEY. Our summary lists: Docker; A credential in STRIPE_SECRET_KEY.

Does Worktree access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Worktree safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Worktree use?

Worktree has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Worktree use?

About 4.2k tokens (SKILL.md is roughly 17k 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 Worktree?

Skills that share tags, products or a category with Worktree: DevSpace Manual QA Setup (Waishnav/devspace, 5.2k stars), Kanvibe Release Deploy (rookedsysc/kanvibe, 143 stars), Rudder Worktree Preview Maintainer (Undertone0809/rudder, 292 stars) and Worktrees and Dev Servers (pierrecomputer/pierre, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Worktree?

kortix-ai (a GitHub organization) maintains it in kortix-ai/suna, which has 20,258 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

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