docs(skills): correct the install boundary policy and drop the false naming rule

Author: apresmoi

packages/skills/README.md

@@ -82,9 +82,12 @@ as plain relative paths, and a symlink anywhere *inside* the destination — a
 managed file or one of its parent directories — is refused rather than written
 through, so nothing outside can be created or deleted.
 
-The destination root itself is followed if it is a symlink, because a shared
-skills directory is a reasonable layout. If you do not want that, pass an
-explicit `--dir`.
+An auto-detected destination is confined to your project: if `.claude/skills`
+(or any parent) is a symlink pointing outside it, the install is refused rather
+than followed, so a repository cannot redirect it somewhere else.
+
+Installing outside the project is opt-in — pass `--dir <path>` or `--global`
+and that boundary is lifted, because you named the destination yourself.
 
 ## Fetching instead of installing
 

packages/skills/skill/SKILL.md

@@ -98,8 +98,15 @@ import {
   `createPolyPerspectiveCamera` for depth foreshortening.
 - The camera is the **outer** node; the scene nests inside it. CSS `perspective`
   only applies to descendants.
-- Every public export is `Poly`-prefixed, except generic math types (`Vec2`,
-  `Vec3`, `Polygon`, `PolyMaterial`) and the `*/three` subpaths.
+- **Do not infer names from a prefix rule.** `Poly` prefixing is a convention
+  for newer renderer-facing components, hooks and types — not a description of
+  the export inventory. Plenty of public names have no prefix: `loadMesh`,
+  `parseObj` / `parseStl` / `parseGltf` / `parseVox`, every `*Polygons`
+  generator, `BASE_TILE`, `LoopOnce` / `LoopRepeat` / `LoopPingPong`, the
+  generic math types (`Vec2`, `Vec3`, `Polygon`), and the vanilla factories
+  `createSelect` and `createTransformControls`. The `*/three` subpaths use
+  Three-compatible names deliberately. Check
+  [docs/api-index.md](docs/api-index.md) rather than guessing.
 
 ## Authoring polygons — the five silent failures
 

website/public/skill.md

@@ -98,8 +98,15 @@ import {
   `createPolyPerspectiveCamera` for depth foreshortening.
 - The camera is the **outer** node; the scene nests inside it. CSS `perspective`
   only applies to descendants.
-- Every public export is `Poly`-prefixed, except generic math types (`Vec2`,
-  `Vec3`, `Polygon`, `PolyMaterial`) and the `*/three` subpaths.
+- **Do not infer names from a prefix rule.** `Poly` prefixing is a convention
+  for newer renderer-facing components, hooks and types — not a description of
+  the export inventory. Plenty of public names have no prefix: `loadMesh`,
+  `parseObj` / `parseStl` / `parseGltf` / `parseVox`, every `*Polygons`
+  generator, `BASE_TILE`, `LoopOnce` / `LoopRepeat` / `LoopPingPong`, the
+  generic math types (`Vec2`, `Vec3`, `Polygon`), and the vanilla factories
+  `createSelect` and `createTransformControls`. The `*/three` subpaths use
+  Three-compatible names deliberately. Check
+  [docs/api-index.md](/skill/docs/api-index.md) rather than guessing.
 
 ## Authoring polygons — the five silent failures
 

website/public/skill/SKILL.md

@@ -98,8 +98,15 @@ import {
   `createPolyPerspectiveCamera` for depth foreshortening.
 - The camera is the **outer** node; the scene nests inside it. CSS `perspective`
   only applies to descendants.
-- Every public export is `Poly`-prefixed, except generic math types (`Vec2`,
-  `Vec3`, `Polygon`, `PolyMaterial`) and the `*/three` subpaths.
+- **Do not infer names from a prefix rule.** `Poly` prefixing is a convention
+  for newer renderer-facing components, hooks and types — not a description of
+  the export inventory. Plenty of public names have no prefix: `loadMesh`,
+  `parseObj` / `parseStl` / `parseGltf` / `parseVox`, every `*Polygons`
+  generator, `BASE_TILE`, `LoopOnce` / `LoopRepeat` / `LoopPingPong`, the
+  generic math types (`Vec2`, `Vec3`, `Polygon`), and the vanilla factories
+  `createSelect` and `createTransformControls`. The `*/three` subpaths use
+  Three-compatible names deliberately. Check
+  [docs/api-index.md](docs/api-index.md) rather than guessing.
 
 ## Authoring polygons — the five silent failures