Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"name": "contentstack-skills",
"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",
"version": "0.3.0",
"category": "development",
"tags": ["contentstack", "cms", "headless-cms", "studio"]
}
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "contentstack-skills",
"version": "0.2.0",
"version": "0.3.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",
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "contentstack-skills",
"version": "0.2.0",
"version": "0.3.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/"
Expand Down
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

All notable changes to the Contentstack agent skills bundle. Versions match the `version` field in every plugin manifest that declares one.

## 0.3.0

### New skills

- `asset-management`: advisory guidance for the standalone Assets (DAM) product: spaces and workspaces, folders, asset types and user-defined fields, localization, saved views, searching the Assets API, AI tags and alt text, duplicate management, versions, trash and restore, visual markups and CMS integration.

### Changed skills

- **`cms-assets` routing:** scoped to the stack asset library. Assets DAM questions, and any request to read or update user-defined fields, now route to `asset-management`, since the stack asset library doesn't support user-defined fields.
- **`cms-live-preview-visual-editor-support-assistant`:** ports the fixes that missed 0.2.0. Open in New Tab is scoped to Live Preview, since Visual Editor always renders in its iframe. Also: the missing navigation entry checks the stack's Live Preview setting first, the CORS entry drops an unverified allowlist claim, GraphQL preview keeps the delivery headers, `livePreviewQuery` key rules, the edit button `exclude` config needing `init()`, SDK caching separated from app and CDN caching, and `stackSdk` notes for the legacy SDK.

## 0.2.0

### Install anywhere, from one source
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,7 @@ Use `--list` to see every skill, or leave out `--skill` to install them all. The

