Skip to content
Back to search

video-report-skill

SkillWorks with Claude CodeGitHub

A read-only Claude Code skill that turns one YouTube video's analytics into a card with 1-3 fixes for your next video (via vidIQ).

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yasintpl--video-report-skill/badge.svg)](/listings/yasintpl--video-report-skill)

HTML

<a href="/listings/yasintpl--video-report-skill"><img src="/api/listings/yasintpl--video-report-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

1. Copy the folder `.claude/skills/video-report/` from this repo into your project's `.claude/skills/` folder. Or copy it into `~/.claude/skills/` to use it in every project. 2. Add the vidIQ connector to Claude Code and sign in with your channel's Google account. 3. Open `config.json` in the skill folder: - `compare_since`: the first publish date (`YYYY-MM-DD`) of your current video format. Videos from that date on are the comparison set. Leave it `null` and the skill proposes a set and asks you to confirm. - `output_dir`: where the cards go, relative to the folder you run Claude Code in. Default: `video-reports`. - `max_credits_per_card` and `min_balance`: both 25 by default.

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.

README.md · README · 103 lines
  1. # video-report — a Claude Code skill
  2. A Claude Code skill that reads one published YouTube video and tells you what to fix in the next one.
  3. It only reads. It never changes anything on YouTube.
  4. ## What it does
  5. One video in, one card out.
  6. You type `/video-report latest`. The skill pulls the video's numbers through vidIQ and writes a Markdown card:
  7. - the numbers, next to your other comparable videos
  8. - the retention curve in seconds: where people leave
  9. - where your viewers came from
  10. - thumbnail click rate and A/B test status (if the vidIQ extension is connected)
  11. - at most 3 findings and 1–3 fixes for your next video
  12. - what to check next time, and how many credits the card cost
  13. An example card summary (**made-up example numbers, not real data**):
  14. ```
  15. Video card · My example video · 7d
  16. Views 1,234 [data] · comparison median 1,000
  17. Still watching at 30 s: 55 % [data]
  18. Half the viewers gone by second 42 [data]
  19. Relative retention in the first 30 s: 0.35 (below the 0.5 median) [data]
  20. Finding: the opening loses people faster than similar videos [read]
  21. Fix: show the result by second 5, no setup sentence first [read]
  22. Credits: 20 of 25
  23. ```
  24. ## What it never does
  25. - It only reads. It never writes to YouTube: no video, title, thumbnail, comment or A/B test changes.
  26. - It never invents numbers. Missing data says "no data", never 0.
  27. - It never spends more than 25 vidIQ credits on one card.
  28. - It only calls the vidIQ tools on its allowlist (listed in `SKILL.md`). No generation tools, no plan or billing tools.
  29. ## Requirements
  30. - **Claude Code.** This is paid: you need a Claude Pro or Max plan, or API usage.
  31. - **A free vidIQ account**, with the vidIQ connector added to Claude Code and signed in with the Google account of your channel.
  32. - **The vidIQ Chrome extension** (optional). Only the thumbnail click rate and A/B test rows need it.
  33. Without it, those rows say "no data" and the rest of the card still works.
  34. - **You own or manage the channel.** YouTube only shares these analytics with the channel's owner or managers.
  35. ## Costs
  36. - The skill is free.
  37. - The vidIQ Free plan gives a monthly credit allowance. Most data calls cost 5 credits each.
  38. One card spends at most 25 credits. At the time of writing, the Free plan had 150 credits a month, so about 6 cards.
  39. - Nothing is bought automatically. If your credits run out, the skill stops and tells you.
  40. - vidIQ can change its prices, credit costs or MCP access at any time. Check vidIQ's current plans before you rely on this.
  41. ## Install
  42. 1. Copy the folder `.claude/skills/video-report/` from this repo into your project's `.claude/skills/` folder.
  43. Or copy it into `~/.claude/skills/` to use it in every project.
  44. 2. Add the vidIQ connector to Claude Code and sign in with your channel's Google account.
  45. 3. Open `config.json` in the skill folder:
  46. - `compare_since`: the first publish date (`YYYY-MM-DD`) of your current video format. Videos from that date on are
  47. the comparison set. Leave it `null` and the skill proposes a set and asks you to confirm.
  48. - `output_dir`: where the cards go, relative to the folder you run Claude Code in. Default: `video-reports`.
  49. - `max_credits_per_card` and `min_balance`: both 25 by default.
  50. ## Use
  51. ```
  52. /video-report latest
  53. /video-report <video ID or YouTube URL>
  54. ```
  55. You can also just ask: "how did my last video do?"
  56. The skill picks a checkpoint from the video's age:
  57. - Under 2 days old: it stops. YouTube Studio data is not ready yet.
  58. - 2 to 6 days old: a **48h** card.
  59. - 7 days or older: a **7d** card.
  60. The window is always the publish day to yesterday.
  61. Cards are saved as `<output_dir>/<date>-<videoID>-<48h|7d>.md`.
  62. A second card for the same video reads the first card for free, so it has room for the A/B test.
  63. ## Reading the card
  64. - **[data]** is a number from YouTube, or simple arithmetic on one. **[read]** is the skill's interpretation.
  65. - **Relative retention:** YouTube compares your curve with videos of similar length.
  66. 0.5 is the median. Below 0.5, people leave faster than on similar videos. Above 0.5, they stay longer.
  67. - **"no data" is not 0.** 0 means YouTube measured nothing happening. "no data" means the number could not be read.
  68. ## Troubleshooting
  69. - **`channel_mismatch`:** YouTube Studio in your browser is open on a different account or channel.
  70. Switch Studio to the channel's account, then run the card again.
  71. - **Empty retention curve:** YouTube Studio data arrives 2–3 days late. The skill stops after one call. Try again later.
  72. - **`extension_not_connected`:** the vidIQ Chrome extension is not installed or not signed in.
  73. The skill shows how to connect it. The rest of the card still works.
  74. - **Low balance:** with fewer than 25 credits, the skill stops before spending anything and tells you when credits reset.
  75. ## License
  76. MIT. See `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

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