Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment.

MITAuto-check passedAgent Workflows

Install Yt Brief

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill yt-brief -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace yt-brief --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/yt-brief .claude/skills/yt-brief && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yt-brief
GitHub stars
2.8k
Token cost
~1.5k tokens
SKILL.md length
750 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment.

  • Works in 5 steps: Research the Topic → Define the Video Identity → Write the Brief → …
  • The user says create a brief
  • SKILL.md covers Before You Start, The Briefing Process, Key Principles and Overview, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yt Brief is an agent skill from jeremylongshore/tons-of-skills-marketplace. Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment. Use this skill whenever the user says "create a brief", "brief this idea", "develop this idea", "write a video brief", "production brief", or has selected a video idea from ideation and wants to define the angle and structure before packaging and outlining. Use when working with yt brief. Trigger with 'yt', 'brief'.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

It sits in Agent Workflows, covering Brainstorming, Positioning and messaging and Video scripts and shorts. It works with YouTube. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • The user says create a brief
  • Brief this idea
  • Develop this idea
  • Write a video brief

Example prompts

  • “create a brief”
  • “brief this idea”
  • “develop this idea”
  • “/yt-brief”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): WebSearch, Read, Write

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Research the Topic
  2. Define the Video Identity
  3. Write the Brief
  4. Review with User
  5. Save the Brief

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • WebSearch
    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Yt Brief loads about 1.5k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 750 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~116
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 750 words, ~1,486 tokens.

