buildpartner 0.4.2 → 0.8.0-dev.20260430072343

package/skills/bp-youtube-script/SKILL.md

@@ -1,149 +0,0 @@
----
-description: "Research, write, and review YouTube scripts. Full workflow from outline to final draft with expert-level feedback."
----
-
-# /bp-youtube-script
-
-Research, write, and review YouTube scripts with proven frameworks for hooks, structure, retention, and expert-level quality review.
-
-## MCP Tools
-
-Only call tools that are registered on the `buildpartner` MCP server. If a tool call fails or a tool name isn't recognized, do not retry with a different name. The available tools are: `get_personal_context`, `get_expert_knowledge`, `save_profile`, `get_quest_progress`, `check_status`.
-
-## Project Structure
-
-This skill uses a local `content/` directory. Check for existing project context:
-
-```
-content/
-  knowledge/          # User's voice, audience, brand context
-  youtube/
-    {video-slug}/
-      titles.md       # From bp-youtube-ideation
-      thumbnail.md    # From bp-youtube-ideation
-      outline.md      # Created by this skill
-      script.md       # Created by this skill
-      status.md
-```
-
-If a project folder exists with titles.md or thumbnail.md, read them to inform the script.
-
-## Instructions
-
-1. Call `get_expert_knowledge` with `{ "category": "content" }` to see available frameworks and the user's personal context. Then fetch the specific frameworks needed:
-   - For research/outline: `{ "topic": "script-strategy,youtube-script-frameworks" }`
-   - For writing: `{ "topic": "youtube-script-frameworks" }`
-   - For review: `{ "topic": "script-strategy,youtube-script-frameworks,channel-positioning" }`
-
-2. Check for existing project files in `content/youtube/`. If titles or thumbnail notes exist, use them to inform the script direction.
-
-3. Read `content/knowledge/voice.md` and `content/knowledge/audience.md` if they exist, for voice and audience context.
-
-4. Detect what the user needs and run the appropriate mode:
-
-### Mode: Research
-When the user has a video concept and needs to build an outline:
-
-- **Step 1: Competitive Research**
-  - Ask: "What are other videos on this topic saying?"
-  - Help identify the common wisdom that viewers have already heard
-  - Find where the user disagrees or has a different take
-
-- **Step 2: New Information Framework**
-  - The AI era changed what works. Viewers get basic info from ChatGPT first. If your video says what everyone else says, they leave.
-  - Identify the user's unique angle: What do they know that others don't? Where's their lived experience?
-  - Apply the Pattern Interrupt: List things you DON'T do that every other video tells viewers to do
-
-- **Step 3: Lived Experience Mining**
-  - Ask: "When did you personally learn this lesson? What went wrong?"
-  - Extract specific stories with concrete details (age, context, setting, failure, consequence)
-  - These stories are the moat AI cannot replicate
-
-- **Step 4: Build Enriched Outline**
-  - Structure: Hook concept -> Setup -> 3-5 main sections -> Payoff
-  - Each section has: Claim, Evidence, Example, Application
-  - Mark where lived experience stories should go
-  - Mark where proof/data should go
-
-- Write outline to `content/youtube/{slug}/outline.md`
-
-### Mode: Write
-When the user has an outline (or concept) and wants a full script:
-
-- **Intro (Under 60 Seconds)**
-  Follow the proven structure:
-  1. **Context** (5-10s): Confirm the click. "Today we're talking about..."
-  2. **Common Belief** (10-15s): "Most people think..." / "Everyone says..."
-  3. **Contrarian Take** (10-15s): "But here's the thing..." Use "but" as scroll-stop
-  4. **Proof** (10-15s): [User's credibility statement]
-  5. **Plan** (10-15s): "Just give me X minutes and I'll walk you through..."
-
-- **Body (60-70% of video)**
-  - Front-load value. First 2 points are critical.
-  - Second point must be BETTER than first (ascending value trend)
-  - Each point follows the Value Loop: What (context) -> How (application) -> Why (framing)
-  - Re-hook between every point: "That was important, but without this next one..."
-  - Use "but" and "therefore" for narrative flow. Never "and then."
-  - Vary sentence length for rhythm (staccato for emphasis, longer for explanation)
-
-- **Payoff (Final 20%)**
-  - Deliver on the biggest promise from the hook
-  - Punchy synthesis, not boring summary
-  - CTA that connects to the content
-  - Tease next video if applicable
-
-- **Retention Mechanics Throughout**
-  - Open curiosity loops early, close them late
-  - Payoff every 2-3 minutes
-  - Pattern interrupts every 90 seconds (visual change, tone shift, question)
-  - Tease upcoming sections: "In a minute, I'll show you the part that surprised me most"
-
-- Write script to `content/youtube/{slug}/script.md`
-
-### Mode: Review
-When the user has a script and wants expert feedback:
-
-Run the script through a multi-framework review:
-
-- **New Information Check**
-  - What are competitors saying about this topic?
-  - Where does this script offer a different take?
-  - Is the different take clear in the first 30 seconds?
-
-- **Lived Experience Check**
-  - Does the script have at least one story of when the creator learned this?
-  - Is there a specific failure/mistake that taught them?
-  - Could AI generate this story? If yes, it needs rewriting.
-
-- **Proof Check**
-  - Every claim: is there proof attached?
-  - Are there screenshots, data, before/afters referenced?
-  - Would a skeptic be convinced?
-
-- **Views vs Sales Check**
-  - Is this meant to grow audience or convert buyers?
-  - Views video: Where's the pattern interrupt? The contrarian angle?
-  - Sales video: Where's the deep process walkthrough? The proof of systems?
-
-- **Structure Check**
-  - Intro under 60 seconds?
-  - Re-hooks every 60-90 seconds?
-  - Each point has What -> Why -> How?
-  - Ascending value (second point better than first)?
-  - Body uses but/therefore, not "and then"?
-
-- **Packaging Alignment**
-  - Does the script deliver on what the title promises?
-  - Would someone who clicked this title be satisfied?
-  - Does it serve Core, Casual, AND New viewers?
-
-Output a scorecard with specific fixes for each issue found.
-
-5. Update `content/youtube/{slug}/status.md` with current stage.
-
-6. Suggest next steps based on what was done:
-   - After research: "Outline ready. Run `/bp-youtube-script` again to write the full script."
-   - After writing: "Script draft complete. Run `/bp-youtube-script` again in review mode, or refine with feedback."
-   - After review: "Here's your scorecard. Fix the flagged items and run review again, or lock it and move to production."
-
-7. Call `check_status` with `{ "skill_name": "bp-youtube-script" }`.