[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78295WTXCQJCP3K95VAR5WT":3,"skill-same:01M78295WTXCQJCP3K95VAR5WT":47},{"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":31,"updatedAt":32,"install":33,"resources":46},"01M78295WTXCQJCP3K95VAR5WT","update-docs",null,"Keep apps\u002Fdocs in sync with merged product changes. On each run, audit recently merged PRs against docs content, update only drifted pages, verify with blume build, and open or update a docs\u002F* PR — or report a clean no-op.","stainless-code\u002Fpersist","stainless-code","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F188862219?v=4","01M7826VYMCF2NTQWQZRWQ454T","STAINLESS CODE","01M7826VZKNC149Y9ZNK0F93N7",5,"MIT","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fupdate-docs\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: update-docs\ndescription: Keep apps\u002Fdocs in sync with merged product changes. On each run, audit recently merged PRs against docs content, update only drifted pages, verify with blume build, and open or update a docs\u002F* PR — or report a clean no-op.\n---\n\n# Update docs — sync apps\u002Fdocs with merged PRs\n\nUpstream workflow: [`npx skills add haydenbleasel\u002Fblume --skill blume-update-docs`](https:\u002F\u002Fgithub.com\u002Fhaydenbleasel\u002Fblume). This local skill encodes it for scheduled agents in this repo.\n\n## When to use\n\n- **Scheduled** — weekly (or similar) run to catch docs drift from merged PRs.\n- **On demand** — after a batch of merged PRs that may have changed public API surfaces, seams, or Blume config.\n\n## Workflow\n\n1. **Collect merged PRs** in the lookback window (default **7 days**): `git log --since=\"7 days ago\" --merges --first-parent` and `gh pr list --state merged --search \"merged:>$DATE\"`. _Done: every merged PR in the window listed with title, number, and surfaces touched._\n2. **Drop feature-flagged work** — skip PRs\u002Fcommits touching flag-gated code; never document unreleased surfaces. _Done: flag-gated PRs removed from the list._\n3. **Map changed surfaces to docs pages** — trace diffs in `src\u002Fcore\u002F`, `src\u002Fadapters\u002F**`, `package.json` `exports`, `blume.config.ts` \u002F `apps\u002Fdocs\u002F**`, and TypeDoc-facing JSDoc to the pages that document them (`content\u002Freference\u002Fapi\u002F**`, `content\u002Fguides\u002F**`, `content\u002Frecipes\u002F**`, `content\u002Fconcepts\u002F**`, `content\u002Fadapters\u002F**`, plus homepage `_home\u002F**` when behavior framing changed). Regenerate API MDX via `bun run docs:api` when public exports\u002FJSDoc drifted. _Done: every changed public surface mapped to zero or more docs pages._\n4. **Edit only drifted facts** — signatures, option tables, behavior descriptions, entry-point peers. Use [`docs-voice`](..\u002Fdocs-voice\u002FSKILL.md); do not rewrite stable prose. Competitor framing stays store persist middlewares only. _Done: every drifted fact updated; no stable prose touched._\n5. **Verify** — `bun run docs:validate -- --strict && bun run docs:check -- --isolated && bun run docs:build -- --isolated` (or root filter equivalents); fix until green. **Do not commit if any fail.** Per [`verify-after-each-step`](..\u002F..\u002Frules\u002Fverify-after-each-step.md). _Done: all three green._\n6. **Open or update a PR** on branch `docs\u002Fsync-\u003Cdate>` with a summary of what drifted and the fixes. Label it **`docs`** so merge deploys `\u002Fpersist` ([`docs-governance\u002FLIFECYCLE.md`](..\u002Fdocs-governance\u002FLIFECYCLE.md) § README surfaces). Follow commit\u002FPR conventions; never `--no-verify` ([`no-bypass-hooks`](..\u002F..\u002Frules\u002Fno-bypass-hooks.md)). _Done: PR open with `docs` label and drift summary, or step 7 applies._\n7. **Clean no-op** — if nothing drifted, report the PRs checked and surfaces audited; **do not open a PR.** _Done: report lists every PR checked and every surface audited._\n\n## Boundaries\n\n- **Only `apps\u002Fdocs\u002F`** (+ root scripts\u002Fconfig that the docs app requires, e.g. `typedoc.json` when regenerating API) — never edit maintainer `docs\u002F` plans\u002Fresearch in a sync PR; never edit library `src\u002F` in a docs-sync PR.\n- **Minimal diffs** — drifted facts only; no cosmetic rewrites, unrelated refactors, or removing source comments in touched files ([`authoring-discipline`](..\u002F..\u002Frules\u002Fauthoring-discipline.md)).\n- **No PR on a clean no-op; no commit on a failing build.**\n\n## Reference\n\n- Verify loop: [`verify-after-each-step`](..\u002F..\u002Frules\u002Fverify-after-each-step.md) · [`harden-pr`](..\u002Fharden-pr\u002FSKILL.md) (lite before commit, full before merge)\n- Authoring: [`authoring-discipline`](..\u002F..\u002Frules\u002Fauthoring-discipline.md)\n- Voice\u002Ftone\u002Fformat for the public site: [`docs-voice`](..\u002Fdocs-voice\u002FSKILL.md)\n- Docs site scope: [`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) (governs `docs\u002F`; this skill governs `apps\u002Fdocs\u002F` sync only)\n","# Update docs — sync apps\u002Fdocs with merged PRs\n\nUpstream workflow: [`npx skills add haydenbleasel\u002Fblume --skill blume-update-docs`](https:\u002F\u002Fgithub.com\u002Fhaydenbleasel\u002Fblume). This local skill encodes it for scheduled agents in this repo.\n\n## When to use\n\n- **Scheduled** — weekly (or similar) run to catch docs drift from merged PRs.\n- **On demand** — after a batch of merged PRs that may have changed public API surfaces, seams, or Blume config.\n\n## Workflow\n\n1. **Collect merged PRs** in the lookback window (default **7 days**): `git log --since=\"7 days ago\" --merges --first-parent` and `gh pr list --state merged --search \"merged:>$DATE\"`. _Done: every merged PR in the window listed with title, number, and surfaces touched._\n2. **Drop feature-flagged work** — skip PRs\u002Fcommits touching flag-gated code; never document unreleased surfaces. _Done: flag-gated PRs removed from the list._\n3. **Map changed surfaces to docs pages** — trace diffs in `src\u002Fcore\u002F`, `src\u002Fadapters\u002F**`, `package.json` `exports`, `blume.config.ts` \u002F `apps\u002Fdocs\u002F**`, and TypeDoc-facing JSDoc to the pages that document them (`content\u002Freference\u002Fapi\u002F**`, `content\u002Fguides\u002F**`, `content\u002Frecipes\u002F**`, `content\u002Fconcepts\u002F**`, `content\u002Fadapters\u002F**`, plus homepage `_home\u002F**` when behavior framing changed). Regenerate API MDX via `bun run docs:api` when public exports\u002FJSDoc drifted. _Done: every changed public surface mapped to zero or more docs pages._\n4. **Edit only drifted facts** — signatures, option tables, behavior descriptions, entry-point peers. Use [`docs-voice`](..\u002Fdocs-voice\u002FSKILL.md); do not rewrite stable prose. Competitor framing stays store persist middlewares only. _Done: every drifted fact updated; no stable prose touched._\n5. **Verify** — `bun run docs:validate -- --strict && bun run docs:check -- --isolated && bun run docs:build -- --isolated` (or root filter equivalents); fix until green. **Do not commit if any fail.** Per [`verify-after-each-step`](..\u002F..\u002Frules\u002Fverify-after-each-step.md). _Done: all three green._\n6. **Open or update a PR** on branch `docs\u002Fsync-\u003Cdate>` with a summary of what drifted and the fixes. Label it **`docs`** so merge deploys `\u002Fpersist` ([`docs-governance\u002FLIFECYCLE.md`](..\u002Fdocs-governance\u002FLIFECYCLE.md) § README surfaces). Follow commit\u002FPR conventions; never `--no-verify` ([`no-bypass-hooks`](..\u002F..\u002Frules\u002Fno-bypass-hooks.md)). _Done: PR open with `docs` label and drift summary, or step 7 applies._\n7. **Clean no-op** — if nothing drifted, report the PRs checked and surfaces audited; **do not open a PR.** _Done: report lists every PR checked and every surface audited._\n\n## Boundaries\n\n- **Only `apps\u002Fdocs\u002F`** (+ root scripts\u002Fconfig that the docs app requires, e.g. `typedoc.json` when regenerating API) — never edit maintainer `docs\u002F` plans\u002Fresearch in a sync PR; never edit library `src\u002F` in a docs-sync PR.\n- **Minimal diffs** — drifted facts only; no cosmetic rewrites, unrelated refactors, or removing source comments in touched files ([`authoring-discipline`](..\u002F..\u002Frules\u002Fauthoring-discipline.md)).\n- **No PR on a clean no-op; no commit on a failing build.**\n\n## Reference\n\n- Verify loop: [`verify-after-each-step`](..\u002F..\u002Frules\u002Fverify-after-each-step.md) · [`harden-pr`](..\u002Fharden-pr\u002FSKILL.md) (lite before commit, full before merge)\n- Authoring: [`authoring-discipline`](..\u002F..\u002Frules\u002Fauthoring-discipline.md)\n- Voice\u002Ftone\u002Fformat for the public site: [`docs-voice`](..\u002Fdocs-voice\u002FSKILL.md)\n- Docs site scope: [`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) (governs `docs\u002F`; this skill governs `apps\u002Fdocs\u002F` sync only)\n",{"name":5,"description":7},"main","29ca2183c92cd13e04ce6c14fb431fd6993862cd",".agents\u002Fskills\u002Fupdate-docs",0,"https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist","https:\u002F\u002Fgithub.com\u002Fstainless-code","https:\u002F\u002Fstainless-code.com\u002F","Open-source tooling for JS\u002FTS and AI agents.","2026-11-01 20:56:20",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add stainless-code\u002Fpersist --skill update-docs",{"tool":39,"command":40},"bunx","bunx skills add stainless-code\u002Fpersist --skill update-docs",{"tool":42,"command":43},"pnpm","pnpm dlx skills add stainless-code\u002Fpersist --skill update-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fupdate-docs\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M782D4ZQGJPNT470FSKDB6A8","vue-persist","Gate Vue 3 UI on Persist hydration with useHydrated (shallowRef). Use in setup\u002FeffectScope when avoiding flash of default state on async backends.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fvue-persist\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M782D1GJRWNQ3458F3H1FK2F","svelte-store-persist","Gate Svelte store-based UI on Persist hydration with hydratedStore (Readable). Use for Svelte 3–4 or Svelte 5 apps that still use stores; runes UI → svelte-persist.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsvelte-store-persist\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M782CWBTRWAQ52TBNQ8665CC","svelte-persist","Gate Svelte 5 runes UI on Persist hydration with hydratedRune (.current). Use for Svelte 5; for stores \u002F Svelte 3–4 use svelte-store-persist.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsvelte-persist\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M782CR8Z2V3SJW661RTMWY2F","solid-persist","Gate Solid UI on Persist hydration with useHydrated (Accessor). Use when avoiding flash of default state on async backends; read hydrated() in reactive scopes.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsolid-persist\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M782CJQGP7739WA9BS801HZP","react-persist","Gate React UI on Persist hydration with useHydrated + toHydrationSignal. Use when avoiding flash of default state on async backends (IndexedDB), SSR snapshot true, or wiring HydrationSignal into React 18\u002F19.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Freact-persist\u002FSKILL.md",[],[],{"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":19},"01M782CF96RMXCDETM5TF2JDRV","preact-persist","Gate Preact UI on Persist hydration with useHydrated (preact\u002Fcompat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fpreact-persist\u002FSKILL.md",[],[]]