Skip to content
Back to search

tubelab

MarketplaceWorks with Claude CodeGitHub

TubeLab plugins for YouTube research with Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/TubeLabHQ/youtube-research-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/TubeLabHQ/youtube-research-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tubelabhq--youtube-research-skills/badge.svg)](/listings/tubelabhq--youtube-research-skills)

HTML

<a href="/listings/tubelabhq--youtube-research-skills"><img src="/api/listings/tubelabhq--youtube-research-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add TubeLabHQ/youtube-research-skills

Works with Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, Windsurf, VS Code, Grok Build, and other agents that support the [Agent Skills spec](https://agentskills.io).

Grok Build reads skills from `.grok/skills/` in a repo or `~/.grok/skills/`, so a copy of the `skills/` folder is enough:

git clone https://github.com/TubeLabHQ/youtube-research-skills && cp -r youtube-research-skills/skills/* ~/.grok/skills/

Claude Code can also install it as a plugin, which registers the MCP at the same time:

claude plugin marketplace add TubeLabHQ/youtube-research-skills
claude plugin install youtube-research@tubelab

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "tubelab",
  3. "description": "TubeLab plugins for YouTube research with Claude Code",
  4. "owner": { "name": "TubeLab", "url": "https://tubelab.net" },
  5. "plugins": [
  6. {
  7. "name": "youtube-research",
  8. "source": "./",
  9. "description": "YouTube research skills and six agency agents (niche scout, validator, trend analyst, script analyst, packaging team, monetization team) plus the TubeLab MCP server, registered on install.",
  10. "category": "research",
  11. "tags": ["youtube", "tubelab", "mcp", "research"]
  12. }
  13. ]
  14. }
