contentstack-vibe-docs

Contentstack Vibe Docs

An Agent Skill 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.

AI Agents: Read skills/contentstack-vibe-docs/SKILL.md. It contains routing rules that direct you to the 1-3 files you need. Do not read all files — this skill contains ~13,500 lines across 34 reference documents.

---

Install

Universal (all agents)

Install with the skills CLI:

npx skills add contentstack/contentstack-vibe-docs

This auto-detects your installed agents (Claude Code, Cursor, Copilot, Windsurf, Cline, etc.) and installs the skill for all of them.

Install for specific agents only:

npx skills add contentstack/contentstack-vibe-docs -a claude-code
npx skills add contentstack/contentstack-vibe-docs -a cursor
npx skills add contentstack/contentstack-vibe-docs -a github-copilot

Install globally (available in all your projects):

npx skills add contentstack/contentstack-vibe-docs -g

Claude Code

Install as a personal skill (all projects):

claude skill add contentstack/contentstack-vibe-docs

Or use the skills CLI:

npx skills add contentstack/contentstack-vibe-docs -a claude-code -g

Once installed, Claude Code discovers the skill automatically when you work on Contentstack tasks. You can also invoke it directly:

/contentstack-vibe-docs fetch blog posts with author references
/contentstack-vibe-docs set up live preview in Next.js
/contentstack-vibe-docs optimize images for responsive layouts

Gemini CLI

gemini skills install https://github.com/contentstack/contentstack-vibe-docs.git

Install to workspace scope:

gemini skills install https://github.com/contentstack/contentstack-vibe-docs.git --scope workspace

Manage installed skills

npx skills list              # List all installed skills
npx skills check             # Check for updates
npx skills update            # Update all skills

Claude Code Plugin

This repo is also a Claude Code plugin. Install it directly:

claude plugin install https://github.com/contentstack/contentstack-vibe-docs

Or test locally during development:

claude --plugin-dir ./contentstack-vibe-docs

The plugin includes:

• Skills — the full Contentstack documentation skill with routing and references

Cursor Plugin

This repo is also a Cursor plugin. Install it directly in Cursor:

1. Open Cursor Settings > Plugins
2. Add this repository URL: https://github.com/contentstack/contentstack-vibe-docs

The plugin includes:

• Skills — the full Contentstack documentation skill with routing and references
• Rules — rules/contentstack.mdc with routing table, decision helpers, security guardrails, and quick patterns

Cursor (manual install)

If you prefer not to use the plugin marketplace, copy the .mdc rule file directly into your project:

git clone --depth 1 https://github.com/contentstack/contentstack-vibe-docs.git /tmp/cs-skills && \
  mkdir -p .cursor/rules && \
  cp /tmp/cs-skills/cursor/rules/*.mdc .cursor/rules/ && \
  rm -rf /tmp/cs-skills

Cursor auto-discovers .cursor/rules/*.mdc on project open.

Codex CLI

Codex auto-discovers AGENTS.md in your project root. Copy the prebuilt codex/ directory in:

git clone --depth 1 https://github.com/contentstack/contentstack-vibe-docs.git /tmp/cs-skills && \
  cp -r /tmp/cs-skills/codex . && \
  rm -rf /tmp/cs-skills

This places codex/AGENTS.md and codex/skills/contentstack-vibe-docs/ in your project. Codex reads AGENTS.md, which routes it to the skill.

Any other agent (manual)

Every major agent reads at least one of: CLAUDE.md, AGENTS.md, skills/*/SKILL.md, or .cursor/rules/*.mdc. Point your agent at the repo root or copy skills/contentstack-vibe-docs/ into your project — the routing table in SKILL.md does the rest.

---

How It Works

This skill uses progressive disclosure to keep your agent's context window clean:

1. Discovery (~100 tokens) — The agent loads the skill name and description. Just enough to know "this is relevant for Contentstack tasks."
2. 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.
3. Execution (on-demand) — The routing table directs the agent to read only the 1-3 specific reference files it needs. It never loads all ~13,500 lines.