@se-studio/skills 1.7.7 → 1.7.9

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/skills
 
+## 1.7.9
+
+### Patch Changes
+
+- Stop applying 2px video overscan by default (`edgeOverscan` opt-in). Remove ImageKit/HLS. CMS local files are mute-loop packs only (click-to-play is YouTube/Vimeo). Raise mute-loop max duration to 2 minutes. Drop `videoPrefix`.
+
+## 1.7.8
+
+### Patch Changes
+
+- 62d1960: Document and ship the post-sync strip of AGENTS.md / CLAUDE.md inside skill directories so Cursor does not always-apply Vercel encyclopedias.
+
 ## 1.7.7
 
 ### Patch Changes

package/README.md

@@ -65,7 +65,7 @@ Claude Code uses a naive frontmatter parser; violations cause descriptions to si
 
 1. Edit `packages/skills/skills/<skill-dir>/SKILL.md`
 2. Validate: `pnpm skills:validate`
-3. Sync: `pnpm skills:sync` (copies `skills/` → `.agents/skills/` and `references/` → `.agents/references/`)
+3. Sync: `pnpm skills:sync` (copies `skills/` → `.agents/skills/` and `references/` → `.agents/references/`, then strips `AGENTS.md` next to `SKILL.md`)
 4. Add a changeset if publishing `@se-studio/skills`
 
 ### cms-edit bundled skills (`@se-studio/contentful-cms`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/skills",
-  "version": "1.7.7",
+  "version": "1.7.9",
   "description": "SE Studio agent skills for marketing site development with Contentful CMS",
   "repository": {
     "type": "git",

package/references/agent-session/customer-agents-block.md

@@ -2,6 +2,8 @@
 
 This site runs **Next.js 16.3**. Before writing Next.js code, read the relevant guide in `node_modules/next/dist/docs/` (in monorepos, resolve from the app that depends on `next`). Keep the managed `<!-- BEGIN:nextjs-agent-rules -->` block in `AGENTS.md`. Do **not** use `npx @next/codemod agents-md`, `.next-docs`, or `NEXT-AGENTS-MD-START` (Next 15 index: Pages Router, `middleware.ts`). Ignore `vercel-react-native-skills` if the vercel-labs pack installed it.
 
+After `pnpm skills:sync`, strip `AGENTS.md` / `CLAUDE.md` that sit next to a skill `SKILL.md`. Cursor always-applies those filenames; Vercel packs must stay on-demand.
+
 ## Agent session workflow
 
 **Load skill `site-workflows-agent-session` at the start of every coding session.**

package/references/agent-session/production-merge.md

@@ -12,7 +12,7 @@ Canonical skill: `site-workflows-agent-session`. Customer `AGENTS.md` copies the
 
 | Repo | Integration | Production (Git-connected Vercel) |
 |------|-------------|-----------------------------------|
-| Customer marketing sites | `develop` (or registry override, e.g. Highlander `port-2026`) | usually `main` |
+| Customer marketing sites | `develop` | usually `main` |
 | HopSkipDrive | `develop` | **`production`** |
 
 Never ship from a registry `productionPath` checkout. Merge with `gh` from the **develop** checkout.

package/references/agent-session/projects.registry.json

@@ -107,12 +107,13 @@
       "displayName": "Highlander Health",
       "path": "~/source/customers/highlander/highlander-health-website-2026",
       "worktreesRoot": "~/source/customers/highlander/worktrees",
-      "branch": "port-2026",
+      "branch": "develop",
+      "productionBranch": "main",
       "type": "customer",
       "contentfulSpaceId": "bkkox68g99rn",
       "hostedMcp": "cms-edit-highlander",
       "validate": "pnpm check && pnpm type-check && pnpm validate:routes",
-      "notes": "New 2026 stack. Integration branch is port-2026 until go-live, then develop/main. Live Bond/Netlify site remains highlander-health-website. cms-edit DNS/OAuth for highlander.content.se.studio is a human gate."
+      "notes": "2026 stack is live on Vercel (develop preview, main production alias). Public DNS is still Bond/Netlify highlanderhealth.com until cutover. cms-edit DNS/OAuth for highlander.content.se.studio is a human gate."
     }
   ]
 }

package/references/agent-session/strip-skill-always-on.sh

