/ content-eval / README.md
README.md
 1  # Content Eval
 2  
 3  **Expert panel scoring for content ideation.** Generate, score, and schedule content ideas using a simulated 7-expert panel — so only your best ideas make it to production.
 4  
 5  ## What It Does
 6  
 7  1. **Gathers raw material** — Pulls from podcast transcripts, meeting notes, competitor analysis, and trending topics
 8  2. **Runs competitive scan** — Identifies outlier videos, topic patterns, content gaps across your competitor set
 9  3. **Generates ideas** — 20-30 ideas across long-form video, short-form video, and written formats, mapped to your messaging pillars
10  4. **Scores via expert panel** — Each idea is evaluated by 7 simulated experts (viral hooks, algorithm, brand, B2B buyer, differentiation, short-form adaptation, engagement)
11  5. **Ranks and schedules** — Passing ideas (85+ average) get sorted into a 4-week production calendar; everything else goes to the kill list with reasons
12  
13  ## Expert Panel
14  
15  | # | Expert | What They Score |
16  |---|--------|-----------------|
17  | 1 | Viral Hook Expert | Curiosity gap, scroll-stopping power, title strength |
18  | 2 | Algorithm Expert | CTR potential, watch time, search demand |
19  | 3 | Founder Brand Strategist | Pillar alignment, authenticity, personal experience |
20  | 4 | B2B Buyer Persona Expert | Would your target buyer watch this and want what you sell? |
21  | 5 | Content Differentiation Expert | Is anyone else making this? What's your unique angle? |
22  | 6 | Short-form Adaptation Expert | Can it clip into 3+ viral Shorts? Quotable moments? |
23  | 7 | Debate/Engagement Expert | Comments, shares, disagreements potential |
24  
25  Pass threshold: **85+ average across all 7 experts.** No grade inflation.
26  
27  ## Configuration
28  
29  Customize the skill by editing the reference files:
30  
31  | File | Purpose |
32  |------|---------|
33  | `references/pillars.md` | Your 3 messaging pillars (what your content ladder maps to) |
34  | `references/panel.md` | Expert panel definitions and scoring criteria |
35  | `references/competitors.md` | YouTube competitor channel sets for scanning |
36  | `references/voice-rules.md` | Your brand's content voice and style rules |
37  
38  ## Usage
39  
40  Works with Claude Code or any AI coding agent. Trigger with:
41  
42  - "content eval"
43  - "score content ideas"
44  - "weekly content menu"
45  - "what should I film"
46  - "rate these video ideas"
47  
48  You can also pass specific ideas to score directly:
49  > "Score these content ideas: [your list]"
50  
51  ## Output
52  
53  - Ranked list of passing ideas with full scoring breakdowns
54  - 4-week production schedule
55  - Kill list with reasons (so you learn what doesn't work)
56  - Competitive gaps found
57  - Optional: Google Doc export
58  
59  ## Requirements
60  
61  - Claude Code or any AI coding agent
62  - Optional: YouTube competitive analysis tool (for Step 2 competitor scanning)
63  - Optional: Google Workspace API access (for Doc export)
64  
65  ## Getting Started
66  
67  1. Copy this directory into your Claude Code skills folder
68  2. Edit `references/pillars.md` with your actual messaging pillars
69  3. Edit `references/competitors.md` with your competitor YouTube channels
70  4. Edit `references/voice-rules.md` with your brand voice rules
71  5. Run: "content eval" in your Claude Code session
72  
73  ## License
74  
75  MIT
76  
77  
78  ---
79  
80  <div align="center">
81  
82  **🧠 [Want these built and managed for you? →](https://singlebrain.com/?utm_source=github&utm_medium=skill_repo&utm_campaign=ai_marketing_skills)**
83  
84  *This is how we build agents at [Single Brain](https://singlebrain.com/?utm_source=github&utm_medium=skill_repo&utm_campaign=ai_marketing_skills) for our clients.*
85  
86  [Single Grain](https://www.singlegrain.com/?utm_source=github&utm_medium=skill_repo&utm_campaign=ai_marketing_skills) · our marketing agency
87  
88  📬 **[Level up your marketing with 14,000+ marketers and founders →](https://levelingup.beehiiv.com/subscribe)** *(free)*
89  
90  </div>