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

Berth Preview

by sean-brydon in sean-brydon/berthd

Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTHPORT, check it answers, and open it as a browser tab next to your terminal…

MITAuto-check passedDevelopment

Install Berth Preview

skills CLI
$ npx skills add sean-brydon/berthd --skill berth-preview -a claude-code

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

GitHub CLI
$ gh skill install sean-brydon/berthd berth-preview --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/sean-brydon/berthd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/internal/integrations/skills/berth-preview .claude/skills/berth-preview && 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
berth-preview
GitHub stars
286
Token cost
~551 tokens
SKILL.md length
207 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTHPORT, check it answers, and open it as a browser tab next to your terminal…

  • Works in 3 steps: Run it on the worktree's port → Check it answers → Show it to the user
  • Anything with a page
  • SKILL.md covers 1. Run it on the worktree's port, 2. Check it answers and 3. Show it to the user
  • Calls curl

What it does

Berth Preview is an agent skill from sean-brydon/berthd. Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTHPORT, check it answers, and open it as a browser tab next to your terminal with berthd preview. Use when you change UI or anything with a page, when the user asks to see, preview, open or check something in the browser, or when you want them to look at your work.

Its SKILL.md is about 550 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. The repository describes itself as: Run coding agents on your dev boxes: worktrees, terminals, orchestration, kits and automations, with a desktop app. The licence is MIT.

When your agent uses it

  • Anything with a page
  • The user asks to see
  • Check something in the browser
  • You want them to look at your work

Example prompts

  • “/berth-preview”

Workflow steps

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

  1. Run it on the worktree's port
  2. Check it answers
  3. Show it to the user

What it can do on your machine

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

    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use 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

Berth Preview loads about 551 tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 207 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from sean-brydon/berthd at commit fc5b184, republished under its MIT licence (© sean-brydon). 207 words, ~551 tokens.

