Release 0.2.0: native skills for every agent, Studio, Kickstart, Live Preview protocol

.agents/plugins/marketplace.json

@@ -0,0 +1,10 @@
+{
+  "name": "contentstack-skills",
+  "plugins": [
+    {
+      "name": "contentstack-skills",
+      "source": { "source": "local", "path": "./" },
+      "policy": { "installation": "AVAILABLE" }
+    }
+  ]
+}

.claude-plugin/marketplace.json

@@ -1,15 +1,16 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "contentstack-skills",
-  "description": "Contentstack agent skills for Claude Code, Cursor, Codex, and Gemini.",
-  "owner": {
-    "name": "Contentstack"
-  },
+  "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
+  "owner": { "name": "Contentstack", "url": "https://www.contentstack.com" },
   "plugins": [
     {
       "name": "contentstack-skills",
-      "source": ".",
-      "description": "Contentstack agent skills for Claude Code, Cursor, Codex, and Gemini."
+      "source": "./",
+      "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
+      "version": "0.2.0",
+      "category": "development",
+      "tags": ["contentstack", "cms", "headless-cms", "studio"]
     }
   ]
 }

.claude-plugin/plugin.json

@@ -1,8 +1,10 @@
 {
   "name": "contentstack-skills",
-  "version": "0.1.0",
-  "description": "Contentstack agent skills for Claude Code, Cursor, Codex, and Gemini.",
-  "author": {
-    "name": "Contentstack"
-  }
+  "version": "0.2.0",
+  "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
+  "author": { "name": "Contentstack", "url": "https://www.contentstack.com" },
+  "homepage": "https://developers.contentstack.com",
+  "repository": "https://github.com/contentstack/contentstack-agent-skills",
+  "license": "MIT",
+  "keywords": ["contentstack", "cms", "headless-cms", "delivery-sdk", "live-preview", "studio", "launch"]
 }

.cursor-plugin/marketplace.json

@@ -0,0 +1,11 @@
+{
+  "name": "contentstack-skills",
+  "owner": { "name": "Contentstack", "url": "https://www.contentstack.com" },
+  "plugins": [
+    {
+      "name": "contentstack-skills",
+      "source": "./",
+      "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations."
+    }
+  ]
+}

.cursor-plugin/plugin.json

@@ -1,6 +1,7 @@
 {
   "name": "contentstack-skills",
-  "version": "0.1.0",
-  "description": "Contentstack agent skills for Claude Code, Cursor, Codex, and Gemini.",
-  "rules": "cursor/rules"
+  "version": "0.2.0",
+  "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
+  "author": { "name": "Contentstack", "url": "https://www.contentstack.com" },
+  "skills": "./skills/"
 }

.gitattributes

@@ -0,0 +1,2 @@
+* text=auto eol=lf
+*.sh text eol=lf

.github/CODEOWNERS

@@ -2,4 +2,5 @@
 .github/workflows/ @contentstack/security-admin
 **/.snyk @contentstack/security-admin
 **/CODEOWNERS @contentstack/security-admin
-**/.gitguardian.yaml @contentstack/security-admin
+**/.gitguardian.yaml @contentstack/security-admin
+scripts/ @contentstack/security-admin

.github/workflows/validate.yml

@@ -0,0 +1,21 @@
+name: Validate skills
+
+on:
+  push:
+    branches: [main, next]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Validate skills and manifests
+        run: node scripts/validate.mjs

.gitignore

@@ -1 +1,2 @@
 .DS_Store