@@ -0,0 +1,32 @@
+# Source from scripts/sync-skills.sh after installing skills.
+# Cursor always-applies every AGENTS.md in the workspace. Skill packs must keep
+# SKILL.md (and rules/) only — never an AGENTS.md / CLAUDE.md next to SKILL.md.
+
+strip_skill_always_on_docs() {
+  node "${STRIP_SKILL_ALWAYS_ON_JS:-}" 2>/dev/null || python3 - <<'PY'
+from pathlib import Path
+
+cwd = Path('.')
+roots = [cwd / '.agents' / 'skills', cwd / '.cursor' / 'skills', cwd / '.claude' / 'skills']
+apps = cwd / 'apps'
+if apps.is_dir():
+    for app in apps.iterdir():
+        if app.is_dir():
+            roots.append(app / '.cursor' / 'skills')
+            roots.append(app / '.agents' / 'skills')
+
+removed = 0
+for root in roots:
+    if not root.is_dir():
+        continue
+    for skill_md in root.rglob('SKILL.md'):
+        skill_dir = skill_md.parent
+        for name in ('AGENTS.md', 'CLAUDE.md'):
+            path = skill_dir / name
+            if path.is_file():
+                path.unlink()
+                print(f'Removed always-on {path}')
+                removed += 1
+print(f'Stripped {removed} always-on skill doc(s).')
+PY
+}

package/references/deps-update/projects.registry.json

@@ -83,11 +83,12 @@
       "key": "highlander",
       "displayName": "Highlander Health",
       "path": "~/source/customers/highlander/highlander-health-website-2026",
-      "branch": "port-2026",
+      "branch": "develop",
+      "productionBranch": "main",
       "validate": "pnpm check && pnpm type-check && pnpm validate:routes",
       "workspace": true,
       "hasPinOverrides": false,
-      "notes": "2026 port. Integration branch port-2026 until live; then develop/main."
+      "notes": "2026 stack. Integration develop; Vercel production tracks main. Public DNS still Bond/Netlify until cutover."
     }
   ]
 }

package/skills/contentful-cms-core/SKILL.md

@@ -13,14 +13,13 @@ Use this skill when you need to read or edit content in Contentful using **hoste
 
 ## Overview
 
-`cms-edit` lets you read and edit Contentful draft content without publishing. It uses a **snapshot → ref → edit → save** workflow:
+`cms-edit` lets you read and edit Contentful draft content without publishing.
 
-1. `open` a page to load the content tree into a session
-2. `snapshot` to see the tree with `@ref` labels
-3. `read` an entry to inspect its fields
-4. `set` / `rtf` to modify fields
-5. `diff` to review changes
-6. `save` to write drafts to Contentful (NEVER publishes)
+**New page/article:** `schema` for this space → `create from-json --dry-run --strict` → `create from-json` (`--json` or `--json-base64`). Nested tree key is `components`; discriminator is `type`.
+
+**Edit a tree:** `open` → `export from-json` → edit JSON → `apply from-json`. Tiny patches: `set` / `rtf` / `add` then `diff` → `save`.
+
+**Never publish.** Hosted MCP cannot see your disk — send JSON in the tool call.
 
 ## Safety Rules
 
@@ -159,15 +158,10 @@ Markdown support:
 - `` `inline code` ``
 - `---` for horizontal rule
 
-For any content with multiple paragraphs or newlines, use `printf` piped to stdin — `\n` in a double-quoted shell string is **not** interpreted as a newline by bash:
+For multi-paragraph Markdown, pass `--content` or `--base64` on MCP (no stdin, no `--file`):
 
-```bash
-# Correct — printf interprets \n properly
-printf '## Why it matters\n\nOur platform helps teams **move faster**.\n\n- Instant setup\n- No code required\n' | cms-edit rtf @c1 body --markdown -
-
-# Also correct — file input
-cms-edit rtf @c1 body --markdown --content "# Heading\n\nBody."
-cms-edit rtf @c1 body --markdown - < path/to/file.md
+```
+cms_edit ["rtf", "@c1", "body", "--content", "## Why it matters\n\nOur platform helps teams **move faster**."]
 ```
 
 Single-line content (no newlines) can be passed as a quoted argument directly:
@@ -679,12 +673,11 @@ cms-edit peek --id <entryId>         # Look up by entry ID
 
 ## Batch Operations (batch run)
 
-Run a sequence of operations from a JSON file or stdin.
+Run a sequence of operations from `--json` or `--json-base64` (hosted MCP).
 
-```bash
-cms-edit batch run --json '[...]'            # Run batch ops from inline JSON
-echo '[...]' | cms-edit batch run             # Pipe from stdin
-cms-edit batch run --json '[...]' --dry-run  # Validate without saving
+```
+cms_edit ["batch", "run", "--json", "[...]"]
+cms_edit ["batch", "run", "--json-base64", "<b64>", "--dry-run"]
 ```
 
 Supported ops: `open`, `set`, `rtf`, `rtf-replace`, `save`, `add`, `links-add`.
@@ -715,13 +708,17 @@ Example `ops.json` — update an existing page with a new CTA that has two butto
 
 ## Create Page or Article from JSON
 
-Create a complete page or article — including all components, fields, and CTA links — from a single declarative JSON file. This is the recommended approach for creating multiple pages or articles in bulk.
+Create a complete page or article from `--json` or `--json-base64`. Dry-run is local (no CMA) once the index is warm.
 
