[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6QSSJ8MWHMJ756Z5JC4DD77":3,"skill-same:01M6QSSJ8MWHMJ756Z5JC4DD77":79},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":54,"repositoryHtmlUrl":55,"repositoryHomepageUrl":6,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":6,"updatedAt":58,"install":59,"resources":72},"01M6QSSJ8MWHMJ756Z5JC4DD77","benchmark",null,"Performance regression detection using the browse daemon. Establishes\nbaselines for page load times, Core Web Vitals, and resource sizes.\nCompares before\u002Fafter on every PR. Tracks performance trends over time.\nUse when: \"performance\", \"benchmark\", \"page speed\", \"lighthouse\", \"web vitals\",\n\"bundle size\", \"load time\". (gstack)\nVoice triggers (speech-to-text aliases): \"speed test\", \"check performance\".","esopian\u002Fblue-oak-audit","esopian","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4691748?v=4","01M6QSNF0QB0M7KGHD0M42Y42C","Evan Mallory","01M6QSNF6Y0HD86QKJ4WNVW1KY",2,"MIT","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fgstack\u002Fbenchmark\u002FSKILL.md",[],[5,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"page","vitals","for","tracks","daemon","triggers","time","gstack","write","read","performance","bundle size","regression","text","Bash","browse","speech","core","pr","2026-11-10 10:12:30",false,"---\nname: benchmark\npreamble-tier: 1\nversion: 1.0.0\ndescription: |\n  Performance regression detection using the browse daemon. Establishes\n  baselines for page load times, Core Web Vitals, and resource sizes.\n  Compares before\u002Fafter on every PR. Tracks performance trends over time.\n  Use when: \"performance\", \"benchmark\", \"page speed\", \"lighthouse\", \"web vitals\",\n  \"bundle size\", \"load time\". (gstack)\n  Voice triggers (speech-to-text aliases): \"speed test\", \"check performance\".\nallowed-tools:\n  - Bash\n  - Read\n  - Write\n  - Glob\n  - AskUserQuestion\n---\n\u003C!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->\n\u003C!-- Regenerate: bun run gen:skill-docs -->\n\n## Preamble (run first)\n\n```bash\n_UPD=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-update-check 2>\u002Fdev\u002Fnull || .claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-update-check 2>\u002Fdev\u002Fnull || true)\n[ -n \"$_UPD\" ] && echo \"$_UPD\" || true\nmkdir -p ~\u002F.gstack\u002Fsessions\ntouch ~\u002F.gstack\u002Fsessions\u002F\"$PPID\"\n_SESSIONS=$(find ~\u002F.gstack\u002Fsessions -mmin -120 -type f 2>\u002Fdev\u002Fnull | wc -l | tr -d ' ')\nfind ~\u002F.gstack\u002Fsessions -mmin +120 -type f -exec rm {} + 2>\u002Fdev\u002Fnull || true\n_PROACTIVE=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get proactive 2>\u002Fdev\u002Fnull || echo \"true\")\n_PROACTIVE_PROMPTED=$([ -f ~\u002F.gstack\u002F.proactive-prompted ] && echo \"yes\" || echo \"no\")\n_BRANCH=$(git branch --show-current 2>\u002Fdev\u002Fnull || echo \"unknown\")\necho \"BRANCH: $_BRANCH\"\n_SKILL_PREFIX=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get skill_prefix 2>\u002Fdev\u002Fnull || echo \"false\")\necho \"PROACTIVE: $_PROACTIVE\"\necho \"PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED\"\necho \"SKILL_PREFIX: $_SKILL_PREFIX\"\nsource \u003C(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-repo-mode 2>\u002Fdev\u002Fnull) || true\nREPO_MODE=${REPO_MODE:-unknown}\necho \"REPO_MODE: $REPO_MODE\"\n_LAKE_SEEN=$([ -f ~\u002F.gstack\u002F.completeness-intro-seen ] && echo \"yes\" || echo \"no\")\necho \"LAKE_INTRO: $_LAKE_SEEN\"\n_TEL=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get telemetry 2>\u002Fdev\u002Fnull || true)\n_TEL_PROMPTED=$([ -f ~\u002F.gstack\u002F.telemetry-prompted ] && echo \"yes\" || echo \"no\")\n_TEL_START=$(date +%s)\n_SESSION_ID=\"$$-$(date +%s)\"\necho \"TELEMETRY: ${_TEL:-off}\"\necho \"TEL_PROMPTED: $_TEL_PROMPTED\"\nmkdir -p ~\u002F.gstack\u002Fanalytics\nif [ \"$_TEL\" != \"off\" ]; then\necho '{\"skill\":\"benchmark\",\"ts\":\"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'\",\"repo\":\"'$(basename \"$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || echo \"unknown\")'\"}'  >> ~\u002F.gstack\u002Fanalytics\u002Fskill-usage.jsonl 2>\u002Fdev\u002Fnull || true\nfi\n# zsh-compatible: use find instead of glob to avoid NOMATCH error\nfor _PF in $(find ~\u002F.gstack\u002Fanalytics -maxdepth 1 -name '.pending-*' 2>\u002Fdev\u002Fnull); do\n  if [ -f \"$_PF\" ]; then\n    if [ \"$_TEL\" != \"off\" ] && [ -x \"~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log\" ]; then\n      ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id \"$_SESSION_ID\" 2>\u002Fdev\u002Fnull || true\n    fi\n    rm -f \"$_PF\" 2>\u002Fdev\u002Fnull || true\n  fi\n  break\ndone\n# Learnings count\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || true\n_LEARN_FILE=\"${GSTACK_HOME:-$HOME\u002F.gstack}\u002Fprojects\u002F${SLUG:-unknown}\u002Flearnings.jsonl\"\nif [ -f \"$_LEARN_FILE\" ]; then\n  _LEARN_COUNT=$(wc -l \u003C \"$_LEARN_FILE\" 2>\u002Fdev\u002Fnull | tr -d ' ')\n  echo \"LEARNINGS: $_LEARN_COUNT entries loaded\"\n  if [ \"$_LEARN_COUNT\" -gt 5 ] 2>\u002Fdev\u002Fnull; then\n    ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-learnings-search --limit 3 2>\u002Fdev\u002Fnull || true\n  fi\nelse\n  echo \"LEARNINGS: 0\"\nfi\n# Session timeline: record skill start (local-only, never sent anywhere)\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-timeline-log '{\"skill\":\"benchmark\",\"event\":\"started\",\"branch\":\"'\"$_BRANCH\"'\",\"session\":\"'\"$_SESSION_ID\"'\"}' 2>\u002Fdev\u002Fnull &\n# Check if CLAUDE.md has routing rules\n_HAS_ROUTING=\"no\"\nif [ -f CLAUDE.md ] && grep -q \"## Skill routing\" CLAUDE.md 2>\u002Fdev\u002Fnull; then\n  _HAS_ROUTING=\"yes\"\nfi\n_ROUTING_DECLINED=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get routing_declined 2>\u002Fdev\u002Fnull || echo \"false\")\necho \"HAS_ROUTING: $_HAS_ROUTING\"\necho \"ROUTING_DECLINED: $_ROUTING_DECLINED\"\n# Vendoring deprecation: detect if CWD has a vendored gstack copy\n_VENDORED=\"no\"\nif [ -d \".claude\u002Fskills\u002Fgstack\" ] && [ ! -L \".claude\u002Fskills\u002Fgstack\" ]; then\n  if [ -f \".claude\u002Fskills\u002Fgstack\u002FVERSION\" ] || [ -d \".claude\u002Fskills\u002Fgstack\u002F.git\" ]; then\n    _VENDORED=\"yes\"\n  fi\nfi\necho \"VENDORED_GSTACK: $_VENDORED\"\n# Detect spawned session (OpenClaw or other orchestrator)\n[ -n \"$OPENCLAW_SESSION\" ] && echo \"SPAWNED_SESSION: true\" || true\n```\n\nIf `PROACTIVE` is `\"false\"`, do not proactively suggest gstack skills AND do not\nauto-invoke skills based on conversation context. Only run skills the user explicitly\ntypes (e.g., \u002Fqa, \u002Fship). If you would have auto-invoked a skill, instead briefly say:\n\"I think \u002Fskillname might help here — want me to run it?\" and wait for confirmation.\nThe user opted out of proactive behavior.\n\nIf `SKILL_PREFIX` is `\"true\"`, the user has namespaced skill names. When suggesting\nor invoking other gstack skills, use the `\u002Fgstack-` prefix (e.g., `\u002Fgstack-qa` instead\nof `\u002Fqa`, `\u002Fgstack-ship` instead of `\u002Fship`). Disk paths are unaffected — always use\n`~\u002F.claude\u002Fskills\u002Fgstack\u002F[skill-name]\u002FSKILL.md` for reading skill files.\n\nIf output shows `UPGRADE_AVAILABLE \u003Cold> \u003Cnew>`: read `~\u002F.claude\u002Fskills\u002Fgstack\u002Fgstack-upgrade\u002FSKILL.md` and follow the \"Inline upgrade flow\" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). If `JUST_UPGRADED \u003Cfrom> \u003Cto>`: tell user \"Running gstack v{to} (just updated!)\" and continue.\n\nIf `LAKE_INTRO` is `no`: Before continuing, introduce the Completeness Principle.\nTell the user: \"gstack follows the **Boil the Lake** principle — always do the complete\nthing when AI makes the marginal cost near-zero. Read more: https:\u002F\u002Fgarryslist.org\u002Fposts\u002Fboil-the-ocean\"\nThen offer to open the essay in their default browser:\n\n```bash\nopen https:\u002F\u002Fgarryslist.org\u002Fposts\u002Fboil-the-ocean\ntouch ~\u002F.gstack\u002F.completeness-intro-seen\n```\n\nOnly run `open` if the user says yes. Always run `touch` to mark as seen. This only happens once.\n\nIf `TEL_PROMPTED` is `no` AND `LAKE_INTRO` is `yes`: After the lake intro is handled,\nask the user about telemetry. Use AskUserQuestion:\n\n> Help gstack get better! Community mode shares usage data (which skills you use, how long\n> they take, crash info) with a stable device ID so we can track trends and fix bugs faster.\n> No code, file paths, or repo names are ever sent.\n> Change anytime with `gstack-config set telemetry off`.\n\nOptions:\n- A) Help gstack get better! (recommended)\n- B) No thanks\n\nIf A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry community`\n\nIf B: ask a follow-up AskUserQuestion:\n\n> How about anonymous mode? We just learn that *someone* used gstack — no unique ID,\n> no way to connect sessions. Just a counter that helps us know if anyone's out there.\n\nOptions:\n- A) Sure, anonymous is fine\n- B) No thanks, fully off\n\nIf B→A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry anonymous`\nIf B→B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry off`\n\nAlways run:\n```bash\ntouch ~\u002F.gstack\u002F.telemetry-prompted\n```\n\nThis only happens once. If `TEL_PROMPTED` is `yes`, skip this entirely.\n\nIf `PROACTIVE_PROMPTED` is `no` AND `TEL_PROMPTED` is `yes`: After telemetry is handled,\nask the user about proactive behavior. Use AskUserQuestion:\n\n> gstack can proactively figure out when you might need a skill while you work —\n> like suggesting \u002Fqa when you say \"does this work?\" or \u002Finvestigate when you hit\n> a bug. We recommend keeping this on — it speeds up every part of your workflow.\n\nOptions:\n- A) Keep it on (recommended)\n- B) Turn it off — I'll type \u002Fcommands myself\n\nIf A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set proactive true`\nIf B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set proactive false`\n\nAlways run:\n```bash\ntouch ~\u002F.gstack\u002F.proactive-prompted\n```\n\nThis only happens once. If `PROACTIVE_PROMPTED` is `yes`, skip this entirely.\n\nIf `HAS_ROUTING` is `no` AND `ROUTING_DECLINED` is `false` AND `PROACTIVE_PROMPTED` is `yes`:\nCheck if a CLAUDE.md file exists in the project root. If it does not exist, create it.\n\nUse AskUserQuestion:\n\n> gstack works best when your project's CLAUDE.md includes skill routing rules.\n> This tells Claude to use specialized workflows (like \u002Fship, \u002Finvestigate, \u002Fqa)\n> instead of answering directly. It's a one-time addition, about 15 lines.\n\nOptions:\n- A) Add routing rules to CLAUDE.md (recommended)\n- B) No thanks, I'll invoke skills manually\n\nIf A: Append this section to the end of CLAUDE.md:\n\n```markdown\n\n## Skill routing\n\nWhen the user's request matches an available skill, ALWAYS invoke it using the Skill\ntool as your FIRST action. Do NOT answer directly, do NOT use other tools first.\nThe skill has specialized workflows that produce better results than ad-hoc answers.\n\nKey routing rules:\n- Product ideas, \"is this worth building\", brainstorming → invoke office-hours\n- Bugs, errors, \"why is this broken\", 500 errors → invoke investigate\n- Ship, deploy, push, create PR → invoke ship\n- QA, test the site, find bugs → invoke qa\n- Code review, check my diff → invoke review\n- Update docs after shipping → invoke document-release\n- Weekly retro → invoke retro\n- Design system, brand → invoke design-consultation\n- Visual audit, design polish → invoke design-review\n- Architecture review → invoke plan-eng-review\n- Save progress, checkpoint, resume → invoke checkpoint\n- Code quality, health check → invoke health\n```\n\nThen commit the change: `git add CLAUDE.md && git commit -m \"chore: add gstack skill routing rules to CLAUDE.md\"`\n\nIf B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set routing_declined true`\nSay \"No problem. You can add routing rules later by running `gstack-config set routing_declined false` and re-running any skill.\"\n\nThis only happens once per project. If `HAS_ROUTING` is `yes` or `ROUTING_DECLINED` is `true`, skip this entirely.\n\nIf `VENDORED_GSTACK` is `yes`: This project has a vendored copy of gstack at\n`.claude\u002Fskills\u002Fgstack\u002F`. Vendoring is deprecated. We will not keep vendored copies\nup to date, so this project's gstack will fall behind.\n\nUse AskUserQuestion (one-time per project, check for `~\u002F.gstack\u002F.vendoring-warned-$SLUG` marker):\n\n> This project has gstack vendored in `.claude\u002Fskills\u002Fgstack\u002F`. Vendoring is deprecated.\n> We won't keep this copy up to date, so you'll fall behind on new features and fixes.\n>\n> Want to migrate to team mode? It takes about 30 seconds.\n\nOptions:\n- A) Yes, migrate to team mode now\n- B) No, I'll handle it myself\n\nIf A:\n1. Run `git rm -r .claude\u002Fskills\u002Fgstack\u002F`\n2. Run `echo '.claude\u002Fskills\u002Fgstack\u002F' >> .gitignore`\n3. Run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-team-init required` (or `optional`)\n4. Run `git add .claude\u002F .gitignore CLAUDE.md && git commit -m \"chore: migrate gstack from vendored to team mode\"`\n5. Tell the user: \"Done. Each developer now runs: `cd ~\u002F.claude\u002Fskills\u002Fgstack && .\u002Fsetup --team`\"\n\nIf B: say \"OK, you're on your own to keep the vendored copy up to date.\"\n\nAlways run (regardless of choice):\n```bash\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || true\ntouch ~\u002F.gstack\u002F.vendoring-warned-${SLUG:-unknown}\n```\n\nThis only happens once per project. If the marker file exists, skip entirely.\n\nIf `SPAWNED_SESSION` is `\"true\"`, you are running inside a session spawned by an\nAI orchestrator (e.g., OpenClaw). In spawned sessions:\n- Do NOT use AskUserQuestion for interactive prompts. Auto-choose the recommended option.\n- Do NOT run upgrade checks, telemetry prompts, routing injection, or lake intro.\n- Focus on completing the task and reporting results via prose output.\n- End with a completion report: what shipped, decisions made, anything uncertain.\n\n## Voice\n\n**Tone:** direct, concrete, sharp, never corporate, never academic. Sound like a builder, not a consultant. Name the file, the function, the command. No filler, no throat-clearing.\n\n**Writing rules:** No em dashes (use commas, periods, \"...\"). No AI vocabulary (delve, crucial, robust, comprehensive, nuanced, etc.). Short paragraphs. End with what to do.\n\nThe user always has context you don't. Cross-model agreement is a recommendation, not a decision — the user decides.\n\n## Completion Status Protocol\n\nWhen completing a skill workflow, report status using one of:\n- **DONE** — All steps completed successfully. Evidence provided for each claim.\n- **DONE_WITH_CONCERNS** — Completed, but with issues the user should know about. List each concern.\n- **BLOCKED** — Cannot proceed. State what is blocking and what was tried.\n- **NEEDS_CONTEXT** — Missing information required to continue. State exactly what you need.\n\n### Escalation\n\nIt is always OK to stop and say \"this is too hard for me\" or \"I'm not confident in this result.\"\n\nBad work is worse than no work. You will not be penalized for escalating.\n- If you have attempted a task 3 times without success, STOP and escalate.\n- If you are uncertain about a security-sensitive change, STOP and escalate.\n- If the scope of work exceeds what you can verify, STOP and escalate.\n\nEscalation format:\n```\nSTATUS: BLOCKED | NEEDS_CONTEXT\nREASON: [1-2 sentences]\nATTEMPTED: [what you tried]\nRECOMMENDATION: [what the user should do next]\n```\n\n## Operational Self-Improvement\n\nBefore completing, reflect on this session:\n- Did any commands fail unexpectedly?\n- Did you take a wrong approach and have to backtrack?\n- Did you discover a project-specific quirk (build order, env vars, timing, auth)?\n- Did something take longer than expected because of a missing flag or config?\n\nIf yes, log an operational learning for future sessions:\n\n```bash\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-learnings-log '{\"skill\":\"SKILL_NAME\",\"type\":\"operational\",\"key\":\"SHORT_KEY\",\"insight\":\"DESCRIPTION\",\"confidence\":N,\"source\":\"observed\"}'\n```\n\nReplace SKILL_NAME with the current skill name. Only log genuine operational discoveries.\nDon't log obvious things or one-time transient errors (network blips, rate limits).\nA good test: would knowing this save 5+ minutes in a future session? If yes, log it.\n\n## Telemetry (run last)\n\nAfter the skill workflow completes (success, error, or abort), log the telemetry event.\nDetermine the skill name from the `name:` field in this file's YAML frontmatter.\nDetermine the outcome from the workflow result (success if completed normally, error\nif it failed, abort if the user interrupted).\n\n**PLAN MODE EXCEPTION — ALWAYS RUN:** This command writes telemetry to\n`~\u002F.gstack\u002Fanalytics\u002F` (user config directory, not project files). The skill\npreamble already writes to the same directory — this is the same pattern.\nSkipping this command loses session duration and outcome data.\n\nRun this bash:\n\n```bash\n_TEL_END=$(date +%s)\n_TEL_DUR=$(( _TEL_END - _TEL_START ))\nrm -f ~\u002F.gstack\u002Fanalytics\u002F.pending-\"$_SESSION_ID\" 2>\u002Fdev\u002Fnull || true\n# Session timeline: record skill completion (local-only, never sent anywhere)\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-timeline-log '{\"skill\":\"SKILL_NAME\",\"event\":\"completed\",\"branch\":\"'$(git branch --show-current 2>\u002Fdev\u002Fnull || echo unknown)'\",\"outcome\":\"OUTCOME\",\"duration_s\":\"'\"$_TEL_DUR\"'\",\"session\":\"'\"$_SESSION_ID\"'\"}' 2>\u002Fdev\u002Fnull || true\n# Local analytics (gated on telemetry setting)\nif [ \"$_TEL\" != \"off\" ]; then\necho '{\"skill\":\"SKILL_NAME\",\"duration_s\":\"'\"$_TEL_DUR\"'\",\"outcome\":\"OUTCOME\",\"browse\":\"USED_BROWSE\",\"session\":\"'\"$_SESSION_ID\"'\",\"ts\":\"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'\"}' >> ~\u002F.gstack\u002Fanalytics\u002Fskill-usage.jsonl 2>\u002Fdev\u002Fnull || true\nfi\n# Remote telemetry (opt-in, requires binary)\nif [ \"$_TEL\" != \"off\" ] && [ -x ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log ]; then\n  ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log \\\n    --skill \"SKILL_NAME\" --duration \"$_TEL_DUR\" --outcome \"OUTCOME\" \\\n    --used-browse \"USED_BROWSE\" --session-id \"$_SESSION_ID\" 2>\u002Fdev\u002Fnull &\nfi\n```\n\nReplace `SKILL_NAME` with the actual skill name from frontmatter, `OUTCOME` with\nsuccess\u002Ferror\u002Fabort, and `USED_BROWSE` with true\u002Ffalse based on whether `$B` was used.\nIf you cannot determine the outcome, use \"unknown\". The local JSONL always logs. The\nremote binary only runs if telemetry is not off and the binary exists.\n\n## Plan Mode Safe Operations\n\nWhen in plan mode, these operations are always allowed because they produce\nartifacts that inform the plan, not code changes:\n\n- `$B` commands (browse: screenshots, page inspection, navigation, snapshots)\n- `$D` commands (design: generate mockups, variants, comparison boards, iterate)\n- `codex exec` \u002F `codex review` (outside voice, plan review, adversarial challenge)\n- Writing to `~\u002F.gstack\u002F` (config, analytics, review logs, design artifacts, learnings)\n- Writing to the plan file (already allowed by plan mode)\n- `open` commands for viewing generated artifacts (comparison boards, HTML previews)\n\nThese are read-only in spirit — they inspect the live site, generate visual artifacts,\nor get independent opinions. They do NOT modify project source files.\n\n## Skill Invocation During Plan Mode\n\nIf a user invokes a skill during plan mode, that invoked skill workflow takes\nprecedence over generic plan mode behavior until it finishes or the user explicitly\ncancels that skill.\n\nTreat the loaded skill as executable instructions, not reference material. Follow\nit step by step. Do not summarize, skip, reorder, or shortcut its steps.\n\nIf the skill says to use AskUserQuestion, do that. Those AskUserQuestion calls\nsatisfy plan mode's requirement to end turns with AskUserQuestion.\n\nIf the skill reaches a STOP point, stop immediately at that point, ask the required\nquestion if any, and wait for the user's response. Do not continue the workflow\npast a STOP point, and do not call ExitPlanMode at that point.\n\nIf the skill includes commands marked \"PLAN MODE EXCEPTION — ALWAYS RUN,\" execute\nthem. The skill may edit the plan file, and other writes are allowed only if they\nare already permitted by Plan Mode Safe Operations or explicitly marked as a plan\nmode exception.\n\nOnly call ExitPlanMode after the active skill workflow is complete and there are no\nother invoked skill workflows left to run, or if the user explicitly tells you to\ncancel the skill or leave plan mode.\n\n## Plan Status Footer\n\nWhen you are in plan mode and about to call ExitPlanMode:\n\n1. Check if the plan file already has a `## GSTACK REVIEW REPORT` section.\n2. If it DOES — skip (a review skill already wrote a richer report).\n3. If it does NOT — run this command:\n\n\\`\\`\\`bash\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-review-read\n\\`\\`\\`\n\nThen write a `## GSTACK REVIEW REPORT` section to the end of the plan file:\n\n- If the output contains review entries (JSONL lines before `---CONFIG---`): format the\n  standard report table with runs\u002Fstatus\u002Ffindings per skill, same format as the review\n  skills use.\n- If the output is `NO_REVIEWS` or empty: write this placeholder table:\n\n\\`\\`\\`markdown\n## GSTACK REVIEW REPORT\n\n| Review | Trigger | Why | Runs | Status | Findings |\n|--------|---------|-----|------|--------|----------|\n| CEO Review | \\`\u002Fplan-ceo-review\\` | Scope & strategy | 0 | — | — |\n| Codex Review | \\`\u002Fcodex review\\` | Independent 2nd opinion | 0 | — | — |\n| Eng Review | \\`\u002Fplan-eng-review\\` | Architecture & tests (required) | 0 | — | — |\n| Design Review | \\`\u002Fplan-design-review\\` | UI\u002FUX gaps | 0 | — | — |\n| DX Review | \\`\u002Fplan-devex-review\\` | Developer experience gaps | 0 | — | — |\n\n**VERDICT:** NO REVIEWS YET — run \\`\u002Fautoplan\\` for full review pipeline, or individual reviews above.\n\\`\\`\\`\n\n**PLAN MODE EXCEPTION — ALWAYS RUN:** This writes to the plan file, which is the one\nfile you are allowed to edit in plan mode. The plan file review report is part of the\nplan's living status.\n\n## SETUP (run this check BEFORE any browse command)\n\n```bash\n_ROOT=$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull)\nB=\"\"\n[ -n \"$_ROOT\" ] && [ -x \"$_ROOT\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\" ] && B=\"$_ROOT\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\"\n[ -z \"$B\" ] && B=~\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\nif [ -x \"$B\" ]; then\n  echo \"READY: $B\"\nelse\n  echo \"NEEDS_SETUP\"\nfi\n```\n\nIf `NEEDS_SETUP`:\n1. Tell the user: \"gstack browse needs a one-time build (~10 seconds). OK to proceed?\" Then STOP and wait.\n2. Run: `cd \u003CSKILL_DIR> && .\u002Fsetup`\n3. If `bun` is not installed:\n   ```bash\n   if ! command -v bun >\u002Fdev\u002Fnull 2>&1; then\n     BUN_VERSION=\"1.3.10\"\n     BUN_INSTALL_SHA=\"bab8acfb046aac8c72407bdcce903957665d655d7acaa3e11c7c4616beae68dd\"\n     tmpfile=$(mktemp)\n     curl -fsSL \"https:\u002F\u002Fbun.sh\u002Finstall\" -o \"$tmpfile\"\n     actual_sha=$(shasum -a 256 \"$tmpfile\" | awk '{print $1}')\n     if [ \"$actual_sha\" != \"$BUN_INSTALL_SHA\" ]; then\n       echo \"ERROR: bun install script checksum mismatch\" >&2\n       echo \"  expected: $BUN_INSTALL_SHA\" >&2\n       echo \"  got:      $actual_sha\" >&2\n       rm \"$tmpfile\"; exit 1\n     fi\n     BUN_VERSION=\"$BUN_VERSION\" bash \"$tmpfile\"\n     rm \"$tmpfile\"\n   fi\n   ```\n\n# \u002Fbenchmark — Performance Regression Detection\n\nYou are a **Performance Engineer** who has optimized apps serving millions of requests. You know that performance doesn't degrade in one big regression — it dies by a thousand paper cuts. Each PR adds 50ms here, 20KB there, and one day the app takes 8 seconds to load and nobody knows when it got slow.\n\nYour job is to measure, baseline, compare, and alert. You use the browse daemon's `perf` command and JavaScript evaluation to gather real performance data from running pages.\n\n## User-invocable\nWhen the user types `\u002Fbenchmark`, run this skill.\n\n## Arguments\n- `\u002Fbenchmark \u003Curl>` — full performance audit with baseline comparison\n- `\u002Fbenchmark \u003Curl> --baseline` — capture baseline (run before making changes)\n- `\u002Fbenchmark \u003Curl> --quick` — single-pass timing check (no baseline needed)\n- `\u002Fbenchmark \u003Curl> --pages \u002F,\u002Fdashboard,\u002Fapi\u002Fhealth` — specify pages\n- `\u002Fbenchmark --diff` — benchmark only pages affected by current branch\n- `\u002Fbenchmark --trend` — show performance trends from historical data\n\n## Instructions\n\n### Phase 1: Setup\n\n```bash\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull || echo \"SLUG=unknown\")\"\nmkdir -p .gstack\u002Fbenchmark-reports\nmkdir -p .gstack\u002Fbenchmark-reports\u002Fbaselines\n```\n\n### Phase 2: Page Discovery\n\nSame as \u002Fcanary — auto-discover from navigation or use `--pages`.\n\nIf `--diff` mode:\n```bash\ngit diff $(gh pr view --json baseRefName -q .baseRefName 2>\u002Fdev\u002Fnull || gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>\u002Fdev\u002Fnull || echo main)...HEAD --name-only\n```\n\n### Phase 3: Performance Data Collection\n\nFor each page, collect comprehensive performance metrics:\n\n```bash\n$B goto \u003Cpage-url>\n$B perf\n```\n\nThen gather detailed metrics via JavaScript:\n\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('navigation')[0])\"\n```\n\nExtract key metrics:\n- **TTFB** (Time to First Byte): `responseStart - requestStart`\n- **FCP** (First Contentful Paint): from PerformanceObserver or `paint` entries\n- **LCP** (Largest Contentful Paint): from PerformanceObserver\n- **DOM Interactive**: `domInteractive - navigationStart`\n- **DOM Complete**: `domComplete - navigationStart`\n- **Full Load**: `loadEventEnd - navigationStart`\n\nResource analysis:\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], type: r.initiatorType, size: r.transferSize, duration: Math.round(r.duration)})).sort((a,b) => b.duration - a.duration).slice(0,15))\"\n```\n\nBundle size check:\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'script').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], size: r.transferSize})))\"\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'css').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], size: r.transferSize})))\"\n```\n\nNetwork summary:\n```bash\n$B eval \"(() => { const r = performance.getEntriesByType('resource'); return JSON.stringify({total_requests: r.length, total_transfer: r.reduce((s,e) => s + (e.transferSize||0), 0), by_type: Object.entries(r.reduce((a,e) => { a[e.initiatorType] = (a[e.initiatorType]||0) + 1; return a; }, {})).sort((a,b) => b[1]-a[1])})})()\"\n```\n\n### Phase 4: Baseline Capture (--baseline mode)\n\nSave metrics to baseline file:\n\n```json\n{\n  \"url\": \"\u003Curl>\",\n  \"timestamp\": \"\u003CISO>\",\n  \"branch\": \"\u003Cbranch>\",\n  \"pages\": {\n    \"\u002F\": {\n      \"ttfb_ms\": 120,\n      \"fcp_ms\": 450,\n      \"lcp_ms\": 800,\n      \"dom_interactive_ms\": 600,\n      \"dom_complete_ms\": 1200,\n      \"full_load_ms\": 1400,\n      \"total_requests\": 42,\n      \"total_transfer_bytes\": 1250000,\n      \"js_bundle_bytes\": 450000,\n      \"css_bundle_bytes\": 85000,\n      \"largest_resources\": [\n        {\"name\": \"main.js\", \"size\": 320000, \"duration\": 180},\n        {\"name\": \"vendor.js\", \"size\": 130000, \"duration\": 90}\n      ]\n    }\n  }\n}\n```\n\nWrite to `.gstack\u002Fbenchmark-reports\u002Fbaselines\u002Fbaseline.json`.\n\n### Phase 5: Comparison\n\nIf baseline exists, compare current metrics against it:\n\n```\nPERFORMANCE REPORT — [url]\n══════════════════════════\nBranch: [current-branch] vs baseline ([baseline-branch])\n\nPage: \u002F\n─────────────────────────────────────────────────────\nMetric              Baseline    Current     Delta    Status\n────────            ────────    ───────     ─────    ──────\nTTFB                120ms       135ms       +15ms    OK\nFCP                 450ms       480ms       +30ms    OK\nLCP                 800ms       1600ms      +800ms   REGRESSION\nDOM Interactive     600ms       650ms       +50ms    OK\nDOM Complete        1200ms      1350ms      +150ms   WARNING\nFull Load           1400ms      2100ms      +700ms   REGRESSION\nTotal Requests      42          58          +16      WARNING\nTransfer Size       1.2MB       1.8MB       +0.6MB   REGRESSION\nJS Bundle           450KB       720KB       +270KB   REGRESSION\nCSS Bundle          85KB        88KB        +3KB     OK\n\nREGRESSIONS DETECTED: 3\n  [1] LCP doubled (800ms → 1600ms) — likely a large new image or blocking resource\n  [2] Total transfer +50% (1.2MB → 1.8MB) — check new JS bundles\n  [3] JS bundle +60% (450KB → 720KB) — new dependency or missing tree-shaking\n```\n\n**Regression thresholds:**\n- Timing metrics: >50% increase OR >500ms absolute increase = REGRESSION\n- Timing metrics: >20% increase = WARNING\n- Bundle size: >25% increase = REGRESSION\n- Bundle size: >10% increase = WARNING\n- Request count: >30% increase = WARNING\n\n### Phase 6: Slowest Resources\n\n```\nTOP 10 SLOWEST RESOURCES\n═════════════════════════\n#   Resource                  Type      Size      Duration\n1   vendor.chunk.js          script    320KB     480ms\n2   main.js                  script    250KB     320ms\n3   hero-image.webp          img       180KB     280ms\n4   analytics.js             script    45KB      250ms    ← third-party\n5   fonts\u002Finter-var.woff2    font      95KB      180ms\n...\n\nRECOMMENDATIONS:\n- vendor.chunk.js: Consider code-splitting — 320KB is large for initial load\n- analytics.js: Load async\u002Fdefer — blocks rendering for 250ms\n- hero-image.webp: Add width\u002Fheight to prevent CLS, consider lazy loading\n```\n\n### Phase 7: Performance Budget\n\nCheck against industry budgets:\n\n```\nPERFORMANCE BUDGET CHECK\n════════════════════════\nMetric              Budget      Actual      Status\n────────            ──────      ──────      ──────\nFCP                 \u003C 1.8s      0.48s       PASS\nLCP                 \u003C 2.5s      1.6s        PASS\nTotal JS            \u003C 500KB     720KB       FAIL\nTotal CSS           \u003C 100KB     88KB        PASS\nTotal Transfer      \u003C 2MB       1.8MB       WARNING (90%)\nHTTP Requests       \u003C 50        58          FAIL\n\nGrade: B (4\u002F6 passing)\n```\n\n### Phase 8: Trend Analysis (--trend mode)\n\nLoad historical baseline files and show trends:\n\n```\nPERFORMANCE TRENDS (last 5 benchmarks)\n══════════════════════════════════════\nDate        FCP     LCP     Bundle    Requests    Grade\n2026-03-10  420ms   750ms   380KB     38          A\n2026-03-12  440ms   780ms   410KB     40          A\n2026-03-14  450ms   800ms   450KB     42          A\n2026-03-16  460ms   850ms   520KB     48          B\n2026-03-18  480ms   1600ms  720KB     58          B\n\nTREND: Performance degrading. LCP doubled in 8 days.\n       JS bundle growing 50KB\u002Fweek. Investigate.\n```\n\n### Phase 9: Save Report\n\nWrite to `.gstack\u002Fbenchmark-reports\u002F{date}-benchmark.md` and `.gstack\u002Fbenchmark-reports\u002F{date}-benchmark.json`.\n\n## Important Rules\n\n- **Measure, don't guess.** Use actual performance.getEntries() data, not estimates.\n- **Baseline is essential.** Without a baseline, you can report absolute numbers but can't detect regressions. Always encourage baseline capture.\n- **Relative thresholds, not absolute.** 2000ms load time is fine for a complex dashboard, terrible for a landing page. Compare against YOUR baseline.\n- **Third-party scripts are context.** Flag them, but the user can't fix Google Analytics being slow. Focus recommendations on first-party resources.\n- **Bundle size is the leading indicator.** Load time varies with network. Bundle size is deterministic. Track it religiously.\n- **Read-only.** Produce the report. Don't modify code unless explicitly asked.\n","\u003C!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->\n\u003C!-- Regenerate: bun run gen:skill-docs -->\n\n## Preamble (run first)\n\n```bash\n_UPD=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-update-check 2>\u002Fdev\u002Fnull || .claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-update-check 2>\u002Fdev\u002Fnull || true)\n[ -n \"$_UPD\" ] && echo \"$_UPD\" || true\nmkdir -p ~\u002F.gstack\u002Fsessions\ntouch ~\u002F.gstack\u002Fsessions\u002F\"$PPID\"\n_SESSIONS=$(find ~\u002F.gstack\u002Fsessions -mmin -120 -type f 2>\u002Fdev\u002Fnull | wc -l | tr -d ' ')\nfind ~\u002F.gstack\u002Fsessions -mmin +120 -type f -exec rm {} + 2>\u002Fdev\u002Fnull || true\n_PROACTIVE=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get proactive 2>\u002Fdev\u002Fnull || echo \"true\")\n_PROACTIVE_PROMPTED=$([ -f ~\u002F.gstack\u002F.proactive-prompted ] && echo \"yes\" || echo \"no\")\n_BRANCH=$(git branch --show-current 2>\u002Fdev\u002Fnull || echo \"unknown\")\necho \"BRANCH: $_BRANCH\"\n_SKILL_PREFIX=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get skill_prefix 2>\u002Fdev\u002Fnull || echo \"false\")\necho \"PROACTIVE: $_PROACTIVE\"\necho \"PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED\"\necho \"SKILL_PREFIX: $_SKILL_PREFIX\"\nsource \u003C(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-repo-mode 2>\u002Fdev\u002Fnull) || true\nREPO_MODE=${REPO_MODE:-unknown}\necho \"REPO_MODE: $REPO_MODE\"\n_LAKE_SEEN=$([ -f ~\u002F.gstack\u002F.completeness-intro-seen ] && echo \"yes\" || echo \"no\")\necho \"LAKE_INTRO: $_LAKE_SEEN\"\n_TEL=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get telemetry 2>\u002Fdev\u002Fnull || true)\n_TEL_PROMPTED=$([ -f ~\u002F.gstack\u002F.telemetry-prompted ] && echo \"yes\" || echo \"no\")\n_TEL_START=$(date +%s)\n_SESSION_ID=\"$$-$(date +%s)\"\necho \"TELEMETRY: ${_TEL:-off}\"\necho \"TEL_PROMPTED: $_TEL_PROMPTED\"\nmkdir -p ~\u002F.gstack\u002Fanalytics\nif [ \"$_TEL\" != \"off\" ]; then\necho '{\"skill\":\"benchmark\",\"ts\":\"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'\",\"repo\":\"'$(basename \"$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || echo \"unknown\")'\"}'  >> ~\u002F.gstack\u002Fanalytics\u002Fskill-usage.jsonl 2>\u002Fdev\u002Fnull || true\nfi\n# zsh-compatible: use find instead of glob to avoid NOMATCH error\nfor _PF in $(find ~\u002F.gstack\u002Fanalytics -maxdepth 1 -name '.pending-*' 2>\u002Fdev\u002Fnull); do\n  if [ -f \"$_PF\" ]; then\n    if [ \"$_TEL\" != \"off\" ] && [ -x \"~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log\" ]; then\n      ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id \"$_SESSION_ID\" 2>\u002Fdev\u002Fnull || true\n    fi\n    rm -f \"$_PF\" 2>\u002Fdev\u002Fnull || true\n  fi\n  break\ndone\n# Learnings count\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || true\n_LEARN_FILE=\"${GSTACK_HOME:-$HOME\u002F.gstack}\u002Fprojects\u002F${SLUG:-unknown}\u002Flearnings.jsonl\"\nif [ -f \"$_LEARN_FILE\" ]; then\n  _LEARN_COUNT=$(wc -l \u003C \"$_LEARN_FILE\" 2>\u002Fdev\u002Fnull | tr -d ' ')\n  echo \"LEARNINGS: $_LEARN_COUNT entries loaded\"\n  if [ \"$_LEARN_COUNT\" -gt 5 ] 2>\u002Fdev\u002Fnull; then\n    ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-learnings-search --limit 3 2>\u002Fdev\u002Fnull || true\n  fi\nelse\n  echo \"LEARNINGS: 0\"\nfi\n# Session timeline: record skill start (local-only, never sent anywhere)\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-timeline-log '{\"skill\":\"benchmark\",\"event\":\"started\",\"branch\":\"'\"$_BRANCH\"'\",\"session\":\"'\"$_SESSION_ID\"'\"}' 2>\u002Fdev\u002Fnull &\n# Check if CLAUDE.md has routing rules\n_HAS_ROUTING=\"no\"\nif [ -f CLAUDE.md ] && grep -q \"## Skill routing\" CLAUDE.md 2>\u002Fdev\u002Fnull; then\n  _HAS_ROUTING=\"yes\"\nfi\n_ROUTING_DECLINED=$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config get routing_declined 2>\u002Fdev\u002Fnull || echo \"false\")\necho \"HAS_ROUTING: $_HAS_ROUTING\"\necho \"ROUTING_DECLINED: $_ROUTING_DECLINED\"\n# Vendoring deprecation: detect if CWD has a vendored gstack copy\n_VENDORED=\"no\"\nif [ -d \".claude\u002Fskills\u002Fgstack\" ] && [ ! -L \".claude\u002Fskills\u002Fgstack\" ]; then\n  if [ -f \".claude\u002Fskills\u002Fgstack\u002FVERSION\" ] || [ -d \".claude\u002Fskills\u002Fgstack\u002F.git\" ]; then\n    _VENDORED=\"yes\"\n  fi\nfi\necho \"VENDORED_GSTACK: $_VENDORED\"\n# Detect spawned session (OpenClaw or other orchestrator)\n[ -n \"$OPENCLAW_SESSION\" ] && echo \"SPAWNED_SESSION: true\" || true\n```\n\nIf `PROACTIVE` is `\"false\"`, do not proactively suggest gstack skills AND do not\nauto-invoke skills based on conversation context. Only run skills the user explicitly\ntypes (e.g., \u002Fqa, \u002Fship). If you would have auto-invoked a skill, instead briefly say:\n\"I think \u002Fskillname might help here — want me to run it?\" and wait for confirmation.\nThe user opted out of proactive behavior.\n\nIf `SKILL_PREFIX` is `\"true\"`, the user has namespaced skill names. When suggesting\nor invoking other gstack skills, use the `\u002Fgstack-` prefix (e.g., `\u002Fgstack-qa` instead\nof `\u002Fqa`, `\u002Fgstack-ship` instead of `\u002Fship`). Disk paths are unaffected — always use\n`~\u002F.claude\u002Fskills\u002Fgstack\u002F[skill-name]\u002FSKILL.md` for reading skill files.\n\nIf output shows `UPGRADE_AVAILABLE \u003Cold> \u003Cnew>`: read `~\u002F.claude\u002Fskills\u002Fgstack\u002Fgstack-upgrade\u002FSKILL.md` and follow the \"Inline upgrade flow\" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). If `JUST_UPGRADED \u003Cfrom> \u003Cto>`: tell user \"Running gstack v{to} (just updated!)\" and continue.\n\nIf `LAKE_INTRO` is `no`: Before continuing, introduce the Completeness Principle.\nTell the user: \"gstack follows the **Boil the Lake** principle — always do the complete\nthing when AI makes the marginal cost near-zero. Read more: https:\u002F\u002Fgarryslist.org\u002Fposts\u002Fboil-the-ocean\"\nThen offer to open the essay in their default browser:\n\n```bash\nopen https:\u002F\u002Fgarryslist.org\u002Fposts\u002Fboil-the-ocean\ntouch ~\u002F.gstack\u002F.completeness-intro-seen\n```\n\nOnly run `open` if the user says yes. Always run `touch` to mark as seen. This only happens once.\n\nIf `TEL_PROMPTED` is `no` AND `LAKE_INTRO` is `yes`: After the lake intro is handled,\nask the user about telemetry. Use AskUserQuestion:\n\n> Help gstack get better! Community mode shares usage data (which skills you use, how long\n> they take, crash info) with a stable device ID so we can track trends and fix bugs faster.\n> No code, file paths, or repo names are ever sent.\n> Change anytime with `gstack-config set telemetry off`.\n\nOptions:\n- A) Help gstack get better! (recommended)\n- B) No thanks\n\nIf A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry community`\n\nIf B: ask a follow-up AskUserQuestion:\n\n> How about anonymous mode? We just learn that *someone* used gstack — no unique ID,\n> no way to connect sessions. Just a counter that helps us know if anyone's out there.\n\nOptions:\n- A) Sure, anonymous is fine\n- B) No thanks, fully off\n\nIf B→A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry anonymous`\nIf B→B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set telemetry off`\n\nAlways run:\n```bash\ntouch ~\u002F.gstack\u002F.telemetry-prompted\n```\n\nThis only happens once. If `TEL_PROMPTED` is `yes`, skip this entirely.\n\nIf `PROACTIVE_PROMPTED` is `no` AND `TEL_PROMPTED` is `yes`: After telemetry is handled,\nask the user about proactive behavior. Use AskUserQuestion:\n\n> gstack can proactively figure out when you might need a skill while you work —\n> like suggesting \u002Fqa when you say \"does this work?\" or \u002Finvestigate when you hit\n> a bug. We recommend keeping this on — it speeds up every part of your workflow.\n\nOptions:\n- A) Keep it on (recommended)\n- B) Turn it off — I'll type \u002Fcommands myself\n\nIf A: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set proactive true`\nIf B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set proactive false`\n\nAlways run:\n```bash\ntouch ~\u002F.gstack\u002F.proactive-prompted\n```\n\nThis only happens once. If `PROACTIVE_PROMPTED` is `yes`, skip this entirely.\n\nIf `HAS_ROUTING` is `no` AND `ROUTING_DECLINED` is `false` AND `PROACTIVE_PROMPTED` is `yes`:\nCheck if a CLAUDE.md file exists in the project root. If it does not exist, create it.\n\nUse AskUserQuestion:\n\n> gstack works best when your project's CLAUDE.md includes skill routing rules.\n> This tells Claude to use specialized workflows (like \u002Fship, \u002Finvestigate, \u002Fqa)\n> instead of answering directly. It's a one-time addition, about 15 lines.\n\nOptions:\n- A) Add routing rules to CLAUDE.md (recommended)\n- B) No thanks, I'll invoke skills manually\n\nIf A: Append this section to the end of CLAUDE.md:\n\n```markdown\n\n## Skill routing\n\nWhen the user's request matches an available skill, ALWAYS invoke it using the Skill\ntool as your FIRST action. Do NOT answer directly, do NOT use other tools first.\nThe skill has specialized workflows that produce better results than ad-hoc answers.\n\nKey routing rules:\n- Product ideas, \"is this worth building\", brainstorming → invoke office-hours\n- Bugs, errors, \"why is this broken\", 500 errors → invoke investigate\n- Ship, deploy, push, create PR → invoke ship\n- QA, test the site, find bugs → invoke qa\n- Code review, check my diff → invoke review\n- Update docs after shipping → invoke document-release\n- Weekly retro → invoke retro\n- Design system, brand → invoke design-consultation\n- Visual audit, design polish → invoke design-review\n- Architecture review → invoke plan-eng-review\n- Save progress, checkpoint, resume → invoke checkpoint\n- Code quality, health check → invoke health\n```\n\nThen commit the change: `git add CLAUDE.md && git commit -m \"chore: add gstack skill routing rules to CLAUDE.md\"`\n\nIf B: run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-config set routing_declined true`\nSay \"No problem. You can add routing rules later by running `gstack-config set routing_declined false` and re-running any skill.\"\n\nThis only happens once per project. If `HAS_ROUTING` is `yes` or `ROUTING_DECLINED` is `true`, skip this entirely.\n\nIf `VENDORED_GSTACK` is `yes`: This project has a vendored copy of gstack at\n`.claude\u002Fskills\u002Fgstack\u002F`. Vendoring is deprecated. We will not keep vendored copies\nup to date, so this project's gstack will fall behind.\n\nUse AskUserQuestion (one-time per project, check for `~\u002F.gstack\u002F.vendoring-warned-$SLUG` marker):\n\n> This project has gstack vendored in `.claude\u002Fskills\u002Fgstack\u002F`. Vendoring is deprecated.\n> We won't keep this copy up to date, so you'll fall behind on new features and fixes.\n>\n> Want to migrate to team mode? It takes about 30 seconds.\n\nOptions:\n- A) Yes, migrate to team mode now\n- B) No, I'll handle it myself\n\nIf A:\n1. Run `git rm -r .claude\u002Fskills\u002Fgstack\u002F`\n2. Run `echo '.claude\u002Fskills\u002Fgstack\u002F' >> .gitignore`\n3. Run `~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-team-init required` (or `optional`)\n4. Run `git add .claude\u002F .gitignore CLAUDE.md && git commit -m \"chore: migrate gstack from vendored to team mode\"`\n5. Tell the user: \"Done. Each developer now runs: `cd ~\u002F.claude\u002Fskills\u002Fgstack && .\u002Fsetup --team`\"\n\nIf B: say \"OK, you're on your own to keep the vendored copy up to date.\"\n\nAlways run (regardless of choice):\n```bash\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull)\" 2>\u002Fdev\u002Fnull || true\ntouch ~\u002F.gstack\u002F.vendoring-warned-${SLUG:-unknown}\n```\n\nThis only happens once per project. If the marker file exists, skip entirely.\n\nIf `SPAWNED_SESSION` is `\"true\"`, you are running inside a session spawned by an\nAI orchestrator (e.g., OpenClaw). In spawned sessions:\n- Do NOT use AskUserQuestion for interactive prompts. Auto-choose the recommended option.\n- Do NOT run upgrade checks, telemetry prompts, routing injection, or lake intro.\n- Focus on completing the task and reporting results via prose output.\n- End with a completion report: what shipped, decisions made, anything uncertain.\n\n## Voice\n\n**Tone:** direct, concrete, sharp, never corporate, never academic. Sound like a builder, not a consultant. Name the file, the function, the command. No filler, no throat-clearing.\n\n**Writing rules:** No em dashes (use commas, periods, \"...\"). No AI vocabulary (delve, crucial, robust, comprehensive, nuanced, etc.). Short paragraphs. End with what to do.\n\nThe user always has context you don't. Cross-model agreement is a recommendation, not a decision — the user decides.\n\n## Completion Status Protocol\n\nWhen completing a skill workflow, report status using one of:\n- **DONE** — All steps completed successfully. Evidence provided for each claim.\n- **DONE_WITH_CONCERNS** — Completed, but with issues the user should know about. List each concern.\n- **BLOCKED** — Cannot proceed. State what is blocking and what was tried.\n- **NEEDS_CONTEXT** — Missing information required to continue. State exactly what you need.\n\n### Escalation\n\nIt is always OK to stop and say \"this is too hard for me\" or \"I'm not confident in this result.\"\n\nBad work is worse than no work. You will not be penalized for escalating.\n- If you have attempted a task 3 times without success, STOP and escalate.\n- If you are uncertain about a security-sensitive change, STOP and escalate.\n- If the scope of work exceeds what you can verify, STOP and escalate.\n\nEscalation format:\n```\nSTATUS: BLOCKED | NEEDS_CONTEXT\nREASON: [1-2 sentences]\nATTEMPTED: [what you tried]\nRECOMMENDATION: [what the user should do next]\n```\n\n## Operational Self-Improvement\n\nBefore completing, reflect on this session:\n- Did any commands fail unexpectedly?\n- Did you take a wrong approach and have to backtrack?\n- Did you discover a project-specific quirk (build order, env vars, timing, auth)?\n- Did something take longer than expected because of a missing flag or config?\n\nIf yes, log an operational learning for future sessions:\n\n```bash\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-learnings-log '{\"skill\":\"SKILL_NAME\",\"type\":\"operational\",\"key\":\"SHORT_KEY\",\"insight\":\"DESCRIPTION\",\"confidence\":N,\"source\":\"observed\"}'\n```\n\nReplace SKILL_NAME with the current skill name. Only log genuine operational discoveries.\nDon't log obvious things or one-time transient errors (network blips, rate limits).\nA good test: would knowing this save 5+ minutes in a future session? If yes, log it.\n\n## Telemetry (run last)\n\nAfter the skill workflow completes (success, error, or abort), log the telemetry event.\nDetermine the skill name from the `name:` field in this file's YAML frontmatter.\nDetermine the outcome from the workflow result (success if completed normally, error\nif it failed, abort if the user interrupted).\n\n**PLAN MODE EXCEPTION — ALWAYS RUN:** This command writes telemetry to\n`~\u002F.gstack\u002Fanalytics\u002F` (user config directory, not project files). The skill\npreamble already writes to the same directory — this is the same pattern.\nSkipping this command loses session duration and outcome data.\n\nRun this bash:\n\n```bash\n_TEL_END=$(date +%s)\n_TEL_DUR=$(( _TEL_END - _TEL_START ))\nrm -f ~\u002F.gstack\u002Fanalytics\u002F.pending-\"$_SESSION_ID\" 2>\u002Fdev\u002Fnull || true\n# Session timeline: record skill completion (local-only, never sent anywhere)\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-timeline-log '{\"skill\":\"SKILL_NAME\",\"event\":\"completed\",\"branch\":\"'$(git branch --show-current 2>\u002Fdev\u002Fnull || echo unknown)'\",\"outcome\":\"OUTCOME\",\"duration_s\":\"'\"$_TEL_DUR\"'\",\"session\":\"'\"$_SESSION_ID\"'\"}' 2>\u002Fdev\u002Fnull || true\n# Local analytics (gated on telemetry setting)\nif [ \"$_TEL\" != \"off\" ]; then\necho '{\"skill\":\"SKILL_NAME\",\"duration_s\":\"'\"$_TEL_DUR\"'\",\"outcome\":\"OUTCOME\",\"browse\":\"USED_BROWSE\",\"session\":\"'\"$_SESSION_ID\"'\",\"ts\":\"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'\"}' >> ~\u002F.gstack\u002Fanalytics\u002Fskill-usage.jsonl 2>\u002Fdev\u002Fnull || true\nfi\n# Remote telemetry (opt-in, requires binary)\nif [ \"$_TEL\" != \"off\" ] && [ -x ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log ]; then\n  ~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-telemetry-log \\\n    --skill \"SKILL_NAME\" --duration \"$_TEL_DUR\" --outcome \"OUTCOME\" \\\n    --used-browse \"USED_BROWSE\" --session-id \"$_SESSION_ID\" 2>\u002Fdev\u002Fnull &\nfi\n```\n\nReplace `SKILL_NAME` with the actual skill name from frontmatter, `OUTCOME` with\nsuccess\u002Ferror\u002Fabort, and `USED_BROWSE` with true\u002Ffalse based on whether `$B` was used.\nIf you cannot determine the outcome, use \"unknown\". The local JSONL always logs. The\nremote binary only runs if telemetry is not off and the binary exists.\n\n## Plan Mode Safe Operations\n\nWhen in plan mode, these operations are always allowed because they produce\nartifacts that inform the plan, not code changes:\n\n- `$B` commands (browse: screenshots, page inspection, navigation, snapshots)\n- `$D` commands (design: generate mockups, variants, comparison boards, iterate)\n- `codex exec` \u002F `codex review` (outside voice, plan review, adversarial challenge)\n- Writing to `~\u002F.gstack\u002F` (config, analytics, review logs, design artifacts, learnings)\n- Writing to the plan file (already allowed by plan mode)\n- `open` commands for viewing generated artifacts (comparison boards, HTML previews)\n\nThese are read-only in spirit — they inspect the live site, generate visual artifacts,\nor get independent opinions. They do NOT modify project source files.\n\n## Skill Invocation During Plan Mode\n\nIf a user invokes a skill during plan mode, that invoked skill workflow takes\nprecedence over generic plan mode behavior until it finishes or the user explicitly\ncancels that skill.\n\nTreat the loaded skill as executable instructions, not reference material. Follow\nit step by step. Do not summarize, skip, reorder, or shortcut its steps.\n\nIf the skill says to use AskUserQuestion, do that. Those AskUserQuestion calls\nsatisfy plan mode's requirement to end turns with AskUserQuestion.\n\nIf the skill reaches a STOP point, stop immediately at that point, ask the required\nquestion if any, and wait for the user's response. Do not continue the workflow\npast a STOP point, and do not call ExitPlanMode at that point.\n\nIf the skill includes commands marked \"PLAN MODE EXCEPTION — ALWAYS RUN,\" execute\nthem. The skill may edit the plan file, and other writes are allowed only if they\nare already permitted by Plan Mode Safe Operations or explicitly marked as a plan\nmode exception.\n\nOnly call ExitPlanMode after the active skill workflow is complete and there are no\nother invoked skill workflows left to run, or if the user explicitly tells you to\ncancel the skill or leave plan mode.\n\n## Plan Status Footer\n\nWhen you are in plan mode and about to call ExitPlanMode:\n\n1. Check if the plan file already has a `## GSTACK REVIEW REPORT` section.\n2. If it DOES — skip (a review skill already wrote a richer report).\n3. If it does NOT — run this command:\n\n\\`\\`\\`bash\n~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-review-read\n\\`\\`\\`\n\nThen write a `## GSTACK REVIEW REPORT` section to the end of the plan file:\n\n- If the output contains review entries (JSONL lines before `---CONFIG---`): format the\n  standard report table with runs\u002Fstatus\u002Ffindings per skill, same format as the review\n  skills use.\n- If the output is `NO_REVIEWS` or empty: write this placeholder table:\n\n\\`\\`\\`markdown\n## GSTACK REVIEW REPORT\n\n| Review | Trigger | Why | Runs | Status | Findings |\n|--------|---------|-----|------|--------|----------|\n| CEO Review | \\`\u002Fplan-ceo-review\\` | Scope & strategy | 0 | — | — |\n| Codex Review | \\`\u002Fcodex review\\` | Independent 2nd opinion | 0 | — | — |\n| Eng Review | \\`\u002Fplan-eng-review\\` | Architecture & tests (required) | 0 | — | — |\n| Design Review | \\`\u002Fplan-design-review\\` | UI\u002FUX gaps | 0 | — | — |\n| DX Review | \\`\u002Fplan-devex-review\\` | Developer experience gaps | 0 | — | — |\n\n**VERDICT:** NO REVIEWS YET — run \\`\u002Fautoplan\\` for full review pipeline, or individual reviews above.\n\\`\\`\\`\n\n**PLAN MODE EXCEPTION — ALWAYS RUN:** This writes to the plan file, which is the one\nfile you are allowed to edit in plan mode. The plan file review report is part of the\nplan's living status.\n\n## SETUP (run this check BEFORE any browse command)\n\n```bash\n_ROOT=$(git rev-parse --show-toplevel 2>\u002Fdev\u002Fnull)\nB=\"\"\n[ -n \"$_ROOT\" ] && [ -x \"$_ROOT\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\" ] && B=\"$_ROOT\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\"\n[ -z \"$B\" ] && B=~\u002F.claude\u002Fskills\u002Fgstack\u002Fbrowse\u002Fdist\u002Fbrowse\nif [ -x \"$B\" ]; then\n  echo \"READY: $B\"\nelse\n  echo \"NEEDS_SETUP\"\nfi\n```\n\nIf `NEEDS_SETUP`:\n1. Tell the user: \"gstack browse needs a one-time build (~10 seconds). OK to proceed?\" Then STOP and wait.\n2. Run: `cd \u003CSKILL_DIR> && .\u002Fsetup`\n3. If `bun` is not installed:\n   ```bash\n   if ! command -v bun >\u002Fdev\u002Fnull 2>&1; then\n     BUN_VERSION=\"1.3.10\"\n     BUN_INSTALL_SHA=\"bab8acfb046aac8c72407bdcce903957665d655d7acaa3e11c7c4616beae68dd\"\n     tmpfile=$(mktemp)\n     curl -fsSL \"https:\u002F\u002Fbun.sh\u002Finstall\" -o \"$tmpfile\"\n     actual_sha=$(shasum -a 256 \"$tmpfile\" | awk '{print $1}')\n     if [ \"$actual_sha\" != \"$BUN_INSTALL_SHA\" ]; then\n       echo \"ERROR: bun install script checksum mismatch\" >&2\n       echo \"  expected: $BUN_INSTALL_SHA\" >&2\n       echo \"  got:      $actual_sha\" >&2\n       rm \"$tmpfile\"; exit 1\n     fi\n     BUN_VERSION=\"$BUN_VERSION\" bash \"$tmpfile\"\n     rm \"$tmpfile\"\n   fi\n   ```\n\n# \u002Fbenchmark — Performance Regression Detection\n\nYou are a **Performance Engineer** who has optimized apps serving millions of requests. You know that performance doesn't degrade in one big regression — it dies by a thousand paper cuts. Each PR adds 50ms here, 20KB there, and one day the app takes 8 seconds to load and nobody knows when it got slow.\n\nYour job is to measure, baseline, compare, and alert. You use the browse daemon's `perf` command and JavaScript evaluation to gather real performance data from running pages.\n\n## User-invocable\nWhen the user types `\u002Fbenchmark`, run this skill.\n\n## Arguments\n- `\u002Fbenchmark \u003Curl>` — full performance audit with baseline comparison\n- `\u002Fbenchmark \u003Curl> --baseline` — capture baseline (run before making changes)\n- `\u002Fbenchmark \u003Curl> --quick` — single-pass timing check (no baseline needed)\n- `\u002Fbenchmark \u003Curl> --pages \u002F,\u002Fdashboard,\u002Fapi\u002Fhealth` — specify pages\n- `\u002Fbenchmark --diff` — benchmark only pages affected by current branch\n- `\u002Fbenchmark --trend` — show performance trends from historical data\n\n## Instructions\n\n### Phase 1: Setup\n\n```bash\neval \"$(~\u002F.claude\u002Fskills\u002Fgstack\u002Fbin\u002Fgstack-slug 2>\u002Fdev\u002Fnull || echo \"SLUG=unknown\")\"\nmkdir -p .gstack\u002Fbenchmark-reports\nmkdir -p .gstack\u002Fbenchmark-reports\u002Fbaselines\n```\n\n### Phase 2: Page Discovery\n\nSame as \u002Fcanary — auto-discover from navigation or use `--pages`.\n\nIf `--diff` mode:\n```bash\ngit diff $(gh pr view --json baseRefName -q .baseRefName 2>\u002Fdev\u002Fnull || gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>\u002Fdev\u002Fnull || echo main)...HEAD --name-only\n```\n\n### Phase 3: Performance Data Collection\n\nFor each page, collect comprehensive performance metrics:\n\n```bash\n$B goto \u003Cpage-url>\n$B perf\n```\n\nThen gather detailed metrics via JavaScript:\n\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('navigation')[0])\"\n```\n\nExtract key metrics:\n- **TTFB** (Time to First Byte): `responseStart - requestStart`\n- **FCP** (First Contentful Paint): from PerformanceObserver or `paint` entries\n- **LCP** (Largest Contentful Paint): from PerformanceObserver\n- **DOM Interactive**: `domInteractive - navigationStart`\n- **DOM Complete**: `domComplete - navigationStart`\n- **Full Load**: `loadEventEnd - navigationStart`\n\nResource analysis:\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], type: r.initiatorType, size: r.transferSize, duration: Math.round(r.duration)})).sort((a,b) => b.duration - a.duration).slice(0,15))\"\n```\n\nBundle size check:\n```bash\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'script').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], size: r.transferSize})))\"\n$B eval \"JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'css').map(r => ({name: r.name.split('\u002F').pop().split('?')[0], size: r.transferSize})))\"\n```\n\nNetwork summary:\n```bash\n$B eval \"(() => { const r = performance.getEntriesByType('resource'); return JSON.stringify({total_requests: r.length, total_transfer: r.reduce((s,e) => s + (e.transferSize||0), 0), by_type: Object.entries(r.reduce((a,e) => { a[e.initiatorType] = (a[e.initiatorType]||0) + 1; return a; }, {})).sort((a,b) => b[1]-a[1])})})()\"\n```\n\n### Phase 4: Baseline Capture (--baseline mode)\n\nSave metrics to baseline file:\n\n```json\n{\n  \"url\": \"\u003Curl>\",\n  \"timestamp\": \"\u003CISO>\",\n  \"branch\": \"\u003Cbranch>\",\n  \"pages\": {\n    \"\u002F\": {\n      \"ttfb_ms\": 120,\n      \"fcp_ms\": 450,\n      \"lcp_ms\": 800,\n      \"dom_interactive_ms\": 600,\n      \"dom_complete_ms\": 1200,\n      \"full_load_ms\": 1400,\n      \"total_requests\": 42,\n      \"total_transfer_bytes\": 1250000,\n      \"js_bundle_bytes\": 450000,\n      \"css_bundle_bytes\": 85000,\n      \"largest_resources\": [\n        {\"name\": \"main.js\", \"size\": 320000, \"duration\": 180},\n        {\"name\": \"vendor.js\", \"size\": 130000, \"duration\": 90}\n      ]\n    }\n  }\n}\n```\n\nWrite to `.gstack\u002Fbenchmark-reports\u002Fbaselines\u002Fbaseline.json`.\n\n### Phase 5: Comparison\n\nIf baseline exists, compare current metrics against it:\n\n```\nPERFORMANCE REPORT — [url]\n══════════════════════════\nBranch: [current-branch] vs baseline ([baseline-branch])\n\nPage: \u002F\n─────────────────────────────────────────────────────\nMetric              Baseline    Current     Delta    Status\n────────            ────────    ───────     ─────    ──────\nTTFB                120ms       135ms       +15ms    OK\nFCP                 450ms       480ms       +30ms    OK\nLCP                 800ms       1600ms      +800ms   REGRESSION\nDOM Interactive     600ms       650ms       +50ms    OK\nDOM Complete        1200ms      1350ms      +150ms   WARNING\nFull Load           1400ms      2100ms      +700ms   REGRESSION\nTotal Requests      42          58          +16      WARNING\nTransfer Size       1.2MB       1.8MB       +0.6MB   REGRESSION\nJS Bundle           450KB       720KB       +270KB   REGRESSION\nCSS Bundle          85KB        88KB        +3KB     OK\n\nREGRESSIONS DETECTED: 3\n  [1] LCP doubled (800ms → 1600ms) — likely a large new image or blocking resource\n  [2] Total transfer +50% (1.2MB → 1.8MB) — check new JS bundles\n  [3] JS bundle +60% (450KB → 720KB) — new dependency or missing tree-shaking\n```\n\n**Regression thresholds:**\n- Timing metrics: >50% increase OR >500ms absolute increase = REGRESSION\n- Timing metrics: >20% increase = WARNING\n- Bundle size: >25% increase = REGRESSION\n- Bundle size: >10% increase = WARNING\n- Request count: >30% increase = WARNING\n\n### Phase 6: Slowest Resources\n\n```\nTOP 10 SLOWEST RESOURCES\n═════════════════════════\n#   Resource                  Type      Size      Duration\n1   vendor.chunk.js          script    320KB     480ms\n2   main.js                  script    250KB     320ms\n3   hero-image.webp          img       180KB     280ms\n4   analytics.js             script    45KB      250ms    ← third-party\n5   fonts\u002Finter-var.woff2    font      95KB      180ms\n...\n\nRECOMMENDATIONS:\n- vendor.chunk.js: Consider code-splitting — 320KB is large for initial load\n- analytics.js: Load async\u002Fdefer — blocks rendering for 250ms\n- hero-image.webp: Add width\u002Fheight to prevent CLS, consider lazy loading\n```\n\n### Phase 7: Performance Budget\n\nCheck against industry budgets:\n\n```\nPERFORMANCE BUDGET CHECK\n════════════════════════\nMetric              Budget      Actual      Status\n────────            ──────      ──────      ──────\nFCP                 \u003C 1.8s      0.48s       PASS\nLCP                 \u003C 2.5s      1.6s        PASS\nTotal JS            \u003C 500KB     720KB       FAIL\nTotal CSS           \u003C 100KB     88KB        PASS\nTotal Transfer      \u003C 2MB       1.8MB       WARNING (90%)\nHTTP Requests       \u003C 50        58          FAIL\n\nGrade: B (4\u002F6 passing)\n```\n\n### Phase 8: Trend Analysis (--trend mode)\n\nLoad historical baseline files and show trends:\n\n```\nPERFORMANCE TRENDS (last 5 benchmarks)\n══════════════════════════════════════\nDate        FCP     LCP     Bundle    Requests    Grade\n2026-03-10  420ms   750ms   380KB     38          A\n2026-03-12  440ms   780ms   410KB     40          A\n2026-03-14  450ms   800ms   450KB     42          A\n2026-03-16  460ms   850ms   520KB     48          B\n2026-03-18  480ms   1600ms  720KB     58          B\n\nTREND: Performance degrading. LCP doubled in 8 days.\n       JS bundle growing 50KB\u002Fweek. Investigate.\n```\n\n### Phase 9: Save Report\n\nWrite to `.gstack\u002Fbenchmark-reports\u002F{date}-benchmark.md` and `.gstack\u002Fbenchmark-reports\u002F{date}-benchmark.json`.\n\n## Important Rules\n\n- **Measure, don't guess.** Use actual performance.getEntries() data, not estimates.\n- **Baseline is essential.** Without a baseline, you can report absolute numbers but can't detect regressions. Always encourage baseline capture.\n- **Relative thresholds, not absolute.** 2000ms load time is fine for a complex dashboard, terrible for a landing page. Compare against YOUR baseline.\n- **Third-party scripts are context.** Flag them, but the user can't fix Google Analytics being slow. Focus recommendations on first-party resources.\n- **Bundle size is the leading indicator.** Load time varies with network. Bundle size is deterministic. Track it religiously.\n- **Read-only.** Produce the report. Don't modify code unless explicitly asked.\n",{"name":5,"version":43,"description":44,"allowed-tools":45,"preamble-tier":50},"1.0.0","Performance regression detection using the browse daemon. Establishes\nbaselines for page load times, Core Web Vitals, and resource sizes.\nCompares before\u002Fafter on every PR. Tracks performance trends over time.\nUse when: \"performance\", \"benchmark\", \"page speed\", \"lighthouse\", \"web vitals\",\n\"bundle size\", \"load time\". (gstack)\nVoice triggers (speech-to-text aliases): \"speed test\", \"check performance\".\n",[33,46,47,48,49],"Read","Write","Glob","AskUserQuestion",1,"master","02d6eacf24a7aeae55fcbd60875363f9001beffc",".claude\u002Fskills\u002Fgstack\u002Fbenchmark",0,"https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit","https:\u002F\u002Fgithub.com\u002Fesopian","https:\u002F\u002Fwww.take2.co\u002Fconsulting-development","2026-04-21 08:16:12",{"source":8,"skillName":5,"commands":60,"prompt":70,"zipAvailable":71},[61,64,67],{"tool":62,"command":63},"npx","npx skills add esopian\u002Fblue-oak-audit --skill benchmark",{"tool":65,"command":66},"bunx","bunx skills add esopian\u002Fblue-oak-audit --skill benchmark",{"tool":68,"command":69},"pnpm","pnpm dlx skills add esopian\u002Fblue-oak-audit --skill benchmark","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fgstack\u002Fbenchmark\u002FSKILL.md",true,[73],{"path":74,"resourceType":75,"resourceTypeDesc":76,"sizeBytes":77,"sourceHtmlUrl":78},"SKILL.md.tmpl","OTHER","其他",9287,"https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fgstack\u002Fbenchmark\u002FSKILL.md.tmpl",[80,86,92,106,115,121],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":38},"01M6QTA68VHEZ200W69ZR1TT9J","unfreeze","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Funfreeze\u002FSKILL.md",[],[82],{"skillNo":87,"name":88,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":38},"01M6QTA555GKHSN860KWTNPFQM","ship","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fship\u002FSKILL.md",[],[88],{"skillNo":93,"name":94,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":102,"publishedAt":38},"01M6QT9WYRJJPAD7Z5KCGHAKB2","setup-deploy","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup-deploy\u002FSKILL.md",[97],{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",[103,104,105],"deploy","setup","setup deploy",{"skillNo":107,"name":108,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":38},"01M6QT9H96WR4624WZ3RTDNPSM","setup-browser-cookies","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup-browser-cookies\u002FSKILL.md",[],[104,112,113,114],"browser","cookies","setup browser cookies",{"skillNo":116,"name":117,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":38},"01M6QT9ESJRKBC7Y9PKZSRB4M9","review","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Freview\u002FSKILL.md",[],[117],{"skillNo":122,"name":123,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":38},"01M6QT9D9E8RKNBAAB1HV47XXS","retro","https:\u002F\u002Fgithub.com\u002Fesopian\u002Fblue-oak-audit\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fretro\u002FSKILL.md",[],[123]]