sanity-best-practices

sanity-best-practices skill 개요

sanity-best-practices skill이 하는 일

sanity-best-practices skill은 빌드에 들어가기 전에 적절한 모델링, 쿼리, Studio, 통합 패턴을 고를 수 있도록 돕는 Sanity 전용 가이드 묶음입니다. 더 깔끔한 Sanity 구현, 피할 수 있는 리팩터링의 최소화, 그리고 대략적인 아이디어에서 프로덕션용 스키마나 프런트엔드 코드로 더 빨리 가는 경로가 필요할 때 가장 유용합니다.

누가 사용해야 하나요?

스키마, GROQ, TypeGen, Visual Editing, Portable Text, 로컬라이제이션, 마이그레이션, Functions, Blueprints, 또는 Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, App SDK 같은 프레임워크 통합을 다루는 Sanity 코드베이스에서 작업 중이라면 이 sanity-best-practices skill을 사용하세요. 프런트엔드 엔지니어, 콘텐츠 플랫폼 구축자, 그리고 기존 Sanity 구성을 검토하는 팀에 특히 잘 맞습니다.

설치할 가치가 있는 이유

핵심 가치는 판단의 질입니다. defineQuery를 언제 써야 하는지, 타입 안정성을 위해 쿼리를 어떻게 구성해야 하는지, 또는 기능을 Studio에 둘지 프런트엔드에 둘지 같은 Sanity 고유의 제약을 놓치는 일반적인 프롬프트를 피할 수 있게 해줍니다. “Sanity 좀 도와줘” 같은 넓은 요청보다, 가정이 적은 상태에서 빌드하도록 도와주는 sanity-best-practices guide가 필요하다면 이 skill이 더 유용합니다.

sanity-best-practices skill 사용하는 방법

먼저 설치하고 올바른 파일부터 여세요

스킬 툴체인에서 sanity-best-practices install 흐름을 사용한 뒤, 범위를 확인하려면 SKILL.md부터 보세요. 그 다음에는 작업과 맞는 주제 파일만 읽으면 됩니다. 이 저장소는 길게 이어진 하나의 매뉴얼이 아니라, 주제별로 잘게 나뉜 참고 문서 구조로 되어 있습니다. 대부분의 작업에서는 references/get-started.md, references/schema.md, references/groq.md, references/typegen.md, 그리고 해당 프레임워크 파일을 먼저 읽는 것이 좋습니다.

모호한 요청을 바로 쓸 수 있는 입력으로 바꾸세요

이 skill은 기술명만 던지는 것보다, 구체적인 목표를 줄 때 가장 잘 작동합니다. “내 Sanity 설정을 개선해줘”라고 하기보다, “이 Next.js + Sanity 페이지 빌더 스키마를 검토하고 TypeGen, GROQ, Visual Editing에 대해 모범 사례 변경점을 제안해줘”라고 말하세요. sanity-best-practices usage 요청에는 프레임워크, Sanity 버전, 현재 파일, 그리고 깨진 타입, 느린 쿼리, 미리보기 불일치, 어색한 콘텐츠 모델링 같은 실패 양상을 함께 넣어야 합니다.

습관대로가 아니라 작업 기준으로 저장소를 읽으세요

작업에 맞는 참고 파일을 사용하세요:

• 콘텐츠 모델, defineType, defineField는 references/schema.md
• 쿼리 구조와 쿼리 안전성은 references/groq.md
• 프리뷰와 Presentation 설정은 references/visual-editing.md
• 타입이 있는 스키마와 타입이 있는 쿼리는 references/typegen.md
• 통합 세부사항은 references/nextjs.md, references/astro.md, references/nuxt.md 또는 다른 프레임워크 파일
• 이벤트 기반 자동화와 인프라는 references/functions.md와 references/blueprints.md

제약을 드러내는 프롬프트 형식을 쓰세요

