chore: migrate skills to RPLayout, purge em dashes, prep v1.0.0-beta.0

@react-pdf-kit/viewer v2.0.0 deprecates RPDefaultLayout in favor of
RPLayout (with its structured toolbar prop and RPHorizontalBar /
RPVerticalBar slot customization). All six framework-and-layout
skills are updated to teach RPLayout. RPDefaultLayout is preserved
only as a Gotcha entry explaining the deprecation so agents migrating
existing projects pick the right target.

The toolbar-customization skill is rewritten to teach the canonical
partial-customization path (RPLayout.toolbar.topbar.component =
<RPHorizontalBar slots={{...}} />), with the fully-custom-bar
recipe (composing individual *Tool exports) preserved as step 4.
The custom-layout skill reframes the headless replacement around
RPLayout instead of RPDefaultLayout.

Catalog prose (all SKILL.md bodies, README, CLAUDE.md, MAINTENANCE.md,
CHANGELOG.md) no longer uses the em dash character. Voice tightened
across all authored content.

CHANGELOG.md now has a [1.0.0-beta.0] section, validated against
@react-pdf-kit/viewer >=1.0.0 <2.0.0. The previous [Unreleased]
content rolls into the beta. Catalog versioning is independent of
the library; per-skill metadata.react_pdf_kit_version ranges carry
the actual compatibility signal. Live sample-build trials (T026
through T031, T033, T041) remain pending; beta release is for
feedback on skill accuracy and the install workflow before v1.0.0.

Conformance: scripts/verify-all.sh passes 8/8 against the v1 catalog.
scripts/check-changelog.sh v1.0.0-beta.0 passes.

Author: kittisakLS

CHANGELOG.md

@@ -19,13 +19,25 @@ range under a **Validated against** line.
 
 ## [Unreleased]
 
-**Validated against**: `@react-pdf-kit/viewer` *TBD on first release.*
+(No changes yet since v1.0.0-beta.0.)
+
+## [1.0.0-beta.0] - 2026-05-14
+
+First public pre-release for testing. The catalog and verification
+scripts are feature-complete for v1, but the live build-verification
+trials documented in the spec (T026 through T031, T033, T041) have
+not yet been executed end to end against real `pnpm create next-app`
+and `pnpm create vite` projects. Feedback wanted on skill accuracy,
+agent activation behavior, and the install workflow before promoting
+to v1.0.0.
+
+**Validated against**: `@react-pdf-kit/viewer` `>=1.0.0 <2.0.0`
 
 ### Added
 
 - Initial scaffolding: LICENSE (MIT), README, MAINTENANCE,
   .gitignore. (CONTRIBUTING and CODEOWNERS were authored and then
-  removed before first release — see Removed below.)
+  removed before first release. See Removed below.)
 - Conformance scripts: `scripts/verify-skill.sh`,
   `scripts/verify-all.sh`, `scripts/apply-skill-to-sample.sh`,
   `scripts/check-changelog.sh`.
@@ -45,7 +57,20 @@ range under a **Validated against** line.
 
 ### Changed
 
-- (none yet)
+- All skills and the README now teach `RPLayout` as the canonical
+  layout component. `RPDefaultLayout` is deprecated in
+  `@react-pdf-kit/viewer` v2.0.0 and will be removed in a future
+  release. Each affected skill (setup, vite, nextjs-app-router,
+  nextjs-pages-router, toolbar-customization, custom-layout) ships
+  an explicit Gotcha entry calling out the deprecation, and the
+  toolbar-customization skill is rewritten to teach
+  `RPLayout`'s `toolbar` prop with `RPHorizontalBar` /
+  `RPVerticalBar` slot customization. The "fully custom bar"
+  fallback (composing individual `*Tool` exports) is preserved as
+  step 4 of that skill.
+- Catalog prose (SKILL.md bodies, README, CLAUDE.md, MAINTENANCE.md)
+  no longer uses the em dash character. Voice tightened across all
+  authored content.
 
 ### Deprecated
 

