[Feature Request] Add skips resource type for content filtering and segment skipping

[ameen-roayan]

Summary

Add a new skips resource type that allows addons to provide skip segments for content filtering, intro skipping, ad skipping, etc.

Proposed API

Manifest

{
  "resources": ["skips"],
  "types": ["movie", "series"],
  "idPrefixes": ["tt"]
}

Handler

builder.defineSkipsHandler(async ({ type, id, config }) => {
  return {
    skips: [
      {
        id: "skip-1",
        startMs: 3600000,
        endMs: 3660000,
        category: "violence",
        severity: "high",
        description: "Fight scene"
      }
    ]
  }
})

Endpoint

GET /skips/:type/:id.json

Use Cases

• Content filtering - Skip nudity, violence, language (family-friendly viewing)
• Intro/outro skipping - Like Netflix's "Skip Intro" button
• Ad skipping - For ad-supported content
• Recap skipping - Skip "Previously on..." segments
• SponsorBlock-style - Community-driven skip timestamps

Why This Approach?

1. Independent skip addons - Addons don't need to provide streams, just skip data
2. User choice - Multiple skip addons can coexist, user selects which one (like subtitles)
3. Clean separation - Doesn't pollute stream objects
4. Familiar pattern - Same architecture as subtitles

Implementation

I've created a PR with the SDK changes: #360

Related feature request: Stremio/stremio-features#1608

Working Proof of Concept

CleanStream - 376+ movies with 1600+ skip segments, ready to use this API once implemented.

[Pigamer37]

Seems like the new "donation" features are implementing something very similar to this, at least in terms of "intro" and "outro" segments.