cms-tools

Inspect and mutate MongoDB-backed CMS data with structured Node.js scripts.

Updated May 3, 2024
One-click install
npx skills add https://github.com/Kyonax/dot-files --skill cms-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cms-tools
Source: https://github.com/Kyonax/dot-files/tree/main/.config/doom-mac/gptel-directives/skills/cms-tools
Command: npx skills add https://github.com/Kyonax/dot-files --skill cms-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill eliminates the repetitive, error-prone manual work of querying Madison Reed's Tophat CMS through raw mongosh commands. Instead of writing one-off Docker exec queries, parsing BSON output by eye, and repeating the process 4-6 times per investigation, you get a stable, scripted toolkit that returns structured JSON and enforces safety rails like dry-run mode and automatic backups.

Core Features & Use Cases

  • Read-only inspection scripts: Answer "what does this URL render?" or "what's bound to this experiment?" in a single command. Covers content, templates, experiments, partials, JSON-LD, and component code locations.
  • Safe mutation scripts: Modify experiment status, variant weights, JSON-LD scripts, and template fields with mandatory dry-run gates, automatic backups, and idempotent re-runs.
  • Code locator scripts: Translate CMS metadata (mixin_key, URI) directly to Vue component files and Express route handlers, eliminating grep marathons across the codebase.

Quick Start

Use the cms-tools skill to inspect what renders on the URL /colorbar/location-specific by running the inspect-content-by-uri script and reviewing the returned JSON for the active experiment, variations, and component mixin keys.

Frequently Asked Questions about cms-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inspect what content renders on a specific URL without writing raw MongoDB queries?

To inspect what content renders on a specific URL, you can run a read-only Node.js inspection script against the MongoDB-backed CMS. This returns structured JSON detailing the active experiment, variations, and component mixin keys, eliminating manual mongosh queries.

Can I safely mutate experiment bindings and JSON-LD schemas in a MongoDB-backed CMS?

Yes, you can safely mutate experiment bindings, variant weights, and JSON-LD schemas using dedicated mutation scripts. These scripts enforce mandatory dry-run gates, create automatic backups, and perform idempotent writes to prevent data corruption during CMS updates.

What's the best way to map CMS metadata to Vue component files and Express route handlers?

The best way to map CMS metadata to Vue component files and Express route handlers is using code locator scripts. These scripts translate mixin keys and URIs directly to their source code locations, eliminating time-consuming grep searches across the codebase.

Do I need Docker to run local diagnosis and pre-production validation on my CMS database?

Yes, you need Docker to access the MongoDB database for local diagnosis and pre-production validation. The toolkit relies on Docker-based MongoDB access to execute structured inspection and mutation scripts safely within your local environment.

Why should I use structured scripts instead of manual mongosh commands for CMS investigation?

You should use structured scripts instead of manual mongosh commands because they prevent repetitive errors and parsing inaccuracies. Scripts provide stable tooling that returns structured JSON output, enforcing safety rails like dry-run modes and backups for reliable investigations.

What limitations exist when modifying template fields during a CMS mutation?

When modifying template fields, limitations include being restricted to idempotent re-runs and mandatory dry-run gates. These constraints ensure safe mutations by requiring validation before applying changes to the MongoDB-backed CMS data.