Delete 25 atomic reference files that duplicated content already
covered by the comprehensive topic guides (groq.md, schema.md, etc.).
Unique content from atomics (optimizable filters table, defineMigration
example, compound cursor pattern, icon mapping table, stegaClean
alternatives, etc.) was merged into the corresponding guide before
deletion.
Also makes migration.md an index that points to migration-html-import.md
for the HTML deep-dive, keeping the pattern extensible for future
migration guides.
Updates SKILL.md and AGENTS.md to reflect the consolidated structure
(47 → 22 reference files).
Migrate all 21 .mdc agent rules from rules/ into the sanity-best-practices
skill as the single source of truth, following the agentskills.io spec.
- Move comprehensive guides to skills/sanity-best-practices/references/
(e.g., sanity-nextjs.mdc → references/nextjs.md)
- Rename rules/ → references/ per agentskills.io specification
- Convert .mdc frontmatter to standard .md (add title/tags, drop alwaysApply)
- Update all internal cross-references to new paths
- Rewrite SKILL.md with Quick Reference index (Vercel pattern)
- Add compiled AGENTS.md inside skill with all 26 atomic rules
- Update root AGENTS.md Knowledge Router to point to new locations
- Update README.md with new repository structure
- Delete all 21 old rules/sanity-*.mdc files (clean break)
- All 4 skills pass validation
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add missing author field to cursor plugin marketplace.json
- Restore query-level filter in migration example for performance
- Clarify sameAs vs socialLinks field purposes in EEAT schema
- Add TypeScript types to generateMetadata params in hreflang example
- Revert useCdn to false for SSR getting-started example
- Add NDJSON guardrail back to AGENTS.md boundaries
- Fix npx prefix consistency in typegen watch mode command
- Add schema.org position comment in BreadcrumbList example
- Clarify @graph @context usage and improve JSON-LD security note
- Deduplicate typegen-workflow.md by referencing the canonical rule file
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Fixes from final review pass by DX and TypeScript expert agents:
- Added "unique query names" requirement (common developer footgun)
- Added tsconfig includes requirement for sanity.types.ts
- Fixed AUTHOR_QUERY example: was array query used as single object
- Added .astro, .svelte, .vue to path glob examples
- Updated Astro rule to use defineQuery instead of raw strings
- Updated get-started guide to use defineQuery (was raw string)
- Updated GROQ maintenance workflow to mention automatic generation
- Updated AGENTS.md boundary to mention typegen.enabled option
- Fixed groq-define-query.md to show auto-inference as primary pattern
- Standardized import path to @/sanity.types
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
AGENTS.md tool names were inconsistent with actual MCP server tools
(e.g. create_document_from_markdown vs create_documents_from_markdown).
Updated both AGENTS.md and README.md to match the current MCP server
tool list, organized into 5 categories: content operations, schema &
development, media & AI, releases, and project management.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
James Woods