Document the bundled library skill (README + docs); fix changelog wording

Author: igorbenav

README.md

@@ -70,6 +70,18 @@ Or with uv:
 uv add crudauth
 ```
 
+## AI agents (library skill)
+
+crudauth ships a [library skill](https://library-skills.io) embedded in the package, so AI coding
+agents follow its actual conventions and gotchas (account shapes, gates, recovery, custom email
+bodies, production wiring) in sync with the version you installed. After adding crudauth, install it
+into your project:
+
+```bash
+uvx library-skills            # scans deps, links bundled skills (re-run to keep them in sync on upgrade)
+uvx library-skills --claude   # for Claude Code (.claude/skills)
+```
+
 ## Quickstart
 
 Sessions are the default - no `transports=` needed. You get cookie auth, CSRF,

docs/changelog.md

@@ -18,10 +18,11 @@ branded HTML for the verify / reset / change emails instead of delivering crudau
   an XSS or credential-leak vector. `context.link` is the same assembled URL as in `body` (one
   source). Per-user personalization (`Hi Alice`) stays a `DeliveryChannel` concern (it has the `db`
   handle and owns escaping).
-- **Bundled Agent Skill** (`crudauth/.agents/skills/crudauth/`): crudauth now ships a
-  [library skill](https://agentskills.io), so AI coding agents that support the format get crudauth's
-  conventions and gotchas (account shapes, gates, recovery, custom email bodies, production wiring) on
-  demand when working in a project that depends on it. Installed automatically with the package.
+- **Bundled library skill** (`crudauth/.agents/skills/crudauth/`): crudauth now ships an embedded
+  [library skill](https://library-skills.io), so AI coding agents follow crudauth's actual conventions
+  and gotchas (account shapes, gates, recovery, custom email bodies, production wiring) in sync with the
+  installed version. It travels in the wheel; install it into your project's agent with
+  `uvx library-skills` (add `--claude` for Claude Code).
 
 #### Breaking changes
 - **`EmailSender.send` gains a required `context` parameter.** Add it to your `send` signature

docs/index.md

@@ -72,6 +72,11 @@
 
 For OAuth, Redis, and device parsing, install the extras: `pip install "crudauth[all]"`.
 
+CRUDAuth ships a [library skill](https://library-skills.io) embedded in the package, so AI coding
+agents follow its actual conventions in sync with the installed version. Install it into your project
+with `uvx library-skills` (add `--claude` for Claude Code); re-run it after upgrading to keep the
+skill current.
+
 ### 2. Mount the router
 
 Sessions are the default - no `transports=` needed. You get cookie auth, CSRF,