| Slug | Title | Product | What it helps with |
| --- | --- | --- | --- |
| `asset-management` | Asset Management | Assets | Assets DAM spaces and workspaces, folders, asset types and metadata, localization, saved views, AI tagging and alt text, duplicate management, versions, trash and restore, visual markups, and CMS integration. |
| `brand-kit-assistant` | Brand Kit Assistant | Brand Kit | Brand Kit concepts, setup, governance, Voice Profiles, Knowledge Vault, on-brand AI generation, and API-task routing. |
| `cms-assets` | Contentstack Assets | CMS | Asset organization, image transformations, publishing lifecycle, CDN behavior, and asset limits. |
| `cms-branches-aliases` | Branches & Aliases | CMS | Isolated content development, alias-based deployments, CI/CD integration, merge behavior, and rollback patterns. |
Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,8 +50,8 @@ Every skill is written once in the open [Agent Skills](https://agentskills.io) f

| | |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Skills included** | 23 (see the [skill reference](skills/index.md)) |
| **Products covered** | CMS, Developer Experience, Studio, Launch, Brand Kit, Developer Hub |
| **Skills included** | 24 (see the [skill reference](skills/index.md)) |
| **Products covered** | CMS, Assets, Developer Experience, Studio, Launch, Brand Kit, Developer Hub |
| **Supported tools** | Claude Code, claude.ai / Cowork, Cursor, Codex, GitHub Copilot, Gemini CLI, `skills` CLI |
| **Source of truth** | `skills/<slug>/SKILL.md` |
| **Repository** | [github.com/contentstack/contentstack-agent-skills](https://github.com/contentstack/contentstack-agent-skills) |
Expand Down
3 changes: 2 additions & 1 deletion docs/how-it-works/router.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,8 @@ Each description's "Use when…" clause lists the requests that should load it.
| Designing or refactoring content models | [Data Modeling Best Practices](../skills/cms-data-modeling-best-practices.md) |
| Setting up or debugging Live Preview, Visual Editor (Visual Builder) or Timeline | [Live Preview & Visual Editor Support](../skills/cms-live-preview-visual-editor-support-assistant.md) |
| Fetching entries, CDA queries, pagination, bulk ops | [Entries](../skills/cms-entries.md) |
| Uploading, transforming, delivering assets | [Assets](../skills/cms-assets.md) |
| Uploading, transforming, delivering assets in a stack | [Assets](../skills/cms-assets.md) |
| Assets DAM: spaces, workspaces, duplicate sets, saved views, visual markups | [Asset Management](../skills/asset-management.md) |
| Classifying content, category hierarchies | [Taxonomy](../skills/cms-taxonomy.md) |
| Workflow stages, approvals, publish rules | [Workflows & Publish Rules](../skills/cms-workflows.md) |
| Environments, publishing, delivery/preview tokens, Sync API | [Environments & Publishing](../skills/cms-environments-publishing.md) |
Expand Down
3 changes: 2 additions & 1 deletion docs/overview/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,12 @@ Agent skills close that gap. They give the assistant Contentstack-specific knowl

## What's in the bundle

The skills span six Contentstack product areas:
The skills span seven Contentstack product areas:

| Product | Skills |
| --- | --- |
| **CMS** | Assets · Branches & Aliases · Data Modeling · Entries · Environments & Publishing · Localization · Releases · Roles & Permissions · Taxonomy · Tokens & Authentication · Variants & Personalization · Webhooks · Workflows |
| **Assets** | Asset Management |
| **Developer Experience** | Delivery SDK · Contentstack Kickstart Next · Migrate JS→TS SDK · Live Preview & Visual Editor Support · Migration Companion |
| **Studio** | Contentstack Studio |
| **Launch** | Sync env vars from `.env.example` · Trigger & Monitor Deployments |
Expand Down
43 changes: 43 additions & 0 deletions docs/skills/asset-management.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: Asset Management
description: "Advise on the Contentstack Assets DAM: spaces and workspaces, metadata, localization, saved views, search, AI tags, duplicates, versions, trash and restore, and visual markups."
---

# Asset Management

**Slug:** `asset-management` · **Product:** Assets (DAM) · **Type:** Advisory (read-only)

Advises on Contentstack Assets, the standalone digital asset management product. It is separate from the CMS stack asset library covered by [Assets](cms-assets.md).

## When it triggers

When you ask about the Assets DAM: spaces and workspaces, folders, asset types and metadata, localization, saved views, AI tags and alt text, duplicate management, versions, trash and restore, visual markups, or linking Assets to CMS stacks.

## What it covers

- **Spaces and workspaces**: a space is the top-level container, and workspaces are isolated environments inside it, created from the main workspace or a parent workspace.
- **Folders and roles**: folder creation and least-privilege guidance.
- **Asset types and metadata**: system, general and user-defined metadata. The currently supported user-defined field types are single line text, number, select and group. Filters on user-defined fields can be saved as saved views.
- **Localization**: add a language in product settings, then add it per workspace under Space Settings > Workspaces > Manage Locales.
- **Search**: the public Assets API search endpoint, required headers, and filtering by user-defined field.
- **AI tags and alt text**: manual suggestions and auto-populate at upload, with their limits.
- **Duplicate management**: exact-duplicate sets for images, how to resolve them, and what is not detected.
- **Versions, trash and restore**: renaming and restoring versions, the 14-day trash window, and folder restore options.
- **Visual markups**: hotspots and bounding boxes, including AI-suggested markups.
- **CMS integration**: linking spaces to stacks and the `asset_fields[]` Content Delivery API parameter.

## Example prompts

- "How should I split my brands and regions across spaces and workspaces?"
- "How do I add a language to a workspace?"
- "How do I find and remove duplicate images?"
- "I deleted a folder by mistake. Can I get it back?"
- "How do I search assets by a custom field value?"

## Safety notes

Read-only advisory. Never uploads, moves, deletes, restores or modifies assets, spaces or settings. Warns before irreversible actions such as deleting a space or all markups. Never exposes tokens or API keys; examples use environment variables.

## Related

- [Assets](cms-assets.md) · [Localization](cms-localization.md) · [Roles & Permissions](cms-roles-permissions.md)
1 change: 1 addition & 0 deletions docs/skills/cms-assets.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,5 @@ Read-only advisory. Never uploads, deletes, publishes, or modifies assets. Deliv

## Related

- For the standalone Assets DAM (spaces, workspaces, duplicate sets), see [Asset Management](asset-management.md). Reading or updating user-defined fields isn't supported by the stack asset library; use the Assets (DAM) API described there.
- [Environments & Publishing](cms-environments-publishing.md) · [Entries](cms-entries.md) · [Data Modeling Best Practices](cms-data-modeling-best-practices.md)
8 changes: 7 additions & 1 deletion docs/skills/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: The full catalog of Contentstack Agent Skills, grouped by product.

# Skills reference

The bundle includes 23 skills across six Contentstack products. Each links to a dedicated page with what it does, when it triggers, example prompts, and its safety notes.
The bundle includes 24 skills across seven Contentstack products. Each links to a dedicated page with what it does, when it triggers, example prompts, and its safety notes.

> Each skill page mirrors its canonical `skills/<slug>/SKILL.md`. The slug is the skill's identifier: use it with the [`skills` CLI](../get-started/skills-cli.md).

Expand Down Expand Up @@ -37,6 +37,12 @@ The bundle includes 23 skills across six Contentstack products. Each links to a
| [Live Preview & Visual Editor Support](cms-live-preview-visual-editor-support-assistant.md) | `cms-live-preview-visual-editor-support-assistant` | Setting up or debugging Live Preview, Visual Editor (Visual Builder) or Timeline across CSR, SSR, SSG, BFF. |
| [Migration Companion](migration-companion.md) | `migration-companion` | Guided Contentful → Contentstack migration: content and application code. |

## Assets

| Skill | Slug | What it helps with |
| --- | --- | --- |
| [Asset Management](asset-management.md) | `asset-management` | Assets DAM spaces and workspaces, metadata, localization, saved views, AI tags, duplicates, versions, trash and restore, visual markups. |

## Studio

| Skill | Slug | What it helps with |
Expand Down
2 changes: 1 addition & 1 deletion gemini-extension.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "contentstack-skills",
"version": "0.2.0",
"version": "0.3.0",
"description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations."
}
2 changes: 1 addition & 1 deletion plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "contentstack-skills",
"version": "0.2.0",
"version": "0.3.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",
Expand Down
Loading
Loading