scan-sanity-schema

Validate local Sanity schema definitions against the live dataset and report drift.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/TrevorPLam/agency --skill scan-sanity-schema
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-sanity-schema
Source: https://github.com/TrevorPLam/agency/tree/main/.windsurf/skills/scan-sanity-schema
Command: npx skills add https://github.com/TrevorPLam/agency --skill scan-sanity-schema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between local Sanity schema definitions and the live dataset can disrupt content workflows; this skill validates definitions against the cloud and flags drift for remediation.

Core Features & Use Cases

  • Schema validation against Sanity cloud
  • Drift detection for missing or changed fields
  • Targeted scope to apps/cms-studio and consuming packages

Quick Start

Run the Windsurf scan to validate Sanity schemas against the cloud dataset.

Frequently Asked Questions about scan-sanity-schema

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

FAQPage Schema
How do I detect Sanity CMS schema drift between my local definitions and the live dataset?

To detect Sanity CMS schema drift, you validate local schema definitions against the live Sanity dataset. This process identifies missing or changed fields, ensuring schema integrity and preventing content workflow disruptions.

What is Sanity schema validation and when do I need it?

Sanity schema validation is the process of verifying type definitions and GROQ usage against the live cloud dataset. You need it when local schema definitions change, ensuring consuming packages maintain schema consistency during CMS assessments.

Can I use schema drift detection for packages consuming Sanity data outside of cms-studio?

Yes, schema drift detection targets apps/cms-studio and related packages consuming Sanity data. It verifies type definitions and GROQ usage across these packages to maintain schema consistency during CMS studio assessments.

How to validate Sanity type definitions and GROQ usage during a studio assessment?

You validate Sanity type definitions and GROQ usage by running a scan against the cloud dataset. This enforces prerequisites, performs schema validation, and produces deterministic drift reports according to your environment configuration.

Why does missing or changed fields in my Sanity schema disrupt content workflows?

Missing or changed fields in your Sanity schema disrupt content workflows because local definitions diverge from the live dataset. Validating definitions against the cloud flags this drift for remediation, restoring schema integrity.