@se-studio/skills 1.7.7 → 1.7.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/skills
 
+## 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.8",
   "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/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/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`).
 
 ---