Add migration companion skill

README.md

@@ -1,6 +1,6 @@
 # Contentstack Skills
 
-A bundle of 20 ready-to-use [Contentstack](https://www.contentstack.com) agent skills for AI coding tools, covering CMS implementation, Brand Kit guidance, delivery SDK development, Developer Hub app architecture, and Launch automation.
+A bundle of 21 ready-to-use [Contentstack](https://www.contentstack.com) agent skills for AI coding tools, covering CMS implementation, Brand Kit guidance, delivery SDK development, migration workflows, Developer Hub app architecture, and Launch automation.
 
 ## What's in here?
 
@@ -71,6 +71,7 @@ npx skills add <this-repo>@<skill-slug>
 | `dx-migrate-js-to-ts-sdk` | Migrate JS to TS SDK | Developer Experience | Migration from the JavaScript Contentstack SDK to the TypeScript Delivery SDK, including API mapping, rewrites, and unsupported pattern callouts. |
 | `launch-sync-environment-variables-from-env-example` | Sync Launch environment variables from .env.example | Launch | Comparing a local `.env.example` with Launch environment variables and patching missing keys without printing secrets. |
 | `launch-trigger-and-monitor-launch-deployments` | Trigger and Monitor Launch Deployments | Launch | Triggering Launch deployments, polling deployment status, retrieving failure logs, and summarizing likely causes and next steps. |
+| `migration-companion` | Contentstack Migration Companion | Developer Experience | Guided Contentful-to-Contentstack migration workflow covering prerequisites, content migration, code migration, bundled validation scripts, and completion reporting. |
 
 ## How it works
 

codex/AGENTS.md

@@ -5,6 +5,7 @@ Use the table below to route a user request to the right skill. Each row maps a
 | When the user asks… | Skill |
 |----------------------|-------|
 | Use when users ask about Contentstack Brand Kit, Voice Profiles, Knowledge Vault, brand voice, tone, style rules, on-brand AI generation, setup, governance, or API usage. Use this skill as the primary entry point, but refuse unsafe assumptions, secret handling, or destructive requests without confirmation. | [Brand Kit Assistant](./brand-kit-assistant/SKILL.md) |
+| Use when users want to migrate, move, switch, port, or re-platform from Contentful to Contentstack, including content models, content, assets, locales, application integrations, website code, migration prerequisites, migration progress checks, or post-migration validation. | [contentstack-migration-companion](./migration-companion/SKILL.md) |
 | Use when a user wants to migrate Contentstack Delivery SDK code from JavaScript to TypeScript. | [dx-migrate-js-to-ts-sdk](./dx-migrate-js-to-ts-sdk/SKILL.md) |
 | Use when a user asks for Contentstack Delivery SDK code, query examples, helper functions, SDK setup, stack initialization, reference inclusion, filtering, sorting, pagination, typed entry fetching, asset fetching, Live Preview setup, Visual Builder support, SSR preview handling, or debugging SDK query chains. | [dx-delivery-sdk](./dx-delivery-sdk/SKILL.md) |
 | Use when designing, reviewing, or refactoring Contentstack content models before creating or changing schemas. | [Contentstack Data Modeling Best Practices](./cms-data-modeling-best-practices/SKILL.md) |

codex/brand-kit-assistant/references/brand-kit-management-api-reference.md

@@ -0,0 +1,31 @@
+Operate Contentstack Brand Kit and Voice Profile APIs with correct headers, payloads, and safety checks. Use for list/get/create/update/delete operations, region-aware base URL selection, payload validation, and rate-limit handling.
+
+## Safety
+- Never expose Brand Kit API tokens or other secrets.
+- Never delete Brand Kits.
+- Require explicit user confirmation before deleting a Voice Profile.
+- Validate generated or updated content against brand guidelines before presenting it as ready.
+- Stop and ask for missing required IDs, headers, or region details.
+- Treat 429 responses as rate-limit events and avoid aggressive retries.
+
+## Inputs
+- Operation type: list, get, create, update, delete
+- Target resource: Brand Kit or Voice Profile
+- Region / base URL
+- organization_uid and authtoken
+- brand_kit_uid for Voice Profile operations
+- brand_kit_uid or voice_profile_uid for targeted get/update/delete operations
+- Name, description, linked stack API keys, communication_style, insights, and sample content as needed
+
+## Behavior
+- Select the correct regional base URL.
+- Include authtoken and organization_uid for Brand Kit endpoints.
+- Include authtoken and brand_kit_uid for Voice Profile endpoints.
+- Validate required IDs and payload fields before calling the API.
+- For create/update, support brand_kit.name, optional brand_kit.description, and optional brand_kit.api_keys.
+- For Voice Profiles, validate communication_style values are integers from 1 to 5 and include insights and sample_content when available.
+- If deleting a Voice Profile, ask for explicit confirmation before proceeding.
+- If the API returns 429, report rate-limit status and recommend retrying after a short delay.
+
+## Output
+Return concise, action-oriented results with the exact endpoint, headers, and JSON body when requested. Summarize validation issues, returned IDs, and changed fields clearly. Do not include secrets.

codex/brand-kit-assistant/references/knowledge-vault-api-reference-skill.md

@@ -0,0 +1,29 @@
+Operate Contentstack Knowledge Vault through the API and mapped MCP tools with region-aware endpoints, required headers, payload validation, and safe write/delete handling. Support ingest, list, get, update, delete, and chunk retrieval while staying within Knowledge Vault capabilities.
+
+## Safety
+- Never expose Brand Kit API tokens or other secrets.
+- Require explicit user confirmation before deleting Knowledge Vault content.
+- Treat Knowledge Vault as a vector store for extracted knowledge, not a document repository.
+- Do not imply original-file retrieval or binary asset access.
+- Stop and ask for missing required IDs, headers, region details, or content fields.
+- Treat 429 responses as rate-limit events and avoid aggressive retries.
+
+## Inputs
+- Operation type: ingest/add, list, get, update, delete, get chunks, or MCP-mapped equivalent
+- Region / base URL
+- brand_kit_uid
+- content_uid for get, update, or delete
+- Content text to ingest or update
+- Optional metadata such as title, category, date, or external ID
+
+## Behavior
+- Select the correct regional base URL.
+- Include authtoken and brand_kit_uid headers.
+- Validate required IDs and payload fields before calling the API.
+- Accept text intended for semantic storage and include useful metadata when available.
+- For delete, request explicit confirmation and verify brand_kit_uid and content_uid before proceeding.
+- If the API returns 429, report rate-limit status and recommend retrying after a short delay.
+- Support mapped MCP operations where available.
+
+## Output
+Return concise, action-oriented results with the exact endpoint, headers, and JSON body when requested. Summarize validation issues, returned IDs, and changed fields clearly. Do not include secrets.