CLAUDE.md

@@ -33,7 +33,7 @@ It is a content/documentation repo, not a JavaScript application.
 └── .github/workflows/              # verify.yml, samples.yml, release.yml
 ```
 
-External contributions are **not currently accepted** — see the
+External contributions are **not currently accepted**. See the
 "Contributions" section in `README.md`. The author workflow below is
 for maintainers.
 
@@ -70,7 +70,7 @@ scripts/check-changelog.sh v1.0.0
    ---
    ```
 
-   Allow-listed fields only — `verify-skill.sh` rule R-15 fails on
+   Allow-listed fields only. `verify-skill.sh` rule R-15 fails on
    unknown keys. Optional: `metadata.tags`, `metadata.deprecated_in`,
    `metadata.internal`.
 
@@ -104,16 +104,16 @@ The library that this catalog teaches is governed by a project
 constitution that lives in the React PDF Kit workspace (not in this
 repo). Skills MUST NOT contradict its five principles:
 
-1. Viewer-First Experience — never advise patterns that degrade
+1. Viewer-First Experience: never advise patterns that degrade
    reader UX (text selection, keyboard nav, a11y).
-2. Integrator Respect — no globals, no peer-dep bundling, no
+2. Integrator Respect: no globals, no peer-dep bundling, no
    bundler monkey-patching.
-3. Composable & Headless-Capable — default-layout skills use the
+3. Composable & Headless-Capable: default-layout skills use the
    full provider chain; customization skills use documented hooks
    only.
-4. Performance & Rendering Discipline — no instruction breaks
+4. Performance & Rendering Discipline: no instruction breaks
    virtualization or moves PDF.js off the worker.
-5. Peer Dependency & Compatibility Stewardship — every skill
+5. Peer Dependency & Compatibility Stewardship: every skill
    declares `metadata.react_pdf_kit_version` and
    `metadata.pdfjs_dist_version` matching the sample that verified it.
 

MAINTENANCE.md

@@ -60,8 +60,8 @@ version range** the skills were exercised against.
 
 ## Deprecation flow
 
-To deprecate a skill **without** removing it (preferred — gives
-consumers time to migrate):
+To deprecate a skill **without** removing it (preferred, since it
+gives consumers time to migrate):
 
 1. Add `metadata.deprecated_in: <next-release-version>` to the skill's
    frontmatter.
@@ -109,7 +109,7 @@ release after v1.0.0.
 
 | Date | Action | Notes |
 |------|--------|-------|
-| — | — | First entry will be added on submission. |
+|      |        | First entry will be added on submission. |
 
 ## Sample inventory
 
@@ -131,8 +131,8 @@ end-to-end to ensure the runbook stays accurate. Record each walk here.
 
 | Date | Flow | Outcome |
 |------|------|---------|
-| — | Deprecation drill (per tasks T038) | TBD |
-| — | First release (v1.0.0, per tasks T045) | TBD |
+|      | Deprecation drill (per tasks T038) | TBD |
+|      | First release (v1.0.0, per tasks T045) | TBD |
 
 ## Security review
 

README.md

@@ -1,16 +1,16 @@
 # @react-pdf-kit/agent-skills
 