Download SKILL.mdSave it as .claude/skills/yt-brief/SKILL.md (or your agent's skills folder).
name
yt-brief
description
Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment. Use this skill whenever the user says "create a brief", "brief this idea", "develop this idea", "write a video brief", "production brief", or has selected a video idea from ideation and wants to define the angle and structure before packaging and outlining. Use when working with yt brief. Trigger with 'yt', 'brief'.
allowed-tools
WebSearch, Read, Write
compatibility
Designed for Claude Code
version
1.10.0
author
Claude Code Plugins <jeremy@intentsolutions.io>
license
MIT
tags
productivity, yt-brief

YouTube Brief

You are creating a structured production brief for a YouTube video. The brief is the bridge between an idea and a filmable video - it defines what the video IS.

Before You Start

You need from the user:

  1. The video idea - Either a validated idea from /yt-ideate (with title, tier, type, angle) or a raw idea the user wants to develop
  2. Any constraints - Timeline, specific features to include/exclude, target length, team capacity

If the user is coming from the ideation flow, load validated_ideas.json for the full context on the selected idea.

The Briefing Process

Step 1: Research the Topic

Before writing the brief, understand the topic deeply:

  • What does this feature/tool actually do? (Use WebSearch if needed)
  • What are the common pain points or confusion points?
  • What existing content exists? What angle would differentiate this video?
  • What's the practical value for the target audience?
Step 2: Define the Video Identity

Work with the user to lock in:

Content Type & Tier:

  • Confirm which tier and category this falls under
  • This determines the format, length, and production approach

The Angle:

  • What's the unique take? Why would someone click THIS video over alternatives?
  • The angle should be specific and defensible, not generic
  • Good: "How to use MCP integrations to automate your marketing reporting without any code"
  • Bad: "MCP tutorial"

Target Audience Segment:

  • Who is the primary viewer?
  • What's their starting knowledge level for this topic?
Step 3: Write the Brief

The brief must include:

  1. Title (working) - Will be refined in packaging, but needs a clear working title
  2. Content tier & type - e.g., Tier 1 / Feature Tutorial
  3. The angle - 1-2 sentences: what makes this video unique
  4. Target audience - Who exactly is this for, and what do they already know
  5. Key points - 5-8 main things the viewer will learn or see demonstrated
  6. Value proposition - After watching, the viewer will be able to [specific outcome]
  7. CTA asset - What free asset can be given away? (template, skill, workflow, plugin)
  8. Prerequisites - What does the viewer need to have set up before watching?
  9. Demo requirements - What tools, accounts, or setups are needed for filming?
  10. Estimated length - Target duration based on content type
  11. Urgency/timing - Is this time-sensitive (update video) or evergreen?
Step 4: Review with User

Present the complete brief and ask:

"Here's the brief for '[title]'. Review it:"

[Full brief in clean markdown format]

"What would you like to adjust?"

  • Approve - move to packaging
  • Adjust the angle
  • Add/remove key points
  • Change the CTA asset
  • Change the target audience
  • Start over with a different approach

This is a mandatory human checkpoint. Do NOT proceed without approval.

Step 5: Save the Brief

Save the approved brief as video-brief-yt-brief.md in the working directory.

Show full SKILL.md (302 more words)Show less

Key Principles

  • The angle is everything. A brief without a clear, differentiated angle will produce a generic video. Push the user to be specific.
  • Practical value first. Every key point should contribute to the viewer being able to DO something. No filler sections.
  • CTA integration. The CTA asset should feel like a natural extension of the video content, not a bolted-on pitch.
  • Honest about scope. If a topic is too big for one video, say so and suggest splitting it. Don't try to cram a Full Tutorial into a Feature Tutorial.
  • Team-ready. The brief should contain enough detail that a team member could start demo prep without asking follow-up questions.

Overview

Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment.

Prerequisites

  • Access to the Yt Brief environment or API
  • Required CLI tools installed and authenticated
  • Familiarity with Yt Brief concepts and terminology

Instructions

  1. Assess the current state of the Yt Brief configuration
  2. Identify the specific requirements and constraints
  3. Apply the recommended patterns from this skill
  4. Validate the changes against expected behavior
  5. Document the configuration for team reference

Output

  • Configuration files or code changes applied to the project
  • Validation report confirming correct implementation
  • Summary of changes made and their rationale

Error Handling

ErrorCauseResolution
Authentication failureInvalid or expired credentialsRefresh tokens or re-authenticate with Yt Brief
Configuration conflictIncompatible settings detectedReview and resolve conflicting parameters
Resource not foundReferenced resource missingVerify resource exists and permissions are correct

Examples

Basic usage: Apply yt brief to a standard project setup with default configuration options.

Advanced scenario: Customize yt brief for production environments with multiple constraints and team-specific requirements.

Resources

  • Official Yt Brief documentation
  • Community best practices and patterns
  • Related skills in this plugin pack

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/.curated/yt-brief of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287

Compare with similar skills

Yt Brief next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yt Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yt Brief this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.5kAutomated safety check: PassMIT
Youtube Strategyericrisco/rsc-harness180—~3.1kAutomated safety check: PassMIT
Title CraftTheCraigHewitt/skills159—~2.1kAutomated safety check: PassMIT
Shortform Ideationericrisco/rsc-harness180—~3.1kAutomated safety check: PassMIT
Brand Ideationrampstackco/claude-skills945—~2.4kAutomated safety check: PassMIT
Video Copy AnalyzerALBEDO-TABAI/video-copy-analyzer209—~1.9kAutomated safety check: PassMIT

Similar skills

  • Youtube Strategy

    ericrisco/rsc-harness

    A skill your agent uses when a YouTube channel needs a system-level decision — positioning and niche, upload cadence, how videos chain into playlists and series, end-screen routing, or a…

    180 GitHub stars~3.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Title Craft

    TheCraigHewitt/skills

    When the user wants to write YouTube video titles, optimize existing titles, A/B test title variants, or improve click-through rate.

    159 GitHub stars~2.1k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Shortform Ideation

    ericrisco/rsc-harness

    A skill your agent uses when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so…

    180 GitHub stars~3.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Brand Ideation

    rampstackco/claude-skills

    Generate, evaluate, and narrow brand concepts during early ideation including positioning territories, naming candidates, mood directions, and narrative angles.

    945 GitHub stars~2.4k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Video Copy Analyzer

    ALBEDO-TABAI/video-copy-analyzer

    视频文案分析一站式工具。下载在线视频(B站/YouTube/抖音等)、使用FunASR进行高速中文语音转录、 自动校正文稿、并进行三维度综合分析(TextContent/Viral/Brainstorming)。

    209 GitHub stars~1.9k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Viral Short Form Ideas

    vyralcontent/content-skills

    Generate short-form video ideas at volume and stop the blank-page problem for good.

    134 GitHub starsUsed in 1 repo~2.9k tokens
    Media & CreativeAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Questions about Yt Brief

What does Yt Brief do?

Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment. Yt Brief is an agent skill from jeremylongshore/tons-of-skills-marketplace. Refine a YouTube video idea into a structured production brief with angle, key points, value proposition, CTA asset, and audience segment.

When should I use Yt Brief?

Yt Brief fits situations like: the user says create a brief; brief this idea; develop this idea; write a video brief.

How do I install Yt Brief in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill yt-brief -a claude-code`. Or copy the skill folder (skills/.curated/yt-brief in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/yt-brief in your project. Claude Code loads it when a task matches its description.

How do I install Yt Brief in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill yt-brief -a codex`. Or copy the skill folder (skills/.curated/yt-brief in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/yt-brief in your project. Codex loads it when a task matches its description.

Can I use Yt Brief in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill yt-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yt-brief, .gemini/skills/yt-brief, .github/skills/yt-brief and .opencode/skills/yt-brief in your project.

What does Yt Brief need to run?

SKILL.md names no scripts, command-line tools or credentials: Yt Brief is instructions for the agent only. Its frontmatter pre-approves these tools: WebSearch, Read, Write. Compatibility (from SKILL.md): Designed for Claude Code.

Does Yt Brief access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yt Brief safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Yt Brief use?

Yt Brief is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yt Brief use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yt Brief?

Skills that share tags, products or a category with Yt Brief: Youtube Strategy (ericrisco/rsc-harness, 180 stars), Title Craft (TheCraigHewitt/skills, 159 stars), Shortform Ideation (ericrisco/rsc-harness, 180 stars) and Brand Ideation (rampstackco/claude-skills, 945 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yt Brief?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.