+.obsidian

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to the Contentstack agent skills bundle. Versions match the `version` field in every plugin manifest that declares one.
+
+## 0.2.0
+
+### Install anywhere, from one source
+
+- Every skill now lives once in `skills/<slug>/SKILL.md` ([Agent Skills](https://agentskills.io) format), and every supported tool reads that folder directly.
+- New and updated plugin manifests: Claude Code, claude.ai and Cowork (`.claude-plugin/`), Codex (`plugin.json`, `.agents/plugins/marketplace.json`), Cursor (`.cursor-plugin/`), GitHub Copilot (reads `.claude-plugin/` and `plugin.json`) and Gemini CLI (`gemini-extension.json`).
+- The marketplace plugin source is now `"./"`, so the repo syncs on claude.ai and Cowork.
+- The README has real install commands for every tool, and a new `docs/` site covers install, architecture, contributing and every skill.
+
+### New skills
+
+- `dx-kickstart-next`: building, reviewing and debugging Contentstack's Next.js kickstart.
+- `studio`: Contentstack Studio end to end, routed to bundled specialist guides. `studio` ships as a preview; some guides are still being reconciled with the Studio team.
+
+### Changed skills
+
+- **Live Preview support is rebuilt** as a seven-step diagnostic protocol covering Live Preview, Visual Editor and Timeline, with twelve reference files.
+- **`migration-companion` is leaner.** Its `SKILL.md` went from 959 to about 340 lines; per-step detail now lives in `references/step-*.md` and loads only when that step runs.
+- **Security review:** token handling, TLS, frame headers and confirmation steps tightened across skills. `migration-companion` resolves its Contentful token without printing it, logs to the session directory by default, and discloses that its prerequisite check may install or upgrade global CLIs.
+- **Better automatic triggering.** Every skill's `description` now says when to use it, so agents can pick the right skill without a separate router file.
+
+### Breaking changes
+
+- **Removed `cursor/rules/` and `codex/`.** If you copied those folders by hand, remove them and install with the Cursor or Codex instructions in the README.
+- **Renamed** `cms-live-preview-visual-builder-support-assistant` → `cms-live-preview-visual-editor-support-assistant`.
+- **Skill names now match their folders:** `contentstack-migration-companion` → `migration-companion`.
+- **Removed `skills/CLAUDE.md`** (the router) and `manifest.json`.
+
+### Contributors
+
+- **Validation in CI:** `node scripts/validate.mjs` checks that each skill's `name` matches its folder and follows the naming rules; that its `description` exists, is at most 1024 characters and includes "Use when"; that `SKILL.md` has a `## Security` section with `### Defaults`, `### Destructive Actions`, `### Secrets` and `### Environment Variables`; that relative links in every Markdown file under `skills/` resolve and stay inside the skill folder; that frontmatter values containing `: ` in `skills/` and `docs/` are quoted; and that the manifests parse and every versioned manifest carries the same `version`. It replaces the build-and-commit workflow and runs on pull requests to any branch, pushes to `main` and `next`, and manual dispatch.
+- **Releases:** bump `version` in every manifest and add an entry here.
+
+## 0.1.0
+
+Initial bundle of 21 skills.

CLAUDE.md

@@ -1,16 +1,22 @@
 # Contentstack Skills
 
-This repository bundles a collection of [Contentstack](https://www.contentstack.com) agent skills for use with Claude Code, Cursor, Codex, Gemini, and the `skills` CLI.
+This repository bundles [Contentstack](https://www.contentstack.com) agent skills. Every skill lives once in `skills/<slug>/SKILL.md` (the [Agent Skills](https://agentskills.io) format) and is distributed to Claude Code, claude.ai, Cursor, Codex, GitHub Copilot, Gemini CLI and the `skills` CLI through the manifests at the repo root. There are no generated copies.
 
-## Routing
+## Editing skills
 
-The router lives at [skills/CLAUDE.md](skills/CLAUDE.md). Follow it to pick the right skill for a given user request.
+- `name` must equal the folder name (lowercase, hyphens, max 64 chars).
+- `description` says what the skill does and includes "Use when …" triggers, max 1024 chars. This is the only text agents see before loading a skill, so put routing cues here.
+- Keep `SKILL.md` focused; move long material into `references/` and link it with a relative path.
+- When adding a skill, add its row to the table in `README.md`, and add a `docs/skills/<slug>.md` page linked from `docs/skills/index.md`.
+- Run `node scripts/validate.mjs` before committing. CI runs it on every PR.
 
-Each skill's canonical definition is at `skills/<slug>/SKILL.md`. The `cursor/rules/` and `codex/` trees are generated artifacts — do not edit them by hand.
+## Releasing
+
+Bump `version` to the same value in `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.cursor-plugin/plugin.json`, `plugin.json` and `gemini-extension.json`. Installed Claude Code plugins only update when the version changes. Add a section to `CHANGELOG.md` for the release.
 
 ## Contentstack references
 
-When a skill needs up-to-date product or API details beyond what's in `skills/<slug>/SKILL.md`, consult:
+When a skill needs up-to-date product or API details, consult:
 
 - [developers.contentstack.com](https://developers.contentstack.com) — SDKs, CLIs, API references
 - [contentstack.com/docs](https://www.contentstack.com/docs) — product documentation