-```bash
-cms-edit create from-json --json '{...}'            # Create from inline JSON
-cms-edit create from-json --json '{...}' --dry-run  # Preview without writing
-cat page.json | cms-edit create from-json             # Pipe from stdin
 ```
+cms_edit ["help", "create-from-json"]
+cms_edit ["create", "from-json", "--json", "{...}", "--dry-run", "--strict"]
+cms_edit ["create", "from-json", "--json-base64", "<b64>"]
+cms_edit ["export", "from-json"]
+cms_edit ["apply", "from-json", "--json-base64", "<b64>"]
+```
+
+Use `"components"` not `"content"`. Nested discriminator is `"type"` not `"componentType"`. Empty `components` fails. `schema <contentType>` for this space’s field ids.
 
 **Page JSON schema:**
 

package/skills/se-marketing-sites-handling-media/SKILL.md

@@ -165,7 +165,7 @@ Pass `componentLabel` (usually `cmsLabel`) and `analyticsContext` to enable clic
 The `IResponsiveVisual` type (from `@se-studio/core-data-types`) supports:
 
 1.  **Image**: Standard Contentful image asset.
-2.  **Video**: Hosted video file (mp4/webm). The component handles `<video>` tag rendering with autoplay/loop/muted attributes suitable for background videos.
+2.  **Video**: Mute autoplay-loop local files via the hero pipeline (`HERO_VIDEO_*`, R2 / `video.se.studio`). Click-to-play is YouTube or Vimeo — do not play Contentful MP4s. Cover/fill does not overscan unless you pass `edgeOverscan` (parent must clip; `HeroLoopVideo` does not self-clip). Mute-loops may be up to 2 minutes.
 3.  **Animation**: Lottie motion file. Player is chosen by **file extension**:
     *   **`.json`** (or `application/json`) → `@lottiefiles/lottie-player` (classic Lottie).
     *   **`.lottie`** → `@lottiefiles/dotlottie-react` (ThorVG / WASM). Wrong extension ⇒ wrong player.

package/skills/se-marketing-sites-lib-cms-structure/SKILL.md

@@ -14,7 +14,7 @@ Reference app: **example-empty** (this monorepo). Customer implementations: see
 | `cms.ts` | Yes | Types, buildComponentRecord / buildCollectionRecord / buildExternalRecord (array → Record), then build*Maps from those Records, createConverterContext |
 | `cms-server.ts` | No (server-only) | createAppHelpers, buildOptions, getContentfulConfig, projectRendererConfig |
 | `config.ts` | Yes | isProduction, isDevelopment |
-| `server-config.ts` | No | draftOnly, videoPrefix, baseUrl, revalidationSecret |
+| `server-config.ts` | No | draftOnly, baseUrl, revalidationSecret |
 | `constants.ts` | Yes | ARTICLES_BASE, TAGS_BASE, PEOPLE_BASE, enable flags, customer name |
 | `registrations.ts` | Yes | componentRegistrationsList, collectionRegistrationsList, externalComponentRegistrationsList (arrays) |
 | `SizingInformation.ts` | Yes | getSizingInformation for dynamic heading sizes |

package/skills/site-workflows-agent-session/SKILL.md

@@ -365,6 +365,6 @@ Agent must load this skill, write manifest (with `worktree` path), run placement
 | `pointme` | `develop` | `main` | customer |
 | `pedestal` | `develop` | `main` | customer monorepo |
 | `hsd` | `develop` (`develop-hsd-website`) | `production` (`production-hsd-website`) | customer |
-| `highlander` | `port-2026` until live, then `develop` | `main` after cutover | customer |
+| `highlander` | `develop` | `main` | customer |
 
 Full paths (`path`, `worktreesRoot`, `productionPath`), MCP keys: `projects.registry.json`.

package/skills/site-workflows-deps-update/SKILL.md

@@ -140,6 +140,7 @@ Marketing sites run **Next.js 16.3**. Version-matched docs live in each app’s
 - **Do not** run `npx @next/codemod agents-md` or restore `NEXT-AGENTS-MD-START` / `.next-docs` — that index is Next 15 (Pages Router, `middleware.ts`, upgrade guides only through v15).
 - Cursor’s Vercel plugin **`nextjs`** skill is fine for App Router patterns; it is not a substitute for `node_modules/next/dist/docs/`.
 - After `npx skills add vercel-labs/agent-skills`, **delete `vercel-react-native-skills`** — these are web sites. Do not treat React Native skills as Next guidance.
+- After any `skills add` / `skills:sync`, **delete `AGENTS.md` and `CLAUDE.md` that sit next to a `SKILL.md`**. Cursor always-applies those filenames. Keep `SKILL.md` and `rules/`. Core: `node scripts/strip-skill-always-on-docs.mjs`. Customer `scripts/sync-skills.sh` must call the same strip (see `packages/skills/references/agent-session/strip-skill-always-on.sh`).
 
 ---