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

Rudder Worktree Preview Maintainer

by Undertone0809 in 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…

Apache-2.0Auto-check passedDevelopment

Install Rudder Worktree Preview Maintainer

skills CLI
$ npx skills add Undertone0809/rudder --skill rudder-worktree-preview-maintainer -a claude-code

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

GitHub CLI
$ gh skill install Undertone0809/rudder rudder-worktree-preview-maintainer --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/Undertone0809/rudder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent-skills-bak/maintainer/rudder-worktree-preview-maintainer .claude/skills/rudder-worktree-preview-maintainer && 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
rudder-worktree-preview-maintainer
GitHub stars
292
Token cost
~2.1k tokens
SKILL.md length
1,047 words
Files
3 (incl. scripts, references)
Skills in repo
30
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • Works in 6 steps: Inspect the current worktree → Choose isolated runtime settings → Use the bundled launcher first → …
  • Starting the current Rudder checkout as a temporary managed local preview with a stable URL
  • SKILL.md covers Use This Skill When, Do Not Use This Skill When, Default Workflow and Cleanup Requests, plus 1 more section
  • Runs Shell scripts from its folder; calls pnpm, bash and git

What it does

Rudder Worktree Preview Maintainer is an agent skill from Undertone0809/rudder. Use 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 of the current branch or worktree.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/runbook.md` and `scripts/start_current_branch_preview.sh`).

It sits in Development, covering Git worktrees. It works with pnpm. The repository describes itself as: Open-source local Agent harness for self-improving agent teams: run agents, review work, and turn feedback into reusable skills. The licence is Apache-2.0.

When your agent uses it

  • Starting the current Rudder checkout as a temporary managed local preview with a stable URL
  • Readiness check
  • Cleanup path for manual inspection of the current branch

Example prompts

  • “/rudder-worktree-preview-maintainer”

Requirements

  • A Bash shell

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Inspect the current worktree
  2. Choose isolated runtime settings
  3. Use the bundled launcher first
  4. Handle startup failures pragmatically
  5. Verify readiness
  6. Hand off the preview

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • pnpm
    • bash
    • git
    • curl

    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 curl, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Rudder Worktree Preview Maintainer loads about 2.1k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 1,047 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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 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); the scripts in this folder are not scanned.

SKILL.md

The full file from Undertone0809/rudder at commit e2ba0f1, republished under its Apache-2.0 licence (© Undertone0809). 1,047 words, ~2,114 tokens.

Download SKILL.mdSave it as .claude/skills/rudder-worktree-preview-maintainer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
rudder-worktree-preview-maintainer
description
Use 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 of the current branch or worktree.

Rudder Worktree Preview Maintainer

Run the current Rudder checkout as a temporary preview so the user can inspect the feature in a browser without leaving a foreground command running.

This skill is for the common post-implementation hand-off: the branch already contains the work, and the user wants a local URL to test. It is not a PR checkout workflow, it is not a broad process cleanup workflow, and it is not the canonical developer environment for Codex-managed worktrees.

Rudder's normal pnpm dev entrypoint is the canonical development path. In Codex-managed worktrees under ~/.codex/worktrees/<id>/<repo>, pnpm dev auto-derives an isolated RUDDER_HOME, instance id, server port, embedded PostgreSQL port, and worktree branding when no repo-local .rudder/ config exists. Use this preview skill only when the user wants a managed background preview handoff with health verification, logs, and a stop command.

Preview readiness is environment proof, not product proof. A healthy URL means the checkout can be opened; it does not prove that a feature, workflow, agent path, or UI regression is fixed. When this skill is used inside a lifecycle handoff or review gate, the owning workflow must still exercise the relevant route, command, agent run, or Desktop/browser interaction and report the observed terminal state.

Use This Skill When

  • The user asks to run the current branch or current worktree locally.
  • The user wants to manually test a recently implemented UI or workflow change.
  • The assistant needs to hand off a stable preview URL after implementation without leaving pnpm dev in the foreground.
  • The user asks for logs, a stop command, or a temporary preview that can be cleaned up independently.
  • The task is to provide a preview URL, not to package Desktop or publish a release.

Do Not Use This Skill When

  • The user asks to check out or preview a GitHub PR; use pr-local-preview-maintainer instead.
  • The user asks only to stop or clean local dev processes; use stop-rudder-dev-maintainer instead.
  • The user is asking why Codex worktrees interfere, how normal development should be isolated, or whether pnpm dev is using the current worktree. In that case inspect scripts/dev-local-env.mjs, doc/engineering/DEVELOPING.md, and the /api/health payload for the active dev runtime.
  • The user simply wants to develop inside the current Codex worktree. Use pnpm dev, which should auto-isolate Codex-managed worktrees, instead of starting a separate /tmp/rudder-worktree-preview instance.
  • The change needs packaged Desktop verification; follow the Desktop validation workflow in the repo docs.
  • The user wants production-like pnpm prod behavior rather than a dev preview.

Default Workflow

1. Inspect the current worktree

Start from the repository root and record the current branch:

bash
git status --short --branch
git branch --show-current

Do not switch branches, reset files, or stop unrelated runtimes. A dirty worktree is normal after implementation work.

2. Choose isolated runtime settings

The preview is intentionally temporary and may use a different instance than the canonical pnpm dev runtime for the same worktree. Tell the user this if they are comparing data between surfaces.

Prefer a branch-derived instance id, a non-default app port, and an isolated RUDDER_HOME under /tmp:

text
RUDDER_INSTANCE_ID=<branch-slug>
PORT=<free-port>
RUDDER_HOME=/tmp/rudder-worktree-preview/<branch-slug>/home

Use 3100 only when the user explicitly asks for the default dev runtime and the port is free. Otherwise choose a free port starting near 3310.

If the user wants the same data and instance as their normal Codex worktree development surface, do not use this launcher by default. Start or inspect pnpm dev instead and verify the /api/health response matches the expected worktree-derived instance id.

If embedded PostgreSQL works, use a free RUDDER_EMBEDDED_POSTGRES_PORT. If embedded PostgreSQL fails in the local environment, use a dedicated external database for this preview instead of reusing another Rudder instance's database.

Show full SKILL.md (454 more words)Show less
3. Use the bundled launcher first

From the repo root:

bash
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh

The launcher:

  • derives an instance id from the current branch
  • finds free app and embedded PostgreSQL ports
  • starts @rudderhq/server with Vite dev middleware
  • uses tmux when available, then launchctl on macOS
  • waits for /api/health
  • prints the URL, logs, and stop command

Useful options:

bash
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh --replace
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh --port 3312
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh --database-url postgres://user:pass@127.0.0.1:5432/dbname
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh --stop

Use --replace only for the same branch-derived preview session. Do not kill ports or process groups that belong to another Rudder worktree.

4. Handle startup failures pragmatically

If readiness fails, inspect the managed logs before responding:

bash
tmux capture-pane -pt rudder-preview-<instance-id> -S -180
tail -180 /tmp/rudder-worktree-preview/<instance-id>/*.log

Fix local startup issues that are clearly environmental, such as occupied ports or missing dependencies. If embedded PostgreSQL fails, create or use an isolated external database and rerun with --database-url; do not point the preview at the user's main dev data unless they explicitly ask for that.

5. Verify readiness

Before handing off, check:

bash
curl -fsS http://127.0.0.1:<port>/api/health

The instanceId in the response should match the preview instance id. If it does not, the URL may belong to another runtime.

For visible UI work, also open the URL in a browser when practical. If browser automation is unavailable or hangs, say that clearly and still provide the health-checked URL.

If the user asked whether a feature works, do not stop at this readiness check. Run or hand back the concrete scenario proof needed for that feature, and label the preview URL as only the environment that made the proof possible.

6. Hand off the preview

Keep the response short and concrete:

text
当前分支已经跑起来了：
http://127.0.0.1:<port>

实例：<instance-id>
日志：<tmux attach or log path>
停止：<stop command>
Health check passed.

Mention when the preview uses a non-default port because 3100 is occupied. Mention when the database is isolated or temporary so the user knows what data they are looking at.

Cleanup Requests

For cleanup, stop only the managed preview for the current branch:

bash
bash .agents/skills/maintainer/rudder-worktree-preview-maintainer/scripts/start_current_branch_preview.sh --stop

Verify the preview port is free afterward. Do not remove worktrees, delete databases, or stop other Rudder sessions unless the user explicitly asks.

Judgment Rules

  • Isolation matters more than preserving the default port.
  • Do not present this skill as the fix for Codex worktree isolation. That belongs in the default pnpm dev environment resolution.
  • Be explicit when this preview uses a temporary /tmp instance that differs from the normal pnpm dev instance for the same checkout.
  • A health-checked URL is the minimum hand-off; logs and a stop command make it usable.
  • Do not present preview readiness as review or validation of the changed workflow unless a separate scenario was exercised and reported.
  • Never stop unrelated Rudder sessions just because they occupy 3100.
  • Do not leave a foreground command running when the user needs a preview after the assistant turn ends; use tmux or a user-level managed process.
  • If the task shifts from previewing to fixing a startup bug, say that and keep source edits scoped.

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

Files

SKILL.md and 2 other files (scripts, references) in agent-skills-bak/maintainer/rudder-worktree-preview-maintainer of Undertone0809/rudder.

  • SKILL.md
  • references/runbook.md
  • scripts/start_current_branch_preview.sh

Open the folder on GitHubat commit e2ba0f1

Compare with similar skills

Rudder Worktree Preview Maintainer 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.

Rudder Worktree Preview Maintainer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rudder Worktree Preview Maintainer this skillUndertone0809/rudder292—~2.1kAutomated safety check: PassApache-2.0
DevSpace Manual QA SetupWaishnav/devspace5.2k—~440Automated safety check: PassMIT
Kanvibe Release Deployrookedsysc/kanvibe143—~12kAutomated safety check: NotesAGPL-3.0
Worktrees and Dev Serverspierrecomputer/pierre6.3k—~573Automated safety check: NotesApache-2.0
Worktreekortix-ai/suna20k—~4.2kAutomated safety check: NotesCustom licence
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 today
    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

  • 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.3k GitHub stars~573 tokensUpdated today
    DevelopmentAuto-check: notes

  • Worktree

    kortix-ai/suna

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

    20k GitHub stars~4.2k 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 today
    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.

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

More from Undertone0809/rudder

All 30 skills in this repo

  • Conversation To Skill

    Undertone0809/rudder

    Turn the current conversation's workflow into a reusable agent skill.

    292 GitHub stars~3.6k tokensUpdated today
    Auto-check passed

  • Stop Rudder Dev Maintainer

    Undertone0809/rudder

    A skill your agent uses when the user explicitly asks to stop, restart, kill, or clean Rudder repo-local pnpm dev processes or local dev runtime residue, including “把 pnpm dev 停了”, “重启 dev”, or “清掉…

    292 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Deep Research

    Undertone0809/rudder

    Conducts enterprise-grade research with multi-source synthesis, citation tracking, and verification.

    292 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Rudder Workspace Hygiene Maintainer

    Undertone0809/rudder

    A skill your agent uses to audit or clean Rudder worktrees, generated artifacts, logs, caches, and repo-owned processes without deleting active work, user data, or unrelated machine state.

    292 GitHub stars~664 tokensUpdated today
    Auto-check passed

  • Visualize

    Undertone0809/rudder

    Create safe inline visual explanations in Rudder Chat. An agent skill from Undertone0809/rudder.

    292 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Advisor Review Loop Maintainer

    Undertone0809/rudder

    A skill your agent uses when Rudder development work needs first-principles advisor analysis plus independent reviewer rounds: proposals, UI/product decisions, architecture, release readiness…

    292 GitHub stars~4.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Rudder Worktree Preview Maintainer

What does Rudder Worktree Preview Maintainer do?

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…. Rudder Worktree Preview Maintainer is an agent skill from Undertone0809/rudder. Use 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 of the current branch or worktree.

When should I use Rudder Worktree Preview Maintainer?

Rudder Worktree Preview Maintainer fits situations like: starting the current Rudder checkout as a temporary managed local preview with a stable URL; readiness check; cleanup path for manual inspection of the current branch.

How do I install Rudder Worktree Preview Maintainer in Claude Code?

Run `npx skills add Undertone0809/rudder --skill rudder-worktree-preview-maintainer -a claude-code`. Or copy the skill folder (agent-skills-bak/maintainer/rudder-worktree-preview-maintainer in Undertone0809/rudder) into .claude/skills/rudder-worktree-preview-maintainer in your project. Claude Code loads it when a task matches its description.

How do I install Rudder Worktree Preview Maintainer in Codex?

Run `npx skills add Undertone0809/rudder --skill rudder-worktree-preview-maintainer -a codex`. Or copy the skill folder (agent-skills-bak/maintainer/rudder-worktree-preview-maintainer in Undertone0809/rudder) into .agents/skills/rudder-worktree-preview-maintainer in your project. Codex loads it when a task matches its description.

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

What does Rudder Worktree Preview Maintainer need to run?

Going by SKILL.md and its folder, Rudder Worktree Preview Maintainer needs a shell for the scripts in its folder and the command-line tools its instructions call (pnpm, bash, git and curl). Our summary lists: A Bash shell.

Does Rudder Worktree Preview Maintainer access the network?

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

Is Rudder Worktree Preview Maintainer 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Rudder Worktree Preview Maintainer use?

Rudder Worktree Preview Maintainer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Rudder Worktree Preview Maintainer use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Rudder Worktree Preview Maintainer?

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

Who maintains Rudder Worktree Preview Maintainer?

Undertone0809 (a GitHub user) maintains it in Undertone0809/rudder, which has 292 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 9, 2026.

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