좋은 프롬프트에는 보통 다음이 들어갑니다: 무엇을 만들고 있는지, 어떤 파일을 검토받고 싶은지, 어떤 프레임워크를 쓰는지, 그리고 무엇은 바꾸면 안 되는지. 예를 들어: “이 post 스키마를 로컬라이제이션과 Portable Text 모범 사례 관점에서 감사해 주세요. 공개 API는 유지하고, 가능한 경우 기존 필드명은 보존하며, 깨지는 변경이 있으면 설명해 주세요.” 이렇게 구체적으로 적어야 일반론이 아니라 실행 가능한 sanity-best-practices usage 결과를 얻을 수 있습니다.

sanity-best-practices skill FAQ

이 skill은 새 Sanity 프로젝트에만 필요한가요?

아닙니다. sanity-best-practices skill은 기존 프로젝트를 손볼 때도 매우 유용합니다. 특히 스키마 드리프트를 줄이거나, 쿼리 유지보수성을 높이거나, 프런트엔드와 Studio의 동작을 맞춰야 할 때 효과적입니다.

일반 프롬프트와는 무엇이 다른가요?

일반 프롬프트는 대개 답변 하나를 독립적으로 묻습니다. 이 skill은 Sanity 중심의 작업 흐름과 참고 경로를 함께 제공하므로, 결과가 일반 JavaScript 조언이 아니라 스키마, GROQ, 프리뷰, TypeGen, 프레임워크 통합에 대한 모범 사례를 반영하게 됩니다.

초보자도 쓰기 쉬운가요?

네, 이미 Sanity에서 작업 중이라는 전제가 있다면 그렇습니다. 이 skill만으로 초보자 온보딩 과정을 대신하는 것은 아니지만, 어떤 Sanity 기능이 해당하는지 추측하게 하지 않고 올바른 주제 파일로 안내해 혼란을 줄여줍니다.

언제는 사용하지 말아야 하나요?

문제가 Sanity와 무관하거나, 모델링·쿼리·통합 판단이 전혀 없는 아주 작은 단발성 수정만 필요하다면 건너뛰세요. Sanity 콘텐츠 흐름과 무관한 순수 프런트엔드 디버깅 세션에는 적합하지 않습니다.

sanity-best-practices skill 개선하기

실제로 필요한 결정을 직접 말하세요

가장 좋은 결과는 실제 트레이드오프를 분명히 적을 때 나옵니다. 예: “이 필드는 reference여야 하나요, 아니면 inline object여야 하나요?” 또는 “이 쿼리는 프런트엔드에 두는 게 맞나요, 아니면 스키마에서 정규화해야 하나요?” 이런 식이 폭넓은 정리 요청보다 낫습니다. 구조가 아니라 문법만 다듬는 수준에 머물지 않도록, skill이 아키텍처에 맞춰 최적화할 수 있기 때문입니다.

현재 코드의 형태를 함께 보여주세요

검토받고 싶은 스키마, 쿼리, 통합 코드 조각과 함께, 콘텐츠가 시스템을 따라 어떻게 이동하는지 볼 수 있을 만큼의 주변 맥락을 붙여 넣으세요. sanity-best-practices for Frontend Development를 요청할 때는 프레임워크, 렌더링 모드, 그리고 preview, SSR, static build, live updates 중 무엇이 필요한지도 포함하세요.

첫 답변만이 아니라 다음 반복까지 요청하세요

첫 번째 결과를 받은 뒤에는 한 가지 목표에 맞춰 더 조여 달라고 요청하세요. 예를 들면 타입 안전성, 편집자 경험, 쿼리 성능, 콘텐츠 작성 명확성 중 하나입니다. 흔한 실패 양상은 과도하게 정규화된 스키마, 너무 느슨하게 정의된 GROQ 필터, 그리고 Studio 가정과 맞지 않는 프런트엔드 코드입니다. 가장 빠른 개선은 보통 제약을 추가하고, 더 적은 이동 요소로 다시 작성해 달라고 요청할 때 나옵니다.

저장소 근거를 써서 방향을 맞추세요

헷갈릴 때는 references/localization.md, references/migration.md, references/page-builder.md 같은 관련 참고 파일 경로를 후속 질문의 기준점으로 삼으세요. 이렇게 하면 sanity-best-practices skill이 저장소가 의도한 패턴 안에 머물게 되고, 최종 결과도 구현하기 쉬워집니다.