Add video hosting guidance to sanity-best-practices - #59
Merged
Conversation
Users keep serving video from Sanity file assets in production, which delivers raw downloads with no adaptive streaming and leads to very high bandwidth usage. Add a Video section to the skill's global guidance: use sanity-plugin-mux-input or an external video platform and store only the playback ID or embed URL in Sanity. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Siwz2hh1ZJdWfqnZZhQ9T1
Member
|
@kmelve What about media library? |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the sanity-best-practices skill to include explicit guidance on handling video content, aiming to prevent agents from modeling production video as Sanity file assets (which can lead to high bandwidth costs and poor playback patterns).
Changes:
- Adds a new
## Videosection under Global Rules that discourages using Sanityfileassets for production video playback. - Recommends dedicated video hosting/streaming services (notably
sanity-plugin-mux-input/ Mux, or YouTube/Vimeo) and storing only playback IDs/embed URLs in Sanity. - Clarifies an acceptable exception for small clips/previews while still requiring streaming services for user-facing video at scale.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Address PR feedback: Media Library supports transcoded, adaptively streamed video (via Mux), but only as a paid add-on on certain Enterprise plans. Recommend it first for those plans, and clarify that sanity-plugin-mux-input uploads/manages videos in your own Mux account rather than streaming from the Studio. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Member
|
@runeb good point - added! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Knut Melvær · Slack thread
Before: an agent following the
sanity-best-practicesskill got no guidance about video at all. Nothing stopped it from modeling video as a Sanityfilefield and serving it straight from asset storage in production — the pattern that keeps landing users with very high bandwidth usage and unexpectedly large bills, since file assets are delivered as raw downloads with no transcoding or adaptive streaming.After: the skill now tells agents explicitly: do not store or serve production video from Sanity
fileassets. Use a dedicated video service instead —sanity-plugin-mux-inputfor uploading and streaming video from the Studio, or host on a platform like Mux, YouTube, or Vimeo and store only the playback ID or embed URL in Sanity. Small clips and short previews are fine, but user-facing video at scale must go through a streaming service.How: adds a concise
## Videosection toskills/sanity-best-practices/SKILL.md, placed right after Global Rules so it's always loaded when the skill activates, in the same terse bullet style. No reference file currently covers file/asset fields, so the guidance lives in one place with no cross-references.🤖 Generated with Claude Code
https://claude.ai/code/session_01Siwz2hh1ZJdWfqnZZhQ9T1
Generated by Claude Code