Merge PR #14: Videos-tab Shorts nuance

docs: note that sorted results come from the Videos tab

Author: therohitdas

README.md

@@ -393,6 +393,8 @@ List a channel's feed, paginated. Use `tab` to choose the uploads feed (default,
 
 **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit.
 
+Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed.
+
 When paging, send the same sort on each request.
 
 Every item carries **`members_only`**: `true` only when YouTube badges the video "Members only", and those items have no `viewCountText`. It is always `false` on the uploads feed, on `tab: "shorts"`, and on playlists.

skills/youtube/references/mcp-tools.md

@@ -170,6 +170,8 @@ or live streams (~48/page), and the optional `sort` to order the Videos tab.
 
 **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit.
 
+Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed.
+
 When paging, send the same sort on each request.
 
 Every item carries **`members_only`**: `true` only when YouTube badges the video "Members only", and those items have no `viewCountText`. It is always `false` on the uploads feed, on `tab: "shorts"`, and on playlists.

skills/youtube/references/rest-api.md

@@ -197,6 +197,8 @@ Provide **exactly one** of `channel` or `continuation`. The response carries
 
 **Sorting.** Add sort=latest, popular, or oldest to channel/videos to get a channel's videos in the order you want, for example its most-popular uploads first. A sorted page returns about 30 videos (an unsorted page returns about 100), and every page costs the same 1 credit.
 
+Sorted results come from YouTube's Videos tab (long-form only); Shorts have their own tab=shorts feed.
+
 When paging, send the same sort on each request.
 
 Every item carries `members_only`, `true` only when YouTube badges it "Members only", and those