[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6X1C6K1JNMG4NXCZPZ8HDJD":3,"skill-same:01M6X1C6K1JNMG4NXCZPZ8HDJD":74},{"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":23,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":55,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":73},"01M6X1C6K1JNMG4NXCZPZ8HDJD","pr-screenshots",null,"Capture Playwright screenshots and embed them in GitHub PR descriptions","github\u002Fsquad","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6X0MZ6B0WYMMDPK3Q61KER6",3391,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fpackages\u002Fsquad-cli\u002Ftemplates\u002Fskills\u002Fpr-screenshots\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,9,42],"screenshots","pr","pr screenshots","for","testing","high","typedoc","requests","visual-review","embed","visual","pattern","github pr","api","pull","pull-requests","sessions","playwright","review","2026-11-10 10:12:30",false,"---\r\nname: \"pr-screenshots\"\r\ndescription: \"Capture Playwright screenshots and embed them in GitHub PR descriptions\"\r\ndomain: \"pull-requests, visual-review, docs, testing\"\r\nconfidence: \"high\"\r\nsource: \"earned (multiple sessions establishing the pattern for PR #11 TypeDoc API reference)\"\r\n---\r\n\r\n## Context\r\n\r\nWhen a PR includes visual changes (docs sites, UI components, generated pages), reviewers\r\nneed to see what the PR delivers without checking out the branch. Screenshots belong in\r\nthe **PR description body**, not as committed files and not as text descriptions.\r\n\r\nUse this skill whenever:\r\n- A PR touches docs site pages (Astro, Starlight, etc.)\r\n- A PR adds or changes UI components\r\n- A PR generates visual artifacts (TypeDoc, Storybook, diagrams)\r\n- Playwright tests already capture screenshots as part of testing\r\n\r\n## Patterns\r\n\r\n### 1. Capture screenshots with Playwright\r\n\r\nIf Playwright tests already exist and produce screenshots, reuse those. Otherwise,\r\nwrite a minimal capture script:\r\n\r\n```javascript\r\n\u002F\u002F scripts\u002Fcapture-pr-screenshots.mjs\r\nimport { chromium } from 'playwright';\r\n\r\nconst browser = await chromium.launch();\r\nconst page = await browser.newPage({ viewport: { width: 1280, height: 720 } });\r\n\r\nconst screenshots = [\r\n  { url: 'http:\u002F\u002Flocalhost:4321\u002Fpath\u002Fto\u002Fpage', name: 'feature-landing' },\r\n  { url: 'http:\u002F\u002Flocalhost:4321\u002Fpath\u002Fto\u002Fdetail', name: 'feature-detail' },\r\n];\r\n\r\nfor (const { url, name } of screenshots) {\r\n  await page.goto(url, { waitUntil: 'networkidle' });\r\n  await page.screenshot({ path: `screenshots\u002F${name}.png`, fullPage: false });\r\n}\r\n\r\nawait browser.close();\r\n```\r\n\r\n### 2. Host screenshots on a temporary branch\r\n\r\nGitHub PR descriptions render images via URLs. The `gh` CLI cannot upload binary\r\nimages directly. Use a temporary orphan branch to host the images:\r\n\r\n```powershell\r\n# Save current branch\r\n$currentBranch = git branch --show-current\r\n\r\n# Create orphan branch with only screenshot files\r\ngit checkout --orphan screenshots-temp\r\ngit reset\r\ngit add screenshots\u002F*.png\r\ngit commit -m \"screenshots for PR review\"\r\ngit push origin screenshots-temp --force\r\n\r\n# Build raw URLs\r\n$base = \"https:\u002F\u002Fraw.githubusercontent.com\u002F{owner}\u002F{repo}\u002Fscreenshots-temp\u002Fscreenshots\"\r\n# Each image: $base\u002F{name}.png\r\n\r\n# Return to working branch\r\ngit checkout -f $currentBranch\r\n```\r\n\r\n### 3. Embed in PR description\r\n\r\nUse `gh pr edit` with the raw URLs embedded as markdown images:\r\n\r\n```powershell\r\n$base = \"https:\u002F\u002Fraw.githubusercontent.com\u002F{owner}\u002F{repo}\u002Fscreenshots-temp\u002Fscreenshots\"\r\n\r\ngh pr edit {PR_NUMBER} --repo {owner}\u002F{repo} --body @\"\r\n## {PR Title}\r\n\r\n### What this PR delivers\r\n- {bullet points of changes}\r\n\r\n---\r\n\r\n### Screenshots\r\n\r\n#### {Page\u002FFeature Name}\r\n![{alt text}]($base\u002F{name}.png)\r\n\r\n#### {Another Page}\r\n![{alt text}]($base\u002F{another-name}.png)\r\n\r\n---\r\n\r\n### To verify locally\r\n```bash\r\n{commands to run locally}\r\n```\r\n\"@\r\n```\r\n\r\n### 4. Cleanup after merge\r\n\r\nAfter the PR is merged, delete the temporary branch:\r\n\r\n```bash\r\ngit push origin --delete screenshots-temp\r\n```\r\n\r\n### 5. Gitignore screenshots locally\r\n\r\nScreenshots are build artifacts — never commit them to feature branches:\r\n\r\n```gitignore\r\n# PR screenshots (hosted on temp branch, not committed to features)\r\nscreenshots\u002F\r\ndocs\u002Ftests\u002Fscreenshots\u002F\r\n```\r\n\r\n## Examples\r\n\r\n### Example: Docs site PR with 3 pages\r\n\r\n1. Start dev server: `cd docs && npm run dev`\r\n2. Run Playwright tests (they capture screenshots as a side effect)\r\n3. Push screenshots to `screenshots-temp` branch\r\n4. Update PR body with embedded `![...]()` image references\r\n5. Reviewer sees the pages inline without checking out the branch\r\n\r\n### Example: Reusing existing Playwright test screenshots\r\n\r\nIf tests at `docs\u002Ftests\u002F*.spec.mjs` already save to `docs\u002Ftests\u002Fscreenshots\u002F`:\r\n\r\n```powershell\r\ncd docs && npx playwright test tests\u002Fapi-reference.spec.mjs\r\n# Screenshots now at docs\u002Ftests\u002Fscreenshots\u002F*.png\r\n# Push those to screenshots-temp and embed in PR\r\n```\r\n\r\n## Anti-Patterns\r\n\r\n- ❌ **Committing screenshots to feature branches** — they bloat the repo and go stale\r\n- ❌ **Posting text descriptions instead of actual images** — reviewers can't see what they're getting\r\n- ❌ **Using `gh` CLI to \"upload\" images** — `gh issue comment` and `gh pr edit` don't support binary uploads\r\n- ❌ **Asking the user to manually drag-drop images** — automate it with the temp branch pattern\r\n- ❌ **Skipping screenshots for visual PRs** — if the PR changes what users see, show what users see\r\n- ❌ **Leaving the screenshots-temp branch around forever** — clean up after merge\r\n","## Context\r\n\r\nWhen a PR includes visual changes (docs sites, UI components, generated pages), reviewers\r\nneed to see what the PR delivers without checking out the branch. Screenshots belong in\r\nthe **PR description body**, not as committed files and not as text descriptions.\r\n\r\nUse this skill whenever:\r\n- A PR touches docs site pages (Astro, Starlight, etc.)\r\n- A PR adds or changes UI components\r\n- A PR generates visual artifacts (TypeDoc, Storybook, diagrams)\r\n- Playwright tests already capture screenshots as part of testing\r\n\r\n## Patterns\r\n\r\n### 1. Capture screenshots with Playwright\r\n\r\nIf Playwright tests already exist and produce screenshots, reuse those. Otherwise,\r\nwrite a minimal capture script:\r\n\r\n```javascript\r\n\u002F\u002F scripts\u002Fcapture-pr-screenshots.mjs\r\nimport { chromium } from 'playwright';\r\n\r\nconst browser = await chromium.launch();\r\nconst page = await browser.newPage({ viewport: { width: 1280, height: 720 } });\r\n\r\nconst screenshots = [\r\n  { url: 'http:\u002F\u002Flocalhost:4321\u002Fpath\u002Fto\u002Fpage', name: 'feature-landing' },\r\n  { url: 'http:\u002F\u002Flocalhost:4321\u002Fpath\u002Fto\u002Fdetail', name: 'feature-detail' },\r\n];\r\n\r\nfor (const { url, name } of screenshots) {\r\n  await page.goto(url, { waitUntil: 'networkidle' });\r\n  await page.screenshot({ path: `screenshots\u002F${name}.png`, fullPage: false });\r\n}\r\n\r\nawait browser.close();\r\n```\r\n\r\n### 2. Host screenshots on a temporary branch\r\n\r\nGitHub PR descriptions render images via URLs. The `gh` CLI cannot upload binary\r\nimages directly. Use a temporary orphan branch to host the images:\r\n\r\n```powershell\r\n# Save current branch\r\n$currentBranch = git branch --show-current\r\n\r\n# Create orphan branch with only screenshot files\r\ngit checkout --orphan screenshots-temp\r\ngit reset\r\ngit add screenshots\u002F*.png\r\ngit commit -m \"screenshots for PR review\"\r\ngit push origin screenshots-temp --force\r\n\r\n# Build raw URLs\r\n$base = \"https:\u002F\u002Fraw.githubusercontent.com\u002F{owner}\u002F{repo}\u002Fscreenshots-temp\u002Fscreenshots\"\r\n# Each image: $base\u002F{name}.png\r\n\r\n# Return to working branch\r\ngit checkout -f $currentBranch\r\n```\r\n\r\n### 3. Embed in PR description\r\n\r\nUse `gh pr edit` with the raw URLs embedded as markdown images:\r\n\r\n```powershell\r\n$base = \"https:\u002F\u002Fraw.githubusercontent.com\u002F{owner}\u002F{repo}\u002Fscreenshots-temp\u002Fscreenshots\"\r\n\r\ngh pr edit {PR_NUMBER} --repo {owner}\u002F{repo} --body @\"\r\n## {PR Title}\r\n\r\n### What this PR delivers\r\n- {bullet points of changes}\r\n\r\n---\r\n\r\n### Screenshots\r\n\r\n#### {Page\u002FFeature Name}\r\n![{alt text}]($base\u002F{name}.png)\r\n\r\n#### {Another Page}\r\n![{alt text}]($base\u002F{another-name}.png)\r\n\r\n---\r\n\r\n### To verify locally\r\n```bash\r\n{commands to run locally}\r\n```\r\n\"@\r\n```\r\n\r\n### 4. Cleanup after merge\r\n\r\nAfter the PR is merged, delete the temporary branch:\r\n\r\n```bash\r\ngit push origin --delete screenshots-temp\r\n```\r\n\r\n### 5. Gitignore screenshots locally\r\n\r\nScreenshots are build artifacts — never commit them to feature branches:\r\n\r\n```gitignore\r\n# PR screenshots (hosted on temp branch, not committed to features)\r\nscreenshots\u002F\r\ndocs\u002Ftests\u002Fscreenshots\u002F\r\n```\r\n\r\n## Examples\r\n\r\n### Example: Docs site PR with 3 pages\r\n\r\n1. Start dev server: `cd docs && npm run dev`\r\n2. Run Playwright tests (they capture screenshots as a side effect)\r\n3. Push screenshots to `screenshots-temp` branch\r\n4. Update PR body with embedded `![...]()` image references\r\n5. Reviewer sees the pages inline without checking out the branch\r\n\r\n### Example: Reusing existing Playwright test screenshots\r\n\r\nIf tests at `docs\u002Ftests\u002F*.spec.mjs` already save to `docs\u002Ftests\u002Fscreenshots\u002F`:\r\n\r\n```powershell\r\ncd docs && npx playwright test tests\u002Fapi-reference.spec.mjs\r\n# Screenshots now at docs\u002Ftests\u002Fscreenshots\u002F*.png\r\n# Push those to screenshots-temp and embed in PR\r\n```\r\n\r\n## Anti-Patterns\r\n\r\n- ❌ **Committing screenshots to feature branches** — they bloat the repo and go stale\r\n- ❌ **Posting text descriptions instead of actual images** — reviewers can't see what they're getting\r\n- ❌ **Using `gh` CLI to \"upload\" images** — `gh issue comment` and `gh pr edit` don't support binary uploads\r\n- ❌ **Asking the user to manually drag-drop images** — automate it with the temp branch pattern\r\n- ❌ **Skipping screenshots for visual PRs** — if the PR changes what users see, show what users see\r\n- ❌ **Leaving the screenshots-temp branch around forever** — clean up after merge\r\n",{"name":5,"domain":48,"source":49,"confidence":29,"description":7},"pull-requests, visual-review, docs, testing","earned (multiple sessions establishing the pattern for PR #11 TypeDoc API reference)","dev","7b731ec97f35346bdc4fa87c3edaf16b808fc0ae","packages\u002Fsquad-cli\u002Ftemplates\u002Fskills\u002Fpr-screenshots",520,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad","https:\u002F\u002Fgithub.github.io\u002Fsquad\u002F","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 02:13:59",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add github\u002Fsquad --skill pr-screenshots",{"tool":66,"command":67},"bunx","bunx skills add github\u002Fsquad --skill pr-screenshots",{"tool":69,"command":70},"pnpm","pnpm dlx skills add github\u002Fsquad --skill pr-screenshots","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fpackages\u002Fsquad-cli\u002Ftemplates\u002Fskills\u002Fpr-screenshots\u002FSKILL.md",true,[],[75,83,90,97,104,111],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":82},"01M76752CVNE7K6NWD59CRAYNJ","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":82},"01M767508W8A4G83NX1FKEW5VN","versioning-policy","SemVer rules for Squad's stable, preview, insider, and local package versions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":82},"01M7674X5JJKNJ74B3SS8PGXG2","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":82},"01M7674V3S9H03A76H75M1KSAF","test-discipline","Design assertions that prove the actual contract and fail on realistic regressions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftest-discipline\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":82},"01M7674QB8CA61RNDX2Z0NAK71","squad","Squad's command catalog and interactive menu. Invoke via \u002Fsquad (slash command) or natural language (\"squad commands\", \"what can squad do\", \"show me squad options\"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":82},"01M7674KTQ632N30HQB1TP7TXH","squad-version-check","Internals of how @bradygaster\u002Fsquad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad-version-check\u002FSKILL.md",[],[]]