{
  "markdown": "# Contentstack Vibe Docs\n\nAn [Agent Skill](https://agentskills.io/) that gives AI coding agents comprehensive Contentstack CMS knowledge. Works with Claude Code, Cursor, GitHub Copilot, VS Code, Gemini CLI, Roo Code, and [25+ other tools](https://agentskills.io/).\n\n> **AI Agents: Read [SKILL.md](SKILL.md).** It contains routing rules that direct you to the 1-3 files you need. Do not read all files — this skill contains ~11,000 lines across 20 reference documents.\n\n---\n\n## Install\n\n### Universal (all agents)\n\nInstall with the [skills CLI](https://skills.sh/docs/cli):\n\n```bash\nnpx skills add timbenniks/contentstack-vibe-docs\n```\n\nThis auto-detects your installed agents (Claude Code, Cursor, Copilot, Windsurf, Cline, etc.) and installs the skill for all of them.\n\nInstall for specific agents only:\n\n```bash\nnpx skills add timbenniks/contentstack-vibe-docs -a claude-code\nnpx skills add timbenniks/contentstack-vibe-docs -a cursor\nnpx skills add timbenniks/contentstack-vibe-docs -a github-copilot\n```\n\nInstall globally (available in all your projects):\n\n```bash\nnpx skills add timbenniks/contentstack-vibe-docs -g\n```\n\n### Claude Code\n\nInstall as a personal skill (all projects):\n\n```bash\nclaude skill add timbenniks/contentstack-vibe-docs\n```\n\nOr use the skills CLI:\n\n```bash\nnpx skills add timbenniks/contentstack-vibe-docs -a claude-code -g\n```\n\nOnce installed, Claude Code discovers the skill automatically when you work on Contentstack tasks. You can also invoke it directly:\n\n```\n/contentstack-vibe-docs fetch blog posts with author references\n/contentstack-vibe-docs set up live preview in Next.js\n/contentstack-vibe-docs optimize images for responsive layouts\n```\n\n### Gemini CLI\n\n```bash\ngemini skills install https://github.com/timbenniks/contentstack-vibe-docs.git\n```\n\nInstall to workspace scope:\n\n```bash\ngemini skills install https://github.com/timbenniks/contentstack-vibe-docs.git --scope workspace\n```\n\n### Manage installed skills\n\n```bash\nnpx skills list              # List all installed skills\nnpx skills check             # Check for updates\nnpx skills update            # Update all skills\n```\n\n### Claude Code Plugin\n\nThis repo is also a [Claude Code plugin](https://code.claude.com/docs/en/plugins). Install it directly:\n\n```bash\nclaude plugin install https://github.com/timbenniks/contentstack-vibe-docs\n```\n\nOr test locally during development:\n\n```bash\nclaude --plugin-dir ./contentstack-vibe-docs\n```\n\nThe plugin includes:\n- **Skills** — the full Contentstack documentation skill with routing and references\n\n### Cursor Plugin\n\nThis repo is also a [Cursor plugin](https://cursor.directory/plugins/contentstack). Install it directly in Cursor:\n\n1. Open Cursor Settings > Plugins\n2. Add this repository URL: `https://github.com/timbenniks/contentstack-vibe-docs`\n\nThe plugin includes:\n- **Skills** — the full Contentstack documentation skill with routing and references\n- **Rules** — `rules/contentstack.mdc` with routing table, decision helpers, security guardrails, and quick patterns\n\n---\n\n## How It Works\n\nThis skill uses **progressive disclosure** to keep your agent's context window clean:\n\n1. **Discovery** (~100 tokens) — The agent loads the skill name and description. Just enough to know \"this is relevant for Contentstack tasks.\"\n2. **Activation** (~3,500 tokens) — When a Contentstack task is detected, the agent reads `SKILL.md` with its routing table, decision helpers, and inline quick-start patterns.\n3. **Execution** (on-demand) — The routing table directs the agent to read only the 1-3 specific reference files it needs. It never loads all ~11,000 lines.\n\n```\nUser: \"Add live preview to my Next.js app\"\n  → Agent loads SKILL.md (routing table)\n  → Reads references/live-preview/concepts.md (131 lines)\n  → Reads references/live-preview/ssr-mode.md (315 lines)\n  → Reads references/frameworks/nextjs.md (424 lines)\n  → Implements with copy-paste ready code\n```\n\n---\n\n## What's Covered\n\n| Topic | Reference File |\n|-------|---------------|\n| Quick code patterns | [QUICK_REFERENCE.md](references/QUICK_REFERENCE.md) |\n| CMS fundamentals | [base-concepts.md](references/concepts/base-concepts.md) |\n| Data modeling best practices | [data-modeling-best-practices.md](references/concepts/data-modeling-best-practices.md) |\n| Region configuration | [regions.md](references/concepts/regions.md) |\n| REST Content Delivery API | [rest-api.md](references/api/rest-api.md) |\n| GraphQL Content Delivery API | [graphql-api.md](references/api/graphql-api.md) |\n| Content Management API (CRUD) | [content-management-api.md](references/api/content-management-api.md) |\n| Image Delivery API (transforms) | [image-delivery-api.md](references/api/image-delivery-api.md) |\n| TypeScript Delivery SDK | [delivery-sdk.md](references/sdk/delivery-sdk.md) |\n| Live Preview (concepts) | [concepts.md](references/live-preview/concepts.md) |\n| Live Preview (CSR mode) | [csr-mode.md](references/live-preview/csr-mode.md) |\n| Live Preview (SSR mode) | [ssr-mode.md](references/live-preview/ssr-mode.md) |\n| Next.js patterns | [nextjs.md](references/frameworks/nextjs.md) |\n| Nuxt patterns | [nuxt.md](references/frameworks/nuxt.md) |\n| Gatsby patterns | [gatsby.md](references/frameworks/gatsby.md) |\n| OAuth with Auth.js | [oauth.md](references/authentication/oauth.md) |\n| CLI plugin development | [cli-plugins.md](references/extensions/cli-plugins.md) |\n| Developer Hub apps | [devhub-apps.md](references/extensions/devhub-apps.md) |\n| Real-world code examples | [practical-examples.md](references/examples/practical-examples.md) |\n| Package version compatibility | [VERSIONS.md](references/VERSIONS.md) |\n\nAll regions supported: US, EU, AU, Azure NA/EU, GCP NA/EU.\n\n---\n\n## Security & Guardrails\n\nThis skill includes built-in security measures and red flags that instruct agents to handle credentials safely:\n\n- **No secret leaking** — Agents are explicitly told to never ask for, output, log, or hardcode API keys, tokens, or secrets. All code uses `process.env.*` references.\n- **Credential hygiene** — If a developer accidentally pastes a real token in the conversation, the agent is instructed to warn them and suggest they rotate it.\n- **Frontend protection** — Management Tokens are flagged as server-side only. Agents are told to never expose them in frontend code.\n- **`.env` safety** — Agents are instructed to never commit `.env` files or credentials to version control.\n- **Red flags checklist** — A dedicated \"Red Flags\" section in `SKILL.md` lists specific anti-patterns agents must avoid, from hardcoding secrets to mixing SDK patterns incorrectly.\n- **Questions before code** — Agents are guided to ask about region, framework, and environment setup before writing any code, ensuring the right patterns are used from the start.\n\n---\n\n## Documentation Structure\n\nThis repo follows the [Open Plugins](https://open-plugins.com/plugin-builders) standard:\n\n```\n.plugin/\n└── plugin.json              # Open Plugins manifest (OpenCode, etc.)\n\n.claude-plugin/\n└── plugin.json              # Claude Code plugin manifest\n\n.cursor-plugin/\n└── plugin.json              # Cursor plugin manifest\n\nskills/\n└── contentstack-vibe-docs/\n    ├── SKILL.md → ../../SKILL.md        # Symlink to root skill\n    └── references → ../../references    # Symlink to root references\n\nrules/\n└── contentstack.mdc         # Cursor rules (routing, helpers, security)\n\nreferences/\n├── QUICK_REFERENCE.md          # Condensed patterns for quick lookup\n├── VERSIONS.md                 # Package version compatibility\n├── concepts/\n│   ├── base-concepts.md        # CMS fundamentals\n│   ├── data-modeling-best-practices.md  # Schema design and modeling guidance\n│   └── regions.md              # Region configuration\n├── api/\n│   ├── rest-api.md             # REST Content Delivery API\n│   ├── graphql-api.md          # GraphQL Content Delivery API\n│   ├── content-management-api.md  # Content Management API (CRUD)\n│   └── image-delivery-api.md   # Image Delivery API (transforms)\n├── sdk/\n│   └── delivery-sdk.md         # TypeScript SDK guide\n├── live-preview/\n│   ├── concepts.md             # Live Preview overview\n│   ├── csr-mode.md             # ssr:false — postMessage updates\n│   └── ssr-mode.md             # ssr:true — iframe refresh\n├── authentication/\n│   └── oauth.md                # OAuth login with Auth.js\n├── frameworks/\n│   ├── nextjs.md               # Next.js patterns\n│   ├── nuxt.md                 # Nuxt 4 patterns\n│   └── gatsby.md               # Gatsby patterns\n├── extensions/\n│   ├── cli-plugins.md          # CLI plugin development\n│   └── devhub-apps.md          # Developer Hub apps\n└── examples/\n    └── practical-examples.md   # Real-world code patterns\n```\n\n---\n\n## Support\n\n- [Contentstack Documentation](https://www.contentstack.com/docs)\n- [Discord Community](https://community.contentstack.com)\n- [Contentstack Support](https://www.contentstack.com/support)\n- [Agent Skills Specification](https://agentskills.io/)\n\n---\n\n## License\n\nThis documentation is provided as-is for use with AI coding assistants.\n",
  "bytes": 9051,
  "sha": "8f028c41a8b9d605293a07a499e8136edeebe54fe8b0748ee781d71e42745fd9",
  "repo_slug": "timbenniks/contentstack-vibe-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_timbenniks_contentstack_vibe_docs_conten_4faef352/readme"
}