[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EX2WMKSRYJT1AT02N5FNGV":3,"skill-same:01M7EX2WMKSRYJT1AT02N5FNGV":52},{"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":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7EX2WMKSRYJT1AT02N5FNGV","ios-keyboard-page-shift",null,"Use when, on iPhone Safari or an iOS WebView, a page or a full-screen app shell (top bar, scrolling list, bottom input) moves up when a text field is focused and stays up after the keyboard closes, leaving the top bar off-screen, the input mid-screen and an empty band below it, or when an earlier fix for that symptom did not hold.","etherfunlab\u002Fworkflow","etherfunlab","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F268832592?v=4","01M7EX1G4TQWFYMM15QWYN2S7F","EtherFun Lab","01M7EX1G5E2EB84BQTZ6AMKQWR",76,"MIT","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fios-keyboard-page-shift\u002Fagent\u002Fskills\u002Fios-keyboard-page-shift\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ios-keyboard-page-shift\ndescription: Use when, on iPhone Safari or an iOS WebView, a page or a full-screen app shell (top bar, scrolling list, bottom input) moves up when a text field is focused and stays up after the keyboard closes, leaving the top bar off-screen, the input mid-screen and an empty band below it, or when an earlier fix for that symptom did not hold.\n---\n\n# iOS keyboard page shift\n\n## Overview\n\nTo show a focused field above the soft keyboard, iOS scrolls two kinds of things: every ancestor of the field that is a scroll container with room to scroll, and the document itself. Either one can be left displaced after the keyboard closes, and both give the same screenshot. Find which layer moved before fixing anything; a fix on the other layer changes nothing.\n\n## Step 1: find the layer\n\nLook at what fills the band below the input.\n\n| Band below the input | Layer that moved | Fix |\n|---|---|---|\n| The app's own background, continuous with the rest of the screen | an inner scroll container | A |\n| The bare `html`\u002F`body` color, with a hard edge where the app's background ends | the document | B |\n\nConfirm on the device: Safari on a Mac → Develop → the iPhone, focus the field, close the keyboard, then run:\n\n```js\nfor (let el = document.activeElement; el; el = el.parentElement) {\n  const oy = getComputedStyle(el).overflowY\n  if (oy !== 'visible' && oy !== 'clip' && el.scrollHeight > el.clientHeight) console.log(el, oy, el.scrollTop)\n}\nconsole.log('document', scrollY, visualViewport.offsetTop, visualViewport.height, innerHeight, document.documentElement.scrollHeight)\n```\n\nAny listed element other than the list that is meant to scroll, or with a non-zero `scrollTop`, means Fix A. `scrollY` above `scrollHeight - innerHeight` means Fix B. Both can be true; do A, then B.\n\n## Fix A: no outer layer can scroll\n\nAn ancestor of the field is a scroll container (`overflow` `auto`, `scroll` or `hidden`; `hidden` still scrolls for scripts and for iOS) and has scrollable overflow. The usual source is an absolutely positioned descendant (an `sr-only` label, a badge, a tooltip) whose containing block lies outside the element meant to scroll. It neither scrolls nor clips with that element, stays at its unscrolled position as far down as the list is long, and adds to the overflow of the next scroll container up.\n\n1. Make the element meant to scroll the containing block: `position: relative` on it.\n2. Give shell layers that must never scroll `overflow: clip`. It clips like `hidden` but is not a scroll container, so nothing can park it off-axis.\n\nFind escaped elements with `list` set to the element meant to scroll:\n\n```js\nfor (const el of list.querySelectorAll('*'))\n  if (getComputedStyle(el).position === 'absolute' && !list.contains(el.offsetParent)) console.log(el, el.offsetParent)\n```\n\n## Fix B: clamp the document after the keyboard closes\n\niOS should clamp the document back into range when the keyboard closes. From iOS 26 it sometimes does not; WKWebView on iOS 11 to 13.3 had the same bug. Install `keyboard-scroll-restore.js` (next to this file) once per page load, client side only. It clamps `scrollY` into `[0, scrollHeight - innerHeight]` when either:\n\n- the visual viewport goes from at least 150 px shorter than `innerHeight` (zoom factored out) back to full: a keyboard closed while focus stayed on the field;\n- 400 ms after a `focusout` that leaves no input, textarea, select or contenteditable focused: Done, or a send button that blurs. This covers iOS never reporting the viewport growing back, or reporting it before it settles its own scroll.\n\nEach condition is load-bearing:\n\n| Condition | Without it |\n|---|---|\n| clamp to the range, not to 0 | pages that scroll as the document jump to the top |\n| keyboard counted as closed within 150 px of `innerHeight` | iOS 26 can leave the viewport ~24 px short, so an exact-equality check never fires |\n| act only once the keyboard is down | the field gets pulled under the keyboard |\n| wait out the hide animation | iOS undoes a clamp made mid-animation |\n| skip when focus moved to another field | the page jumps while the user moves between fields |\n\n## Verify\n\nOnly a real iPhone shows this; desktop Safari and Playwright WebKit have no soft keyboard. Close the keyboard with Done and with the send button, move focus between two fields, and on a long page scrolled halfway close the keyboard from a field (the position must stay). If the fix does not hold, log the `document` line from Step 1 on the device before changing anything.\n\n## Common mistakes\n\n| Mistake | What happens |\n|---|---|\n| Painting the app background on `html` | The band looks right; the page is still shifted |\n| `position: fixed` on `body` or the root | Breaks pages that scroll as the document; iOS still pans the visual viewport |\n| Resizing the shell to `visualViewport.height` on every resize | Jitters as Safari's toolbar collapses |\n| Fixing layer A when the band is the bare canvas | Nothing changes |\n","# iOS keyboard page shift\n\n## Overview\n\nTo show a focused field above the soft keyboard, iOS scrolls two kinds of things: every ancestor of the field that is a scroll container with room to scroll, and the document itself. Either one can be left displaced after the keyboard closes, and both give the same screenshot. Find which layer moved before fixing anything; a fix on the other layer changes nothing.\n\n## Step 1: find the layer\n\nLook at what fills the band below the input.\n\n| Band below the input | Layer that moved | Fix |\n|---|---|---|\n| The app's own background, continuous with the rest of the screen | an inner scroll container | A |\n| The bare `html`\u002F`body` color, with a hard edge where the app's background ends | the document | B |\n\nConfirm on the device: Safari on a Mac → Develop → the iPhone, focus the field, close the keyboard, then run:\n\n```js\nfor (let el = document.activeElement; el; el = el.parentElement) {\n  const oy = getComputedStyle(el).overflowY\n  if (oy !== 'visible' && oy !== 'clip' && el.scrollHeight > el.clientHeight) console.log(el, oy, el.scrollTop)\n}\nconsole.log('document', scrollY, visualViewport.offsetTop, visualViewport.height, innerHeight, document.documentElement.scrollHeight)\n```\n\nAny listed element other than the list that is meant to scroll, or with a non-zero `scrollTop`, means Fix A. `scrollY` above `scrollHeight - innerHeight` means Fix B. Both can be true; do A, then B.\n\n## Fix A: no outer layer can scroll\n\nAn ancestor of the field is a scroll container (`overflow` `auto`, `scroll` or `hidden`; `hidden` still scrolls for scripts and for iOS) and has scrollable overflow. The usual source is an absolutely positioned descendant (an `sr-only` label, a badge, a tooltip) whose containing block lies outside the element meant to scroll. It neither scrolls nor clips with that element, stays at its unscrolled position as far down as the list is long, and adds to the overflow of the next scroll container up.\n\n1. Make the element meant to scroll the containing block: `position: relative` on it.\n2. Give shell layers that must never scroll `overflow: clip`. It clips like `hidden` but is not a scroll container, so nothing can park it off-axis.\n\nFind escaped elements with `list` set to the element meant to scroll:\n\n```js\nfor (const el of list.querySelectorAll('*'))\n  if (getComputedStyle(el).position === 'absolute' && !list.contains(el.offsetParent)) console.log(el, el.offsetParent)\n```\n\n## Fix B: clamp the document after the keyboard closes\n\niOS should clamp the document back into range when the keyboard closes. From iOS 26 it sometimes does not; WKWebView on iOS 11 to 13.3 had the same bug. Install `keyboard-scroll-restore.js` (next to this file) once per page load, client side only. It clamps `scrollY` into `[0, scrollHeight - innerHeight]` when either:\n\n- the visual viewport goes from at least 150 px shorter than `innerHeight` (zoom factored out) back to full: a keyboard closed while focus stayed on the field;\n- 400 ms after a `focusout` that leaves no input, textarea, select or contenteditable focused: Done, or a send button that blurs. This covers iOS never reporting the viewport growing back, or reporting it before it settles its own scroll.\n\nEach condition is load-bearing:\n\n| Condition | Without it |\n|---|---|\n| clamp to the range, not to 0 | pages that scroll as the document jump to the top |\n| keyboard counted as closed within 150 px of `innerHeight` | iOS 26 can leave the viewport ~24 px short, so an exact-equality check never fires |\n| act only once the keyboard is down | the field gets pulled under the keyboard |\n| wait out the hide animation | iOS undoes a clamp made mid-animation |\n| skip when focus moved to another field | the page jumps while the user moves between fields |\n\n## Verify\n\nOnly a real iPhone shows this; desktop Safari and Playwright WebKit have no soft keyboard. Close the keyboard with Done and with the send button, move focus between two fields, and on a long page scrolled halfway close the keyboard from a field (the position must stay). If the fix does not hold, log the `document` line from Step 1 on the device before changing anything.\n\n## Common mistakes\n\n| Mistake | What happens |\n|---|---|\n| Painting the app background on `html` | The band looks right; the page is still shifted |\n| `position: fixed` on `body` or the root | Breaks pages that scroll as the document; iOS still pans the visual viewport |\n| Resizing the shell to `visualViewport.height` on every resize | Jitters as Safari's toolbar collapses |\n| Fixing layer A when the band is the bare canvas | Nothing changes |\n",{"name":5,"description":7},"main","eec36e50a538ad0e02620fb07c2be53851d51ce8","skills\u002Fios-keyboard-page-shift\u002Fagent\u002Fskills\u002Fios-keyboard-page-shift",17,"https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow","https:\u002F\u002Fgithub.com\u002Fetherfunlab","https:\u002F\u002Fetherfun.xyz\u002F","2026-11-14 10:45:42",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add etherfunlab\u002Fworkflow --skill ios-keyboard-page-shift",{"tool":38,"command":39},"bunx","bunx skills add etherfunlab\u002Fworkflow --skill ios-keyboard-page-shift",{"tool":41,"command":42},"pnpm","pnpm dlx skills add etherfunlab\u002Fworkflow --skill ios-keyboard-page-shift","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fios-keyboard-page-shift\u002Fagent\u002Fskills\u002Fios-keyboard-page-shift\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"keyboard-scroll-restore.js","SCRIPT","脚本",2422,"https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fios-keyboard-page-shift\u002Fagent\u002Fskills\u002Fios-keyboard-page-shift\u002Fkeyboard-scroll-restore.js",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7EX3M6H9KPAXBR8TBA44JB3","doc-review","Use when reviewing docs in this repo (team version).","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fcollisions\u002F.claude\u002Fskills\u002Fdoc-review\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7EX3G9ZYFKGD74DXKDWGT84","zh-hant-converter","Use when Simplified Chinese text needs a Traditional Chinese version — internal team docs converted with opencc s2hk, or a product's Simplified Chinese UI copy mirrored into its Traditional Chinese locale — or when the user says 转繁, 同步繁体, or \"convert to zh-Hant\".","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fzh-hant-converter\u002Fagent\u002Fskills\u002Fzh-hant-converter\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7EX3B83SRTSBWQ3B6MKWKTF","cleaning-dev-caches","Use when this Mac's disk is nearly full, or the user asks to clear re-downloadable caches (「清缓存」「硬盘满了」, \"clear caches\") — Homebrew, npm \u002F pnpm \u002F yarn \u002F bun \u002F uv \u002F pip, Gradle, Playwright browsers, Edge and VS Code updater caches, simulator dyld caches, unused Rust toolchains. Not for build output (cleaning-dev-build-artifacts) or personal files.","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fmacos-disk-cleanup\u002Fagent\u002Fskills\u002Fcleaning-dev-caches\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7EX3647E2TEZ9TRDY689E3E","cleaning-dev-build-artifacts","Use when this Mac's disk is nearly full, or the user asks to clean build output — Rust target\u002F dirs or Claude Code worktrees (.claude\u002Fworktrees) under {{DEV_ROOT}} (「清编译产物」「清 target」「清 worktree」「硬盘满了」, \"clean build artifacts\"). Not for package-manager or app caches (cleaning-dev-caches) or personal files.","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fskills\u002Fmacos-disk-cleanup\u002Fagent\u002Fskills\u002Fcleaning-dev-build-artifacts\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7EX2RQQGFSDGJS41KNYKWA4","codex-review","Use when the user asks to review a branch, PR or diff with codex (\"review this with codex\", 用 codex 审一下, \"codex review PR N\"). Runs `codex exec` from the shell with a hand-written, repo-aware prompt; falls back to one OpenRouter GPT call only when codex is out of quota. Covers the invocation contract and the failure modes that make codex look dead or silently produce no report.","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fmodules\u002Freview\u002Fagent\u002Fskills\u002Fcodex-review\u002FSKILL.md",[],[],{"skillNo":89,"name":55,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7EX2MNHK1N8VTN6VJ4HFDZY","Use when a document for people to read has been fact-checked and polished and is one step from being pushed or published — the last gate before `git push` — or when the user asks for a final review (终审).","https:\u002F\u002Fgithub.com\u002Fetherfunlab\u002Fworkflow\u002Fblob\u002Fmain\u002Fmodules\u002Fpublish\u002Fagent\u002Fskills\u002Fdoc-review\u002FSKILL.md",[],[]]