portfolio
Portfolio screenshot and mockup tools. All three CLI tools are on PATH.
Sub-skills
| Invocation | What it does |
|---|---|
/portfolio screenshot URL |
Capture a headless screenshot at 1320x857px |
/portfolio mockup FILE |
Frame an existing PNG in the portfolio mockup style |
/portfolio capture URL |
Screenshot + mockup in one step (headless) |
/portfolio chrome URL |
Open portfolio-chrome for sites with video/popups |
/portfolio from-browser FILE |
Capture from running portfolio-chrome + mockup |
/portfolio screenshot
Capture a website screenshot using headless Playwright.
portfolio-screenshot <URL> [output.png] [--wait N] [--dismiss-cookies] [--full-page]
- Default output: auto-named from the domain in the current directory
--wait N— extra seconds to wait after load (default 2); increase for slow sites--dismiss-cookies— attempt to click cookie consent banners before capture--full-page— capture full scrollable height instead of viewport
Steps:
- Parse the URL and optional output path from args
- Run
portfolio-screenshot <URL> [output] [flags] - Report the output path
/portfolio mockup
Frame an existing PNG screenshot in the portfolio mockup style.
portfolio-mockup <input.png> [output.jpg]
- Output defaults to
{input-stem}-mockup.jpgalongside the source file - Automatically crops browser chrome artefacts from any edge
- Rounded corners, neutral dark background (RGB 65,70,74), consistent proportions
Steps:
- Resolve the input path
- Run
portfolio-mockup <input.png> [output.jpg] - Report the output path
/portfolio capture
Screenshot + mockup in one step (headless Playwright).
portfolio-screenshot <URL> [output.png] --mockup [--dismiss-cookies] [--wait N]
Steps:
- Parse URL and optional output path from args
- Run
portfolio-screenshot <URL> [output] --mockup [flags] - Report both the PNG and the
-mockup.jpgoutput paths
/portfolio chrome
Launch the portfolio Chrome instance for sites that need a real browser (video hero, stubborn popups, login-gated pages).
portfolio-chrome [URL]
- Opens Chrome at 1320x900 with
--remote-debugging-port=9222 - Uses a dedicated profile (
~/.config/portfolio-chrome-profile) — does not reuse the user's main Chrome - If a URL is given, it opens directly; otherwise Chrome opens to the new-tab page
Steps:
- Run
portfolio-chrome [URL] - Tell the user: "Chrome is open. Navigate to your page, dismiss any overlays, then run
/portfolio from-browser output.png." - Do not wait — Chrome runs in background
/portfolio from-browser
Capture whatever is showing in the running portfolio-chrome window, then apply the mockup.
Requires portfolio-chrome to already be running.
portfolio-screenshot --from-browser <output.png> [--mockup] [--full-page]
Steps:
- Parse the output path from args (required — no auto-naming in CDP mode)
- Run
portfolio-screenshot --from-browser <output.png> --mockup - Report the
-mockup.jpgoutput path
If Chrome is not running, the tool will print an error — tell the user to run /portfolio chrome first.
Notes
- Source:
bain-studio/studio/tools/portfolio-mockup/andstudio/tools/portfolio-screenshot/ - Bins:
/home/bain/bin/portfolio-mockup,/home/bain/bin/portfolio-screenshot,/home/bain/bin/portfolio-chrome - KB doc:
docs/utilities/portfolio-mockup.mdin bain-studio - Finished mockups for iSolarWorkx live in
/media/data/Dropbox/Work/Portfolio/isolarxworks/final/