@se-studio/skills 1.7.6 → 1.7.8

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @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
+
+- Add `createSitemapXmlRouteHandler` so marketing sites serve `/sitemap.xml` as a force-dynamic Route Handler with CDN no-store (the se-website production pattern). Listing fetches stay tagged `sitemap` with no hourly `revalidate`.
+
 ## 1.7.6
 
 ### 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.6",
+  "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/se-marketing-sites-redirects/SKILL.md

@@ -188,17 +188,22 @@ The shared libraries now support this easily:
 - The `getSitemapEntries(...)` function returned by the marketing sitemap helper (when you configure `marketingSiteSitemap` in `createAppHelpers`) accepts an optional `redirectMap` in its options. When supplied, any entry whose URL is a redirect source is filtered out before the entries are returned to `buildSitemap`.
 - Standalone: `filterSitemapEntriesExcludingRedirects(entries, redirectMap)` (exported from `@se-studio/contentful-rest-api`) works on any `{ url: string }[]` list for custom flows.
 
-Recommended pattern (in `app/sitemap.ts` and the unindexed route):
+Recommended pattern (in `app/sitemap.xml/route.ts` and the unindexed route — not metadata `sitemap.ts`):
 
 ```ts
-import { getRedirectMap, getSitemapEntries } from '@/lib/cms-server';
-import { buildSitemap } from '@se-studio/core-ui';
+import { createSitemapXmlRouteHandler } from '@se-studio/core-ui';
+import { redirects } from '@/generated/redirects';
+import { getSitemapEntries } from '@/lib/cms-server';
+import { baseUrl } from '@/lib/server-config';
 
-export default async function sitemap() {
-  const redirectMap = await getRedirectMap({});
-  const entries = await getSitemapEntries({ includeUnindexed: false, redirectMap });
-  return buildSitemap([() => Promise.resolve(entries)], { baseUrl, ... });
-}
+export const dynamic = 'force-dynamic';
+export const revalidate = 0;
+
+export const GET = createSitemapXmlRouteHandler({
+  getEntries: () => getSitemapEntries({ includeUnindexed: false, redirectMap: redirects }),
+  baseUrl,
+  trailingSlash: true,
+});
 ```
 
 Pure `fromPath` vanity redirects were already absent from sitemaps (no backing content entry). This mainly helps when you redirect *away from* live CMS pages/articles.

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`).
 
 ---