06-cms-environments-publishing

Rules for managing draft and live content in Contentstack, a content management system. They explain environments, publishing, tokens, synchronization, scheduling, and content delivery through a CDN, which is a network of caching servers.

In plain words
What is it for?
Configuring Contentstack environments, choosing delivery or preview tokens, using the Sync API, handling scheduled publishing, and understanding CDN caching.
Why use it?
They help developers understand why content is not yet live, which token is appropriate, how frontends receive updates, and how caching or publishing queues affect results.

Cursor rule

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/contentstack/contentstack-agent-skills/06-cms-environments-publishing
Clone the repo
git clone --depth 1 https://github.com/contentstack/contentstack-agent-skills
Per session 32 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,132 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00032 $0.01132
Opus 5 $0.00016 $0.00566
Sonnet 5 $0.00006 $0.00226
Haiku 4.5 $0.00003 $0.00113

Measured yesterday against content hash e3c030699330, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

06-cms-environments-publishing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

cursor/rules/06-cms-environments-publishing.mdc · 107 lines

How it starts

The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Contentstack Environments & Publishing

Description

Advise developers on configuring environments, publishing content, using delivery and preview tokens, leveraging the Sync API, and understanding CDN and publish queue behavior in Contentstack.

When to Use

Use when developers ask about environment setup, publishing behavior, delivery or preview tokens, the Sync API, scheduling, or CDN and caching configuration in Contentstack.

User Problem

Developers need to understand how content moves from draft to live, how environments and tokens work together, and how to keep frontends in sync.

Success Criteria

Explains the publishing pipeline clearly. Identifies the correct token type for the scenario. Recommends the Sync API when appropriate. Avoids suggesting any unsafe client-side secret handling.

Expected Inputs

  • Deployment pipeline or environment requirements
  • Frontend framework or static site generator
  • Token or authentication questions
  • Scheduling or publish queue concerns

Expected Outputs

  • Environment configuration guidance
  • Token usage recommendations
  • Publishing workflow explanation
  • Sync API setup guidance
  • CDN and caching explanations

Example User Requests

  • How many environments should I set up?
  • What is the difference between a delivery token and a preview token?
  • My content is not showing on the live site after publishing.
  • How does the Sync API work?
  • Can I schedule content to publish at a future time?

Workflow Summary

Understand the deployment pipeline. Recommend the environment structure. Explain token types and their use cases. Guide publishing, scheduling, and reference publishing. Recommend the Sync API for static sites or local caches.

Instructions

[{"heading":"Environment design","content":"Treat environments as deployment targets such as development, staging, and production. Keep them aligned with the real deployment pipeline. Default max is 5 per stack. Environments are global modules and are shared across branches."},{"heading":"Publishing fundamentals","content":"Explain that content is a draft until explicitly published to an environment. Publishing can target one or more environments and locales. For nested reference publishing, use api_version: 3.2 so the full reference tree is resolved and published automatically. Always publish entries with their references."},{"heading":"Token types","content":"Use the correct token in every answer: Delivery Token for published content via the CDA, environment-scoped and safe for client-side use; Preview Token for unpublished draft content in live preview; Management Token for stack-level read/write access, server-side only, never exposed client-side."},{"heading":"SDK initialization","content":"When relevant, mention Stack API key plus delivery token plus environment name, and optionally branch or alias ID. Note that CDA base URLs are region-specific, such as cdn.contentstack.io for AWS NA, eu-cdn.contentstack.com for AWS EU, and au-cdn.contentstack.com for AWS AU."},{"heading":"Sync API","content":"Recommend the Sync API for static sites, offline apps, or local content caches. Explain that the first request returns all published content plus a sync_token, and later requests return only changes such as created, updated, deleted, published, and unpublished items. Prefer it over polling when near-real-time updates are needed without excessive API usage."},{"heading":"Publish queue","content":"Explain that the publish queue tracks publish and unpublish operations and their status. Mention that each branch has its own queue and that scheduled publishes can be cancelled before execution."},{"heading":"Rate limits","content":"Mention the platform limits when relevant: 10 requests/second individual and 1 request/second bulk per organization. Recommend exponential backoff with jitter for scripts, and note that the CLI bulk publish plugin handles rate limiting automatically."}],

Read the full file on GitHub · 107 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 107 lines · 32 tokens per session scan A e3c030699330

Subscribe to this mod's changes

06-cms-environments-publishing is a cursor rule published in the GitHub repository contentstack/contentstack-agent-skills (5 stars, last pushed 15d ago), licensed MIT. It adds 32 tokens to every session and 1,132 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.