README.md · README · 216 lines
  1. # YouTube Research Skills for AI Agents
  2. Practical AI agent skills for YouTube research, powered by the [TubeLab MCP](https://tubelab.net/youtube-mcp).
  3. These skills help agents find niches that are working, bend a proven format into a new market, explain why a video broke out, write trend reports, generate ideas and titles for a channel, analyze a channel, audit a channel's monetization risk, reverse engineer what works for a channel, research thumbnails, map competitors, mine comments and transcripts, audit monetization, find sponsors, build sponsor prospect lists for brands, and watch a niche over time.
  4. Together they work like a full YouTube agency with six roles: a niche scout, a validator, a trend analyst, a script analyst, a packaging team and a monetization team. It runs on your machine or in your chat app, through your own agent and your own TubeLab account.
  5. This is not endpoint routing. Each skill is a short research workflow: the judgment an expert strategist brings, the traps to avoid, and the report to produce. Every number comes from a tool response, every finding carries a linked channel and title, a view count, an outlier ratio and a date.
  6. ## Install
  7. ```bash
  8. npx skills add TubeLabHQ/youtube-research-skills
  9. ```
  10. Works with Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, Windsurf, VS Code, Grok Build, and other agents that support the [Agent Skills spec](https://agentskills.io).
  11. Grok Build reads skills from `.grok/skills/` in a repo or `~/.grok/skills/`, so a copy of the `skills/` folder is enough:
  12. ```bash
  13. git clone https://github.com/TubeLabHQ/youtube-research-skills && cp -r youtube-research-skills/skills/* ~/.grok/skills/
  14. ```
  15. Claude Code can also install it as a plugin, which registers the MCP at the same time:
  16. ```bash
  17. claude plugin marketplace add TubeLabHQ/youtube-research-skills
  18. claude plugin install youtube-research@tubelab
  19. ```
  20. ## Setup
  21. Connect the TubeLab MCP once in your client: `https://public-api.tubelab.net/mcp`
  22. - Claude Code: the plugin does it, or `claude mcp add --transport http tubelab https://public-api.tubelab.net/mcp`. The first call opens OAuth.
  23. - Claude.ai and Claude Desktop: the [TubeLab connector](https://claude.ai/directory/tubelab), OAuth.
  24. - ChatGPT and Codex: the [TubeLab app](https://chatgpt.com/plugins/plugin_asdk_app_6ab3980fb1488191a9b26b3f59efd90b), OAuth. Codex supports ChatGPT apps, so no API key is needed there.
  25. - Grok Bot: ask a Bot to add the MCP server at the URL above (a Bot can add an MCP server that is not in its catalog by URL) and complete the authentication. Then hand the Bot this repo URL, or paste a `SKILL.md`, and ask it to save each one as a skill, starting with `tubelab-mcp`. Skills are shared by all your Bots; if a Bot cannot find one, open Connect apps and enable it under Private skills.
  26. - Grok Build (terminal): skills from the folders above; add the MCP from the `/mcps` modal.
  27. - Cursor and other IDE agents: a TubeLab API key as `Authorization: Bearer <key>` (Pro plan).
  28. - Claude.ai and Claude Desktop also take skills directly: zip a skill folder (`cd skills && zip -r niche-finder.zip niche-finder/`), upload it under **Customize > Skills**, turn it on, and Claude loads it when a request matches. Upload `tubelab-mcp` too; the workflow skills name it.
  29. - ChatGPT desktop app and Codex: skills live in the **Skills** sidebar and in `.agents/skills/` of a repo; Codex also installs them with `$skill-installer`.
  30. - Any chat client that cannot install skills: paste `skills/tubelab-mcp/SKILL.md` and then the skill you want into the chat. Every skill is one file, so this works as is.
  31. Setup guides per client: [tubelab.net/docs/api/mcp-server](https://tubelab.net/docs/api/mcp-server). The MCP is included from the Starter plan. Searches cost credits (channels 5, outliers 2, trending formats 1); channel, video, transcript and comment reads are free.
  32. ## Available Skills
  33. ### 🔭 Niche scout
  34. | Skill | Use it when you want to... | Output |
  35. |---|---|---|
  36. | [`niche-finder`](skills/niche-finder/) | Find breakout channels and cash cows with two preset searches, and turn them into new niche ideas | Ten ranked niche ideas, each with proof and a way to earn beyond AdSense |
  37. | [`niche-bending`](skills/niche-bending/) | Bend the proven format of one channel, or of channels that already earn, into a new market or language | Four to six ranked bends, each shown as the source niche and the bend with their thumbnails, with proof, who already does it, and first titles |
  38. | [`niche-watchlist`](skills/niche-watchlist/) | Watch a niche and get the delta since the last run, on a schedule | Dated digest of new and moving channels, each with a short analysis: worth studying or not, working topics, title formulas, best recent video. Config and state files |
  39. ### ⚖️ Validator
  40. | Skill | Use it when you want to... | Output |
  41. |---|---|---|
  42. | [`niche-validator`](skills/niche-validator/) | Decide go or no-go on one niche, or compare a shortlist of up to three, with the Niche Analyzer scores and the agent's own read next to them; a new idea is scored on the two niches it draws on | Market Size, Unsaturated and Profitable scores, formula and own read, verdict, channels breaking in, formats, gaps, bending ideas, entry plan; a comparison table first for a shortlist |
  43. ### 📈 Trend analyst
  44. | Skill | Use it when you want to... | Output |
  45. |---|---|---|
  46. | [`trend-report`](skills/trend-report/) | See what is working in a niche or for a channel, and why | Up to five winning videos with verbatim hooks and why they worked, patterns, ideas |
  47. ### 🎬 Script analyst
  48. | Skill | Use it when you want to... | Output |
  49. |---|---|---|
  50. | [`script-breakdown`](skills/script-breakdown/) | Break down a video's structure, hook and beats from its transcript. Given a niche or a channel, it picks the top videos itself | Hook verbatim, typed beats with linked timestamps, one-line layout, optional skeleton |
  51. ### 🎨 Packaging team
  52. | Skill | Use it when you want to... | Output |
  53. |---|---|---|
  54. | [`title-formulas`](skills/title-formulas/) | Get titles you can publish, built on formulas from the trending index, your niche and neighbouring niches. Pairs with `thumbnail-concepts`: titles first | About eight titles with proof, plus a table of their formulas with each one's source, proven or untested |
  55. | [`thumbnail-concepts`](skills/thumbnail-concepts/) | Get thumbnail concepts that join your video's new angle with the problem your viewers know. Pairs with `title-formulas`: the thumbnail for the chosen title | 50 or more thumbnails viewed, the patterns in the ones worth studying, three concepts that combine them, images or prompts |
  56. ### 💰 Monetization team
  57. | Skill | Use it when you want to... | Output |
  58. |---|---|---|
  59. | [`monetization-research`](skills/monetization-research/) | Find monetization gaps and what to sell for your channel (the creator's side), from how peers and same-audience channels earn | Table of monetization method gaps, best first, with linked peer offers; the brands that sponsor channels like yours; three products to test |
  60. | [`sponsorship-prospecting`](skills/sponsorship-prospecting/) | Find YouTube channels to sponsor for your product, matched to your buyer (the brand's side) | 10 to 15 scored prospects with audience, current sponsors and contact path; the best fits with an outreach angle and a cost band; a CSV |
  61. ### 🧭 Channel strategist
  62. | Skill | Use it when you want to... | Output |
  63. |---|---|---|
  64. | [`channel-analysis`](skills/channel-analysis/) | Analyze a channel: positioning, what works, what is holding it back | One-line diagnosis, what works, what holds it back, next 3 tests |
  65. | [`audit-channel-risk`](skills/audit-channel-risk/) | Check whether one or several channels are at risk of being demonetized or terminated, from their own videos and what happened to the channels most like them | A visual HTML page: a demonetization score and a termination score out of 100 as gauges, the signals behind each, a check against each section of YouTube's monetization guidelines, the similar channels that were terminated or lost AdSense, and the actions to reduce the risk, with the proof in rows that open; a comparison table first for several channels |
  66. | [`reverse-engineer-channel`](skills/reverse-engineer-channel/) | Reverse engineer a channel you admire into the formulas that work for it, from its whole video list | Its outliers, the formats that work with their topics, title formulas and thumbnail formulas, what doesn't work, hook formulas, script structure, how it earns, and five learnings to copy, each with the skill and prompt to run next |
  67. | [`competitor-research`](skills/competitor-research/) | Compare a channel against 12 to 15 real neighbours: peers, leaders and fast risers | How the set was built, comparison table, gaps, positioning |
  68. ### 💬 Audience researcher
  69. | Skill | Use it when you want to... | Output |
  70. |---|---|---|
  71. | [`comment-mining`](skills/comment-mining/) | Mine top comments for questions, objections, requests and audience language | Themes with verbatim quotes and likes, top comments, the audience's words, video ideas |
  72. ### 💡 Ideas
  73. | Skill | Use it when you want to... | Output |
  74. |---|---|---|
  75. | [`video-ideation`](skills/video-ideation/) | Get ranked video ideas for one channel from three sources: its own winning formats, its niche and related niches, plus same-audience channels on request | About ten ideas, each with a twist and linked proof, ranked by potential and fit |
  76. ### 🔌 Data layer
  77. | Skill | Use it when you want to... | Output |
  78. |---|---|---|
  79. | [`tubelab-mcp`](skills/tubelab-mcp/) | Drive the TubeLab tools well: costs, craft rules, quirks found in testing, and where the full API reference lives | Rules the other skills rely on; no artifact |
  80. Every skill is one `SKILL.md`. Real outputs for every skill are in [`examples/`](examples/). Ordered chains for common jobs are in [`playbooks/`](playbooks/), including [`youtube-agency.md`](playbooks/youtube-agency.md), which runs all six roles from a blank page to a first video and a monetization plan.
  81. ## The Agency (Claude Code agents)
  82. The plugin also ships six agents, one per role. Each one is a thin wrapper: it loads the skills for its role and returns the finished report.
  83. | Agent | What it does | Skills it loads |
  84. |---|---|---|
  85. | 🔭 `niche-scout` | Finds breakout channels and cash cows and turns them into ten niche ideas, bends a proven format into new markets, or watches a niche over time | `niche-finder`, `niche-bending`, `niche-watchlist` |
  86. | ⚖️ `validator` | Scores a niche, or a shortlist of up to three, and says go or no-go | `niche-validator` |
  87. | 📈 `trend-analyst` | Pulls what is winning right now, with the hooks word for word | `trend-report` |
  88. | 🎬 `script-analyst` | Breaks the top videos down beat by beat | `script-breakdown` |
  89. | 🎨 `packaging-team` | Writes titles, then thumbnails for the chosen title, from what is already getting clicked | `title-formulas`, `thumbnail-concepts` |
  90. | 💰 `monetization-team` | Shows what channels like yours sell and who sponsors them, or which channels a brand should sponsor | `monetization-research`, `sponsorship-prospecting` |
  91. In Claude Code, call one by name, for example `@agent-youtube-research:niche-scout find me faceless niche ideas`. Other clients do not load these agent files. They use the same skills directly, and the reports are the same.
  92. ## Example Prompts
  93. ```text
  94. Find me unsaturated faceless niche ideas in English with real money in them, ranked.
  95. ```
  96. ```text
  97. Bend @channel's best format into three new markets. Football first.
  98. ```
  99. ```text
  100. Run the whole agency for me: find niches, validate the top three, then give me the trend report, script breakdown, title, thumbnail and monetization plan for the winner.
  101. ```
  102. ```text
  103. Trend report for @mychannel this month. Hooks word for word, and ideas I can make.
  104. ```
  105. ```text
  106. Analyze @mychannel. Be direct. Why did the last six videos underperform?
  107. ```
  108. ```text
  109. Reverse engineer @channel. Which formats, titles, thumbnails and hooks work, and what can I copy?
  110. ```
  111. ```text
  112. Thumbnail concepts for "How I Would Build a $10M Service Business (If I Had to Start Over)". Here is the script.
  113. ```
  114. ```text
  115. Who could sponsor my channel? Find the brands already paying channels my size with my audience.
  116. ```
  117. ```text
  118. Who are my real competitors and how do I compare? youtube.com/@handle
  119. ```
  120. ```text
  121. We sell an invoicing app to US freelancers. Which YouTube channels should we sponsor?
  122. ```
  123. ## How the Skills Work Together
  124. ```text
  125. tubelab-mcp
  126. │
  127. ▼
  128. YouTube research agency
  129. ├─ 🔭 niche scout niche-finder · niche-bending · niche-watchlist
  130. ├─ ⚖️ validator niche-validator
  131. ├─ 📈 trend analyst trend-report
  132. ├─ 🎬 script analyst script-breakdown
  133. ├─ 🎨 packaging team title-formulas · thumbnail-concepts
  134. ├─ 💰 monetization team monetization-research · sponsorship-prospecting
  135. ├─ 🧭 channel strategist channel-analysis · audit-channel-risk · reverse-engineer-channel · competitor-research
  136. ├─ 💬 audience researcher comment-mining
  137. └─ 💡 ideas video-ideation
  138. ```
  139. The workflow skills lean on `tubelab-mcp` for tool costs, craft rules and quirks. The full parameter and REST reference lives at https://tubelab.net/docs/skill.md. Each workflow produces an artifact a creator can act on or a studio can hand to a client, not raw JSON.
  140. ## Design Principles
  141. 1. **Workflow-first, tool-second.** Users ask for an outcome, not a search.
  142. 2. **Outlier over raw views.** A 50K video on a 5K-average channel says more than 2M on a giant. Rank by ratio, show both.
  143. 3. **Recency first.** Every search sets a window. Widen one step at a time, and say so.
  144. 4. **Content Authenticity is never off.** General and above for niches, outliers, ideas and titles; High for anything thumbnail-related. Never relaxed to widen a thin result. The exceptions are `niche-watchlist`, whose saved search leaves it out, and `audit-channel-risk`, whose similar channel searches leave it out because the low-effort similar channels are the evidence.
  145. 5. **Cited outputs.** Every finding carries channel · title verbatim · views · ratio · date. Everything cited is linked with a URL from tool data: videos, channels, moments, brands and products. A sponsor that was only heard links to the video moment. Nothing invented.
  146. 6. **Estimates are estimates.** Revenue, RPM and audience are model outputs, shown as labelled bands.
  147. 7. **Credit-aware.** Searches cost credits, reads are free: go deep with free reads, never loop a paid search.
  148. 8. **Public data only.** Everything comes from public YouTube pages via TubeLab.
  149. 9. **Plain language.** Skills and reports use short, full sentences that anyone can follow on first read.
  150. ## Links
  151. - [TubeLab](https://tubelab.net)
  152. - [YouTube MCP](https://tubelab.net/youtube-mcp)
  153. - [MCP Documentation](https://tubelab.net/docs/api/mcp-server)
  154. - [TubeLab in the Claude directory](https://claude.ai/directory/tubelab) · [TubeLab app for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6ab3980fb1488191a9b26b3f59efd90b) · [Grok Bot apps and MCP servers](https://docs.x.ai/grok-bot/computer-and-apps), [Grok Bot skills](https://docs.x.ai/grok-bot/skills-routines-and-automations) and [Grok Build skills](https://docs.x.ai/build/features/skills-plugins-marketplaces)
  155. - [API Documentation](https://tubelab.net/docs/api/introduction)
  156. - [Pricing](https://tubelab.net/pricing)
  157. - [Contributing](CONTRIBUTING.md) · MIT license

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.