-> Agent skills for [@react-pdf-kit/viewer](https://github.com/react-pdf-kit/viewer)
-> — install with `npx skills add react-pdf-kit/agent-skills` and let your
+> Agent skills for [@react-pdf-kit/viewer](https://github.com/react-pdf-kit/viewer).
+> Install with `npx skills add react-pdf-kit/agent-skills` and let your
 > AI coding agent integrate the React PDF Kit library correctly on the
 > first attempt.
 
 This repository is a curated catalog of [agent skills](https://agentskills.io)
-that teach AI coding agents (Claude Code, Cursor, OpenCode, Codex, …) how
-to set up, customize, and troubleshoot the React PDF Kit viewer across
-the React, Next.js, and Vite ecosystems. Skills are installed via the
-open-source [vercel-labs/skills](https://github.com/vercel-labs/skills)
-CLI.
+that teach AI coding agents (Claude Code, Cursor, OpenCode, Codex, and
+anything else that follows the same convention) how to set up,
+customize, and troubleshoot the React PDF Kit viewer across the React,
+Next.js, and Vite ecosystems. Skills are installed via the open-source
+[vercel-labs/skills](https://github.com/vercel-labs/skills) CLI.
 
 ## Who is this for?
 
@@ -102,15 +102,15 @@ These behaviors are governed by the upstream
 [vercel-labs/skills](https://github.com/vercel-labs/skills) CLI; reading
 them here helps you interpret errors quickly.
 
-- **`no matching skill` after `npx skills add <name>`** — the name is
+- **`no matching skill` after `npx skills add <name>`**: the name is
   wrong or the skill has been renamed. Symptom: CLI exits non-zero with
   a "no matching skill" line. Response: run `npx skills find <keyword>`
   and pick the exact `name` from the result list.
-- **Network failure during `add`** — the CLI fails fast with the
+- **Network failure during `add`**: the CLI fails fast with the
   underlying transport error and does **not** leave a partial install.
   Response: retry once the network is restored. There is no recovery
   step needed.
-- **Re-install of an already-installed skill** — the CLI prompts before
+- **Re-install of an already-installed skill**: the CLI prompts before
   overwriting (or refuses if `--yes` is not set). Response: either
   confirm overwrite (you lose local edits to the installed copy) or
   decline and uninstall the existing copy first with
@@ -122,23 +122,22 @@ gotchas, stale version range), open an issue in this repository.
 ## How an AI agent discovers and uses this repo
 
 The transcript below is a representative session showing the
-discover → install → ask flow. It is the same flow the spec's SC-001
+discover, install, ask flow. It is the same flow the spec's SC-001
 trial protocol exercises (see
-`specs/001-react-pdf-kit-skills/tasks.md` T041); replace this
-example with an anonymized real session captured during T041 once
-that runs.
+`specs/001-react-pdf-kit-skills/tasks.md` T041). Replace this example
+with an anonymized real session captured during T041 once that runs.
 
 ```text
 $ pnpm create next-app@latest my-pdf-app -- --ts --eslint --app --no-tailwind --no-src-dir --turbo
-… (Next.js scaffold completes)
+... (Next.js scaffold completes)
 
 $ cd my-pdf-app
 
 $ npx skills find "react pdf kit next.js"
-react-pdf-kit-nextjs-app-router          Integrate @react-pdf-kit/viewer (>=1.0.0 <2.0.0) into a Next.js…
-react-pdf-kit-nextjs14-pdfjs-override    Override pdfjs-dist to v4 to work around the Next.js 14 + pdfjs-dist v5…
-react-pdf-kit-nextjs-pages-router        Integrate @react-pdf-kit/viewer (>=1.0.0 <2.0.0) into a Next.js Pages…
-react-pdf-kit-worker-config              Configure the PDF.js worker URL across supported bundlers…
+react-pdf-kit-nextjs-app-router          Integrate @react-pdf-kit/viewer (>=1.0.0 <2.0.0) into a Next.js...
+react-pdf-kit-nextjs14-pdfjs-override    Override pdfjs-dist to v4 to work around the Next.js 14 + pdfjs-dist v5...
+react-pdf-kit-nextjs-pages-router        Integrate @react-pdf-kit/viewer (>=1.0.0 <2.0.0) into a Next.js Pages...
+react-pdf-kit-worker-config              Configure the PDF.js worker URL across supported bundlers...
 
 $ npx skills add react-pdf-kit/agent-skills#react-pdf-kit-nextjs-app-router
 Installed react-pdf-kit-nextjs-app-router into .claude/skills/
@@ -154,7 +153,7 @@ $ # Open Claude Code (or your agent of choice) and ask:
 # the first PDF page.
 ```
 
-The same shape works under Cursor, OpenCode, and Codex — the CLI
+The same shape works under Cursor, OpenCode, and Codex. The CLI
 routes the install into the right per-agent directory automatically.
 
 ## Contributions
@@ -176,10 +175,10 @@ versioning policy, deprecation flow, and skills.sh submission tracker.
 
 ## Related projects
 
-- [react-pdf-kit/viewer](https://github.com/react-pdf-kit/viewer) — the
+- [react-pdf-kit/viewer](https://github.com/react-pdf-kit/viewer): the
   React PDF Kit library this catalog teaches.
-- [agentskills.io](https://agentskills.io) — the agent-skills standard.
-- [vercel-labs/skills](https://github.com/vercel-labs/skills) — the
+- [agentskills.io](https://agentskills.io): the agent-skills standard.
+- [vercel-labs/skills](https://github.com/vercel-labs/skills): the
   open-source `npx skills` CLI implementing the standard.
 
 ## License

skills/react-pdf-kit-custom-layout/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: react-pdf-kit-custom-layout
-description: Build a fully headless / custom layout for @react-pdf-kit/viewer (>=1.0.0 <2.0.0) using only documented hooks (useDocumentContext, useZoomContext, usePaginationContext, etc.) — replace RPDefaultLayout entirely.
+description: Build a fully headless / custom layout for @react-pdf-kit/viewer (>=1.0.0 <2.0.0) using only documented hooks (useDocumentContext, useZoomContext, usePaginationContext, etc.), replacing RPLayout entirely.
 metadata:
   react_pdf_kit_version: ">=1.0.0 <2.0.0"
   pdfjs_dist_version: ">=5.0.0 <6.0.0"
@@ -11,20 +11,21 @@ metadata:
 # react-pdf-kit-custom-layout
 
 **Use this skill when**: the developer asks to replace the default
-viewer layout entirely with their own — embedded inline preview, a
-sidebar-only minimal reader, an enterprise UI with a custom toolbar
-on the side instead of the top, etc. For small toolbar tweaks while
-keeping the default layout, use `react-pdf-kit-toolbar-customization`.
+viewer layout entirely with their own. Examples: embedded inline
+preview, a sidebar-only minimal reader, an enterprise UI with a
+custom toolbar on the side instead of the top. For small toolbar
+tweaks while keeping the default layout, use
+`react-pdf-kit-toolbar-customization`.
 
-The viewer is composable: `RPProvider` and `RPPages` are the minimum
-required. Everything else (`RPDefaultLayout`, `RPTheme`, individual
-toolbar tools) can be swapped or omitted. State and actions are
-exposed via documented hooks.
+The viewer is composable. `RPProvider` and `RPPages` are the minimum
+required. Everything else (`RPLayout`, `RPTheme`, individual toolbar
+tools) can be swapped or omitted. State and actions are exposed via
+documented hooks.
 
 ## Gotchas
 
 - **`RPProvider` and `RPPages` are required.** `RPProvider` mounts
-  the document and makes the contexts available; `RPPages` renders
+  the document and makes the contexts available. `RPPages` renders
   the virtualized page list. Removing either breaks the viewer.
 - **Use only documented hooks.** Reaching into internal contexts via
   `React.useContext(InternalContext)` is unsupported and will break
@@ -37,13 +38,19 @@ exposed via documented hooks.
   ancestor that doesn't have a measurable height (no `flex: 1` /
   `min-height: 0`, no fixed height) makes the virtualizer mount with
   0 rows. Always give it a real viewport.
-- **Provider order matters.** `RPConfig` must be outermost,
-  `RPProvider` next, `RPTheme` (optional but harmless) inside that.
+- **Provider order matters.** `RPConfig` must be outermost, then
+  `RPProvider`, then `RPTheme` (optional but harmless) inside that.
   Anywhere inside `RPProvider` you can call the hooks.
 - **`RPTheme` is still recommended** even in custom layouts. It
   provides CSS custom properties that built-in components (page
   layers, text selection highlight) read. Skipping it works visually
   but loses dark-mode and theming.
+- **Note on `RPLayout` vs `RPDefaultLayout`**: this skill *replaces*
+  the default layout component, so neither appears in the final
+  composition. Older code that imports `RPDefaultLayout` should
+  migrate to `RPLayout` first (it is deprecated in
+  `@react-pdf-kit/viewer` v2.0.0) before headless migration, so the
+  two refactors don't get tangled.
 
 ## Procedure
 
@@ -73,7 +80,7 @@ export function HeadlessPdfViewer({ src }: { src: string }) {
 ```
 
 `CustomShell` (next step) is where YOU place `RPPages` next to your
-own toolbar / sidebar / status bar.
+own toolbar, sidebar, or status bar.
 
 ### 2. Build the shell using documented hooks
 
@@ -112,7 +119,7 @@ export function CustomShell() {
           borderBottom: '1px solid var(--rp-border, #e5e7eb)',
         }}
       >
-        <span>{isLoading ? 'Loading…' : `${numPages} pages`}</span>
+        <span>{isLoading ? 'Loading...' : `${numPages} pages`}</span>
         <button
           type="button"
           onClick={() => setZoom(zoom + 0.1)}
@@ -125,15 +132,15 @@ export function CustomShell() {
           onClick={() => setZoom(zoom - 0.1)}
           aria-label="Zoom out"
         >
-          −
+          -
         </button>
         <span style={{ flex: 1 }} />
         <button
           type="button"
           onClick={toggleDarkMode}
           aria-pressed={isDarkMode}
         >
-          {isDarkMode ? '☼ Light' : '☾ Dark'}
+          {isDarkMode ? 'Light' : 'Dark'}
         </button>
       </header>
 
@@ -171,20 +178,20 @@ parent has a measurable height.
 
 ### 3. Memoize where it matters
 
-If you compute derived state to pass into `RPProvider` (e.g., a
-file-loading callback or options object), memoize it. The provider
+If you compute derived state to pass into `RPProvider` (for example,
+a file-loading callback or options object), memoize it. The provider
 re-renders all children on identity changes, so a new object every
 render disables virtualization gains.
 
 ```tsx
 const options = useMemo(() => ({ withCredentials: true }), [])
-return <RPProvider src={src} options={options}>…</RPProvider>
+return <RPProvider src={src} options={options}>...</RPProvider>
 ```
 
 ### 4. (Optional) Add search, rotation, view modes
 
-Same pattern: import the hook, call it, render UI bound to its
-state/actions. `useSearchContext`, `useHighlightContext`,
+Same pattern: import the hook, call it, render UI bound to its state
+and actions. `useSearchContext`, `useHighlightContext`,
 `useRotationContext`, `useViewModeContext` are all documented.
 
 ## Verify
@@ -202,13 +209,13 @@ Open the page. Confirm:
   `aria-current` indicator).
 - Zoom buttons resize pages without remounting the viewer.
 - Dark-mode toggle flips the theme.
-- Scrolling still virtualizes — only mounted pages should be in the
-  DOM (DevTools → Elements; `RPPages` should render a windowed
-  subset).
+- Scrolling still virtualizes. Only mounted pages should be in the
+  DOM (DevTools, Elements panel: `RPPages` should render a windowed
+  subset, not all pages at once).
 
 ## References
 
 - Companion skills:
-  - `react-pdf-kit-setup` — first-time setup.
-  - `react-pdf-kit-toolbar-customization` — for keeping the default
+  - `react-pdf-kit-setup`: first-time setup.
+  - `react-pdf-kit-toolbar-customization`: for keeping the default
     layout but tweaking toolbar contents.