Download SKILL.mdSave it as .claude/skills/berth-preview/SKILL.md (or your agent's skills folder).
name
berth-preview
description
Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTH_PORT, check it answers, and open it as a browser tab next to your terminal with `berthd preview`. Use when you change UI or anything with a page, when the user asks to see, preview, open or check something in the browser, or when you want them to look at your work.

Previewing with berth

Every worktree has its own ports ($BERTH_PORT, $BERTH_PORT_1, …). The user's Shipyard app reaches whatever listens in that block at the worktree's own address, e.g. http://fix-login.shop.devl.localhost:1377/. No forwarding or tunnels are needed.

1. Run it on the worktree's port

If the repository defines a service (see berthd service list $BERTH_LOCATION/$BERTH_WORKTREE_NAME), start it:

sh
berthd service start "$BERTH_LOCATION/$BERTH_WORKTREE_NAME" web

Otherwise start the dev server yourself in a terminal the user can see, bound to the worktree's port:

sh
berthd session new "$BERTH_LOCATION/$BERTH_WORKTREE_NAME" -- pnpm dev --port $BERTH_PORT

Most frameworks take a port flag (--port, -p) or read PORT. Listen on 127.0.0.1 or 0.0.0.0, not a fixed port like 3000, which another worktree may already use.

2. Check it answers

sh
curl -sf -o /dev/null -w '%{http_code}\n' http://127.0.0.1:$BERTH_PORT/
berthd services --json        # the port should be listed under this worktree

If it is not up, read the server's output (berthd session screen NAME or berthd service log …) and fix that first.

3. Show it to the user

sh
berthd preview                         # this worktree's port, its home page
berthd preview $BERTH_PORT --path /account/orders

This opens the page as a browser tab in the user's Shipyard app, in this worktree's workspace, beside your terminal. It does nothing visible when the app is closed, so also tell the user what to look at and where. From a laptop: berth preview BOX/LOC/WORKTREE [PORT] [--path /x].

Do not use berthd share to show work: it makes the page public on the internet. Only share when the user explicitly asks for a public link.

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

Files

Just SKILL.md in internal/integrations/skills/berth-preview of sean-brydon/berthd.

Open the folder on GitHubat commit fc5b184

Compare with similar skills

Berth Preview 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.

Berth Preview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Berth Preview this skillsean-brydon/berthd286—~551Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT
Git Worktree Cleanuplobehub/lobehub83k—~2.8kAutomated safety check: PassCustom licence
Keep Codex Fastvibeforge1111/keep-codex-fast1.6k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

  • Finishing A Development Branch

    farm-fe/farm

    A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed

  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed

  • Keep Codex Fast

    vibeforge1111/keep-codex-fast

    A skill your agent uses when Codex feels slow or bloated, when local sessions/logs/worktrees/config have grown over time, or when a user wants safe maintenance for Codex Desktop/CLI state.

    1.6k GitHub stars~3.1k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed

  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from sean-brydon/berthd

All 10 skills in this repo

  • Berth

    sean-brydon/berthd

    Use berth to work across development boxes — list repos (locations) and their worktrees, make a worktree or a task (a worktree with an agent in it), start or read terminal sessions, find which port…

    286 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Berth Artifacts

    sean-brydon/berthd

    Show the user data as a chart, table, diagram, notes or one small page in their Shipyard app instead of a wall of text — write a berth.chart JSON, a CSV, Mermaid, Markdown or a self-contained HTML…

    286 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes

  • Berth Browser

    sean-brydon/berthd

    Use your worktree's own page in a headless browser on the box — open it, read a compact snapshot with @refs, click, fill, press keys, wait, take a screenshot to a file, read console errors, and set…

    286 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Berth Hooks

    sean-brydon/berthd

    Automate berth with hooks — run a command when something happens (an agent finishes or needs the user, a worktree is created or removed, a session starts) or gate an action with a before: hook that…

    286 GitHub stars~944 tokensUpdated today
    Auto-check passed

  • Berth Orchestrate

    sean-brydon/berthd

    Drive other coding agents through berth — prompt a running agent, wait for its turn to end, run a check in its worktree, loop until a check passes, hand work to a fresh agent in a new worktree, ask…

    286 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Berth Visual Diff

    sean-brydon/berthd

    Check what your change did to a web app's pages before you say you're done — berthd shots compare screenshots your worktree's dev server and the main checkout's at phone, tablet and desktop widths…

    286 GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Berth Preview

What does Berth Preview do?

Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTHPORT, check it answers, and open it as a browser tab next to your terminal…. Berth Preview is an agent skill from sean-brydon/berthd. Run a worktree's dev server on its own port and show the page to the user in their Shipyard app — start the app on $BERTHPORT, check it answers, and open it as a browser tab next to your terminal with berthd preview.

When should I use Berth Preview?

Berth Preview fits situations like: anything with a page; the user asks to see; check something in the browser; you want them to look at your work.

How do I install Berth Preview in Claude Code?

Run `npx skills add sean-brydon/berthd --skill berth-preview -a claude-code`. Or copy the skill folder (internal/integrations/skills/berth-preview in sean-brydon/berthd) into .claude/skills/berth-preview in your project. Claude Code loads it when a task matches its description.

How do I install Berth Preview in Codex?

Run `npx skills add sean-brydon/berthd --skill berth-preview -a codex`. Or copy the skill folder (internal/integrations/skills/berth-preview in sean-brydon/berthd) into .agents/skills/berth-preview in your project. Codex loads it when a task matches its description.

Can I use Berth Preview 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 sean-brydon/berthd --skill berth-preview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/berth-preview, .gemini/skills/berth-preview, .github/skills/berth-preview and .opencode/skills/berth-preview in your project.

What does Berth Preview need to run?

Going by SKILL.md and its folder, Berth Preview needs the command-line tools its instructions call (curl).

Does Berth Preview access the network?

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

Is Berth Preview 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. Review the folder before installing.

What licence does Berth Preview use?

Berth Preview is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Berth Preview use?

About 551 tokens (SKILL.md is roughly 2.2k 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 Berth Preview?

Skills that share tags, products or a category with Berth Preview: Finishing a Development Branch (obra/superpowers, 297k stars), Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), Finishing A Development Branch (farm-fe/farm, 5.6k stars) and Git Worktree Cleanup (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Berth Preview?

sean-brydon (a GitHub user) maintains it in sean-brydon/berthd, which has 286 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.

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