Create your Persona
A Persona is the foundation of everything in ScriptHooks. It defines who you are as a creator, what your brand sounds like, and who you're making content for. Every tool in the platform pulls from your active Persona to tailor its output.
Navigate to Personas from the left sidebar and click "New Persona." Fill in your brand details:
- Name and niche — give it a clear label and specify your content niche (e.g., "AI Agents & Content Automation")
- Voice and tone — define how your brand speaks: conversational, authoritative, educational, irreverent, etc.
- Target audience — describe who you're creating content for, including their pain points and goals
- Brand guides — upload or link to any existing brand guidelines, style docs, or reference material
The more detail you provide in your Persona, the better every downstream generation becomes. If your audience uses specific jargon (like "n8n workflows" instead of "automations"), include that in your voice settings.
Add your channels
Once your Persona is created, add YouTube channels as data sources. ScriptHooks supports two methods:
- Prospect channel (no OAuth needed) — paste any public YouTube URL (e.g.,
youtube.com/@YourChannel). ScriptHooks uses AI to analyze the channel's content pillars, hook patterns, posting cadence, growth signals, and audience indicators. This is the fastest way to get started. - Connected channel (OAuth) — connect your own YouTube account for access to private analytics like watch time, retention curves, and real-time subscriber data. This is optional but gives the deepest insights.
You can add multiple channels to a single Persona. Each channel's data feeds into your Brand Brain, which tracks your overall content health score and niche positioning.
Building content for a client? Create a Persona for their brand, paste their public YouTube URL as a prospect channel, and ScriptHooks will analyze their existing content without needing their login credentials. This is how agencies scale content strategy across multiple clients.
Add your competitors
Competitors give the strategy engine context about your landscape. When ScriptHooks knows who else is creating content in your space, it can identify gaps, suggest differentiation angles, and calibrate your posting strategy.
There are two ways to add competitors:
- Auto-discover — ask the AI agent "Find my competitors" and it will search YouTube and AI recommendations to surface channels in your niche. You'll see their subscriber counts, video counts, and a relevance explanation. Add the ones that match.
- Manual add — in the Brand Brain panel under Competitive Landscape, click "+ Add Competitor" and paste a YouTube channel URL. Useful when you already know who your competitors are or when a new player enters your space.
Adding at least two competitors unlocks the full health score bonus and gives the strategy engine enough data for meaningful competitive positioning.
Generate your content strategy
With your Persona, channels, and competitors in place, ask the AI agent to "Create a content calendar" or "Build me a content strategy." The strategy engine pulls from everything you've set up:
- Your Persona's voice, tone, and target audience
- Prospect channel analysis: content pillars, top-performing topics, hook patterns
- Competitor landscape: who they are, what they cover, where the gaps are
- Niche trends and market signals
The output is a multi-week content calendar with specific video topics, recommended angles, and strategic rationale for each piece. You can export it as a PDF or use it directly to drive script generation.
Regenerating your strategy after adding new data (a new prospect channel, more competitors) will produce an updated calendar that reflects the latest intelligence. The strategy engine always uses the most current data available.
Generate scripts and hooks
Now take the topics from your content calendar and turn them into production-ready scripts. Ask the AI agent to generate hooks or scripts for any topic, and it will write them in your Persona's voice using hook patterns proven to work in your niche.
- Hook Generator — produces multiple hook variations for a topic, optimized for retention and click-through
- Script Generator — writes full video scripts with your chosen duration, hook style, and voice tone
Every generation is informed by your Persona data. The same topic will produce completely different content for different Personas, because the voice, audience, and competitive context are all different.
Iterate and refine
The workflow is designed to be cyclical. As you publish content and see what performs, feed that data back into ScriptHooks:
- Grade your videos — paste a YouTube URL into the Video Grader to get AI feedback on hook strength, pacing, and retention signals
- Update your Persona — refine your voice settings based on what resonates with your audience
- Refresh competitors — add new competitors or remove ones that have pivoted away from your niche
- Regenerate your strategy — each generation incorporates the latest data for continuously improving recommendations
Frequently Asked Questions
No. You can add any public YouTube channel as a prospect channel by pasting the URL. ScriptHooks analyzes the channel's public data without requiring OAuth access. OAuth is only needed if you want to track your own channel's private analytics.
Yes. This is ideal for agencies. Create a persona for your client, paste their public YouTube URL as a prospect channel, add their competitors, and generate a content calendar tailored to their niche and audience.
Adding at least 2 competitors unlocks the full 15-point health score bonus and gives the strategy engine enough data for competitive positioning and gap analysis. There is no hard limit, but 3 to 5 competitors provides the best signal.
Each time you generate a content strategy, it pulls the latest data from your persona, channels, and competitors. Adding a new prospect channel or competitor and regenerating will produce an updated calendar.