@skaile/workspaces 5.3.0 → 5.5.0

package/dist/factory-assets/connectors/sharepoint.js

@@ -1,31 +1,31 @@
-export { SharePointConnector, createConnector14 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { SharePointConnector, createConnector14 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/sqlite.js

@@ -1,31 +1,31 @@
-export { SQLiteConnector, createConnector15 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { SQLiteConnector, createConnector15 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/static-server.js

@@ -1,31 +1,31 @@
-export { StaticServerConnector, createConnector16 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { StaticServerConnector, createConnector16 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/tunnel.js

@@ -1,31 +1,31 @@
-export { TunnelConnector, createConnector17 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { TunnelConnector, createConnector17 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/webdav.js

@@ -1,31 +1,31 @@
-export { WebDAVConnector, createConnector18 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { WebDAVConnector, createConnector18 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/xstate-store.js

@@ -1,31 +1,31 @@
-export { XStateStoreConnector, createConnector20 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { XStateStoreConnector, createConnector20 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/connectors/xstate.js

@@ -1,31 +1,31 @@
-export { XStateConnector, createConnector19 as createConnector } from '../../chunk-OOKFZW6H.js';
+export { XStateConnector, createConnector19 as createConnector } from '../../chunk-UHLBDAJR.js';
 import '../../chunk-QMWMSZQ4.js';
-import '../../chunk-CZ35I4RK.js';
-import '../../chunk-7L4WFH3Y.js';
+import '../../chunk-X4GO3GJZ.js';
+import '../../chunk-JBPG5KQC.js';
 import '../../chunk-LAI7X6I2.js';
 import '../../chunk-EINLFFP6.js';
 import '../../chunk-LOO5CB5M.js';
 import '../../chunk-BNUZEYC3.js';
-import '../../chunk-ERCSHLTF.js';
+import '../../chunk-LCULZ4ED.js';
 import '../../chunk-XBSQ4KMC.js';
 import '../../chunk-YROR332M.js';
-import '../../chunk-FTYM4VRZ.js';
+import '../../chunk-V7VDSFPS.js';
 import '../../chunk-6E6PKKAD.js';
 import '../../chunk-IFGTRL2I.js';
-import '../../chunk-LM5XEFNS.js';
+import '../../chunk-DPMKI26Y.js';
 import '../../chunk-37FTLYFP.js';
 import '../../chunk-QZLWJETK.js';
 import '../../chunk-XUUYAS3Z.js';
 import '../../chunk-NFGRW3L7.js';
 import '../../chunk-QCI6D7E4.js';
 import '../../chunk-K2K7OF4P.js';
-import '../../chunk-6GBQND2F.js';
+import '../../chunk-3JHFFIQ6.js';
 import '../../chunk-4GY63JU6.js';
-import '../../chunk-4SSKKFDF.js';
+import '../../chunk-YK7WJSTD.js';
 import '../../chunk-XGIS325V.js';
 import '../../chunk-5BEFNLOR.js';
 import '../../chunk-A2ULN3KX.js';
-import '../../chunk-KBAE7PU7.js';
+import '../../chunk-ORUHADS6.js';
 import '../../chunk-MFHKHXDE.js';
 import '../../chunk-TOSHZX4C.js';
 import '../../chunk-SR4RFKHM.js';

package/dist/factory-assets/skills/authoring-skaile-assets/SKILL.md

@@ -2,7 +2,7 @@
 name: authoring-skaile-assets
 description: "Use when authoring or restructuring an AI-asset repository (skills, agents, prompts, contracts, MCP servers, connectors, flows, bundles) so it resolves cleanly through @skaile/workspaces and any store. Covers file layout, the 11 asset kinds, frontmatter conventions, the requires-vs-dependencies split, and how to test a source locally before publishing."
 metadata:
-  version: '0.1.0'
+  version: '0.1.1'
   stage: alpha
   tags:
     - skaile
@@ -21,14 +21,14 @@ metadata:
 You are helping an author build or fix an **AI-asset repository** (a "source") so
 that `@skaile/workspaces` — and any store mirroring it — can discover, resolve,
 and deploy its assets. This skill owns the *content* side (files on disk). Its
-companion **[authoring-skaile-manifests]** owns the `skaile.yaml` manifest and
+companion **[authoring-skaile-manifests]** owns the `skaile.manifest.yaml` manifest and
 the dependency grammar; read it before publishing.
 
 ## Mental model
 
 A **source** is a git repo of asset bytes. Identity is the global tuple
 `(publisher, kind, name, version)` and is **asset-intrinsic** — declared in the
-source's own `skaile.yaml`, never chosen by the consuming project. A consumer
+source's own `skaile.manifest.yaml`, never chosen by the consuming project. A consumer
 reaches the bytes by cloning the source repo (`sources[]`) or by querying a
 catalog (`stores[]`); both paths are content-hash verified and interchangeable.
 
@@ -58,11 +58,11 @@ catalog (`stores[]`); both paths are content-hash verified and interchangeable.
 
 ## File layout — two options
 
-**A. Explicit (recommended for curated repos).** Put `skaile.yaml` at the repo
-root with an `assets:` list and lay files out however you like; `root:`/`files:`
-point at each asset. See [authoring-skaile-manifests].
+**A. Explicit (recommended for curated repos).** Put `skaile.manifest.yaml` at
+the repo root with an `assets:` list and lay files out however you like;
+`root:`/`files:` point at each asset. See [authoring-skaile-manifests].
 
-**B. Convention (zero-config).** Omit `skaile.yaml`; the walker falls back to the
+**B. Convention (zero-config).** Omit `skaile.manifest.yaml`; the walker falls back to the
 agentskills.io layout:
 
 ```
@@ -72,7 +72,7 @@ agentskills.io layout:
   mcp-servers/excel/MCP.md
 ```
 
-> ⚠️ If `skaile.yaml` has a **non-empty `assets:` list, it is exhaustive** — only
+> ⚠️ If `skaile.manifest.yaml` has a **non-empty `assets:` list, it is exhaustive** — only
 > listed assets are resolvable. Files on disk that you forgot to list still show
 > up in `skaile manage` (the browse scan walks the filesystem) but **fail at
 > install** with `Asset not found`. Keep the list complete, or omit it and rely
@@ -86,10 +86,10 @@ extensions nested under `metadata:` (both locations are read for `version` and
 
 ```markdown
 ---
-name: audit                       # MUST equal the assets[].name in skaile.yaml
+name: audit                       # MUST equal the assets[].name in skaile.manifest.yaml
 description: "Use when ..."        # one line; this is what the model matches on
 metadata:
-  version: '1.4.0'                 # source skaile.yaml is authoritative; this is a hint only
+  version: '1.4.0'                 # source skaile.manifest.yaml is authoritative; this is a hint only
   stage: stable
   tags: [review, quality, ci]
   requires:                        # peer assets this one needs — kind:name form
@@ -102,9 +102,9 @@ metadata:
 ```
 
 Rules that bite:
-- **`name:` MUST equal the `assets[].name`** in `skaile.yaml`. Mismatch is an
+- **`name:` MUST equal the `assets[].name`** in `skaile.manifest.yaml`. Mismatch is an
   index-time hard error.
-- `metadata.version` is **ignored for resolution** — the source `skaile.yaml`
+- `metadata.version` is **ignored for resolution** — the source `skaile.manifest.yaml`
   version (or git-tag waterfall) is authoritative. Keep it as documentation only.
 - `description:` is the model-facing trigger. Write it as "Use when …"; it
   decides whether the skill gets surfaced.
@@ -141,8 +141,10 @@ dependencies:
 1. Pick the kind + name; create the manifest file (`SKILL.md`, `agent.yaml`, …).
 2. Write a sharp `description:` ("Use when …").
 3. Declare same-source peers in `requires:` (`kind:name`).
-4. If publishing as a curated source: add the asset to `skaile.yaml` `assets:`
-   and confirm `name:` matches. Run [authoring-skaile-manifests] to author/verify.
+4. If publishing as a curated source: add the asset to `skaile.manifest.yaml`
+   `assets:` (`skaile library create` does this; after hand edits run
+   `skaile library index <library>`) and confirm `name:` matches. Run
+   [authoring-skaile-manifests] to author/verify.
 5. Test locally before pushing (below).
 6. Commit; tag a SemVer release (`vX.Y.Z`) so the version waterfall resolves.
 
@@ -169,7 +171,7 @@ above.
 |---|---|---|
 | `Asset not found` on an asset visible in `manage` | omitted from `assets:` | add it, or drop `assets:` and use convention |
 | `name mismatch` at index time | `SKILL.md` `name:` ≠ `assets[].name` | make them equal |
-| `publisher must be declared` | non-GitHub source URL, no `publisher:` | set `publisher:` in `skaile.yaml` |
+| `publisher must be declared` | non-GitHub source URL, no `publisher:` | set `publisher:` in `skaile.manifest.yaml` |
 | `publisher required in asset ref` | a dep uses legacy `kind:name@pub` | migrate to `kind:@pub/name` (see [authoring-skaile-manifests]) |
 | dep silently absent at runtime | `requires:` used a full canonical ref | `requires:` is `kind:name` only; full refs go in bundle/project `dependencies:` |
 

package/dist/factory-assets/skills/authoring-skaile-manifests/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: authoring-skaile-manifests
-description: "Use when creating or fixing a skaile.yaml manifest for a new or existing skill / asset / MCP-server repo so it works with @skaile/workspaces and stores. Covers the publication half (publisher, version, assets[]), the consumption half (sources, stores, dependencies, overrides), the canonical dependency-ref grammar (kind:@publisher/name#version), the version waterfall, conflict resolution, and the v3 lock file. Also use to generate a manifest from an existing tree or migrate a legacy manifest."
+description: "Use when creating or fixing the skaile.manifest.yaml (publication) or skaile.yaml (consumption) manifest for a new or existing skill / asset / MCP-server repo so it works with @skaile/workspaces and stores. Covers the publication half (publisher, version, assets[] in skaile.manifest.yaml), the consumption half (sources, stores, dependencies, overrides in skaile.yaml), the canonical dependency-ref grammar (kind:@publisher/name#version), the version waterfall, conflict resolution, and the v3 lock file. Also use to generate a manifest from an existing tree or migrate a legacy manifest."
 metadata:
-  version: '0.1.0'
+  version: '0.1.1'
   stage: alpha
   tags:
     - skaile
@@ -15,24 +15,25 @@ metadata:
     - lockfile
 ---
 
-# Authoring `skaile.yaml` manifests
+# Authoring `skaile.manifest.yaml` and `skaile.yaml` manifests
 
-You are creating or repairing a `skaile.yaml` so a repo (skills, assets, or an
-MCP server) resolves through `@skaile/workspaces` and any store. This skill owns
-the manifest and the **latest dependency standard**. For file layout and asset
-content, see **[authoring-skaile-assets]**.
+You are creating or repairing the manifest(s) of a repo (skills, assets, or an
+MCP server) so it resolves through `@skaile/workspaces` and any store. This
+skill owns the manifests and the **latest dependency standard**. For file layout
+and asset content, see **[authoring-skaile-assets]**.
 
 Reference (canonical): the in-repo concept doc `docs/concepts/manifest-schema.md`
 and the spec `_devlog/specs/2026-05-31-manifest-canonical-identity.md`.
 The full dependency standard is in
 [`references/dependency-standard.md`](./references/dependency-standard.md).
 
-## One file, two halves
+## Two files, two halves
 
-`skaile.yaml` lives at the repo root. A repo can be **source-only** (publication
-half), **project-only** (consumption half), or both.
+Publication and consumption live in **separate files** at the repo root. A repo
+can be **source-only** (`skaile.manifest.yaml`), **project-only** (`skaile.yaml`),
+or both. `publisher:`, `version:` and `assets:` are rejected in `skaile.yaml`.
 
-### Publication half — "this repo IS a source"
+### Publication half — "this repo IS a source" (`skaile.manifest.yaml`)
 
 ```yaml
 publisher: skaile-ai            # optional; defaults to the source URL's GitHub org/user
@@ -73,7 +74,7 @@ assets:                         # optional; when present it EXHAUSTIVELY lists p
 > `Asset not found`. When you add an agent/flow/skill to the tree, add it here
 > too — or omit `assets:` entirely and let the convention walker find everything.
 
-### Consumption half — "this repo IS a project"
+### Consumption half — "this repo IS a project" (`skaile.yaml`)
 
 ```yaml
 sources:                        # absent → no direct git resolution
@@ -149,7 +150,7 @@ complete rules, SHA-synthetic versions, and worked examples.
 
 The version for an asset is the first of:
 
-1. `assets[].version` (per-asset in the source `skaile.yaml`).
+1. `assets[].version` (per-asset in the source `skaile.manifest.yaml`).
 2. The source's top-level `version:`.
 3. A SemVer-shaped git tag (`git describe --tags`), `v` stripped.
 4. Synthetic `0.0.0-sha.<7char>` from the resolved commit.
@@ -173,7 +174,7 @@ mean identical content everywhere, or every downstream consumer breaks.
 
 ## Generate a manifest from an existing repo
 
-For a new or existing skill/asset/MCP repo with no (or a stale) `skaile.yaml`:
+For a new or existing skill/asset/MCP repo with no (or a stale) `skaile.manifest.yaml`:
 
 1. **Enumerate assets on disk** — find every manifest file:
    ```bash
@@ -223,11 +224,13 @@ regenerate with `rm skaile.lock.yaml && skaile install`.
 
 ## Migration
 
-There is no `skaile manifest migrate` command. The transform
+There is no CLI command for manifest migration. The transform
 (`repositories:`/`ai_resources:` → `sources:`/`dependencies:`, bare deps →
 `@<publisher>`, `@skaile` → `@skaile-ai` rebrand, legacy `kind:name@pub` →
-`kind:@pub/name`) is done by the **`migrate-skaile-manifest`** skill. Run it from
-an AI session against each legacy `skaile.yaml`.
+`kind:@pub/name`, and the publication keys `publisher:`/`version:`/`assets:`
+moving from `skaile.yaml` to `skaile.manifest.yaml`) is done by the
+**`migrate-skaile-manifest`** skill. Run it from an AI session against each
+legacy `skaile.yaml`.
 
 ## Manifest checklist