gaia-research/gaia-skill-tree / .agents/skills/gaia-preview
gaia-preview
VerifiedUse this skill whenever the user wants to see how their branch will look on the live Gaia website before merging — "preview this branch", "show me what this looks like", "deploy a preview", "trigger a design preview", "can I see the site with these changes", "preview the skill profile", "check how this renders on the site", "spin up a preview deployment". This skill dispatches a Cloudflare Worker preview deployment for the current branch via GitHub Actions — no local build tooling required. Ideal for containerized environments, design reviews, and confirming that newly curated skills or profile pages render correctly before a PR is merged to main. The preview does NOT regenerate docs; it deploys `docs/` from the branch as-is. If your change depends on regenerated Class S artifacts, run `gaia dev docs` and commit those first — the preview then reflects them.
Skill: gaia-preview
Dispatches a Cloudflare Worker preview deployment for the current branch. The deploy uses the branch's docs/ folder as-is — no gaia dev docs step runs on the runner — so what you see is exactly what production would serve if this branch merged.
When to use
- You've made design, layout, or content changes and want to see them live before opening a PR.
- You're working in a container or remote environment where
localhostis unavailable. - You want to verify a newly curated skill or contributor profile renders correctly on the site.
- You've edited
docs/files and want a sanity check before merging.
Steps
-
Push your work. Commit and push all local changes to the current branch. The workflow runs against what's on the remote, so anything uncommitted won't appear in the preview.
-
Dispatch the preview workflow. Run:
gh workflow run cf-pr-preview.yml \ --ref "$(git rev-parse --abbrev-ref HEAD)" \ -f branch="$(git rev-parse --abbrev-ref HEAD)"The
--refselects which copy of the workflow file runs;-f branch=…is the actual branch that gets deployed. In practice these are the same value (the current branch), but the workflow'sbranchinput is a required parameter and must be passed explicitly — omitting it makes the workflow default tomain. -
Report the run + preview URL. After dispatching:
gh run list --workflow=cf-pr-preview.yml --limit 1Give the user the run URL from that output. The preview itself is at a stable workers.dev URL determined by
wrangler.toml'snamefield and the account subdomain — for this project:https://gaia-skill-tree.marco-tngsn.workers.dev/Each successful deploy overwrites the previous one at that URL, so there's only ever one branch previewable at a time. The workers.dev URL is NOT posted as a workflow output; it's constant, and you report it directly. The deploy usually completes in under a minute (48s on the last measured run) — wait for
gh run view <id> --json conclusion -q .conclusionto returnsuccessbefore pointing the user at the URL.
Notes
- Do not use
sync-artifacts.yml -f deploy=true. That workflow is gated ongithub.ref_name == default_branchand silently returnsskippedin ~3 seconds on any non-main branch. It's the production release workflow, not the branch-preview workflow. - The single-slot preview URL is a real constraint. If two people dispatch previews on different branches close together, whichever finished second is what the URL serves. Coordinate before overwriting a coworker's preview.
- The preview will NOT reflect uncommitted regen output. If your branch touches
registry/nodes/orregistry/named/and you haven't committed the Class S artifacts (docs/graph/*— regenerated bygaia dev docs), the preview will render the stale docs. Commit the regen first.
Local inspection (fastest path)
For a quick local look without waiting on the remote build, serve docs/ directly:
python -m http.server 8080 --directory docs
Then open http://localhost:8080/. This serves the static site exactly as GitHub Pages would, minus the Cloudflare Worker badge-validation layer.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |