skills/platform-youtube/SKILL.md
Generates a complete YouTube channel strategy for East African businesses, covering channel setup and optimisation, video types, SEO content guidance, Shorts strategy, Community tab, a 30-day content plan, and KPI framework. Invoke when a client needs a YouTube presence plan, wants to build a searchable video library, or is asking how to use long-form and short-form video to generate leads and grow authority in the Uganda/EA market.
npx skillsauth add peterbamuhigire/social-media-skills platform-youtubeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
SKILL.md; do not skip mandatory steps or required fields.references/ directory is added later, treat its files as the deeper source material and keep this SKILL.md execution-focused.Before generating this strategy, collect the following from the client:
YouTube in Uganda and the wider East African market is used primarily for research, tutorials, and entertainment. It is the dominant platform for "how to" searches in English and Swahili. Data costs mean shorter videos (5–12 minutes) perform better than long-form for most topics — audiences will not sit through padding. Shorts (under 60 seconds) are growing rapidly and have their own independent algorithm.
The Hero/Hub/Hygiene content model (YouTube/Google) applies directly here: Hero content drives peak awareness (big campaigns, viral potential), Hub content keeps subscribers engaged (regular series), and Hygiene content answers evergreen search queries (tutorials, FAQs). Most East African business channels should prioritise Hygiene first — build the searchable library, then layer in Hub series once an audience forms.
EA keyword opportunity: Most EA businesses optimise only for English. Low-competition keyword gaps exist in Luganda, Swahili, and Kinyarwanda for the same topics. A bilingual title strategy ("How to Start a Business in Uganda / Okusooka Omugga mu Uganda") captures both audiences with one video.
Channel Art (Banner) Dimensions: 2560×1440px. Keep all key content within the safe zone of 1546×423px at centre — this is the area guaranteed to display on all screen sizes (desktop, mobile, TV). Include in the safe zone: channel name, tagline, posting schedule, and social handles.
Channel Icon 800×800px. Use the brand logo or founder photo. Consistency with other platform profile photos is important — YouTube appears in Google search results and a mismatch creates confusion.
About Section Maximum 1,000 characters. Lead with the value proposition: what does a viewer gain by subscribing? Include keywords naturally in the first two sentences — YouTube indexes this text for search. End with links: website, WhatsApp number, Instagram, and any other active channels.
Example structure: "[Channel name] helps [target audience] with [core topics]. Subscribe for [posting frequency] videos on [topic 1], [topic 2], and [topic 3]. Based in [city], serving [market]. New videos every [day(s)]. [Website] | WhatsApp: [number] | Instagram: @[handle]"
Channel Trailer 60–90 seconds. Structure: hook (who is this for and what will they learn?) / proof (credentials, examples, what they'll see) / CTA (subscribe and enable notifications). Always add captions. This video displays to non-subscribers on the channel homepage — it is the primary conversion tool for the channel.
Playlist Structure Organise into playlists from the first video. Playlists increase watch time by auto-playing related content. Recommended structure:
| Playlist | Purpose | |---|---| | [Industry] Tips | Educational how-to content | | [Product/Service] Guide | Product demonstrations and service explainers | | Client Stories | Testimonials and case studies | | Behind the Scenes | Business culture and process content | | FAQ | Answers to the most common questions | | Shorts | All Shorts content in one playlist |
End Screens Set up an end screen template before uploading the first video. Include: subscribe button + link to a recommended playlist + link to the most recent video. Apply this template to every video — end screens are shown in the final 20 seconds.
Cards Use info cards at relevant moments mid-video to link to related videos, playlists, or an external URL. Do not overuse — one or two cards per video is sufficient.
Six video types form the content architecture. Each serves a different purpose in the viewer's journey (Chaffey, 2024 — RACE framework: Reach, Act, Convert, Engage).
| Type | Purpose | Ideal length | Production notes | |---|---|---|---| | Tutorial / How-to | Solve a specific problem step-by-step. Generates search traffic from people actively looking for solutions. | 5–15 min | Screen recordings, close-up demonstrations, or talking head with b-roll. Chapters are essential. | | Vlog / Behind-the-scenes | Humanise the brand. Show the people, the process, the workspace. Builds emotional connection. | 3–8 min | Smartphone works well. Authenticity matters more than production quality. | | Product/service showcase | Demonstrate value, not just features. Show the product in use, the service in action, the result it produces. | 3–6 min | Good lighting essential. Show the before and after wherever possible. | | Client testimonial / case study | Social proof in video form. Structured as: client's situation before → what they did → result achieved. | 2–5 min | Film at the client's premises where possible. Real environment beats a studio for credibility. | | Q&A / FAQ | Answer the most common questions in one video. Draws search traffic and reduces repetitive inbound enquiries. | 5–12 min | Compile real questions from WhatsApp, comments, and DMs. Organise into chapters by question. | | Opinion / Commentary | Take a clear position on industry news, trends, or a common misconception. Establishes thought leadership. | 5–10 min | Requires genuine expertise and a defensible point of view. Vague takes do not perform. |
Note: this is content-level SEO guidance — it covers titles, descriptions, tags, and thumbnails. It is not a technical channel audit.
Title structure
Format: [Primary keyword] — [Benefit] | [Brand name]
Example: "How to Register a Business in Uganda — Step by Step | [Brand Name]"
Keep titles under 60 characters where possible — YouTube truncates longer titles in search results. Include the primary keyword as close to the start of the title as possible.
Description The first 150 characters are displayed in search results before the "read more" cutoff — make these count. Include the primary keyword in the first sentence. Full description structure:
Tags
5–10 tags per video. Include: the exact title phrase, 3–5 keyword variations, 2–3 broader category terms. Tags are lower priority than they were historically but remain worth completing. Competitor tag research: find the top 3 competitor videos on a given topic, right-click → View Page Source, search for "keywords" — this reveals their full tag list. Use the same top-performing tags with better content to rank alongside them and multiply Google search listings.
Closed captions Upload a manual transcript for every video. Closed captions are indexed by YouTube and Google — they function as retroactive SEO that can boost existing videos months after publication without re-uploading.
Thumbnail text guidance
Chapter markers Add timestamp chapters to every video over 5 minutes. Chapters serve two purposes: they help viewers navigate to the section they need (increasing satisfaction and completion), and YouTube indexes chapter titles as additional search signals.
Minimum for algorithm traction 1 video per week, consistently. Missing weeks in the early growth phase (first 6 months) significantly impairs channel growth. The YouTube algorithm rewards consistent supply — it learns when to expect new content from a channel and promotes it accordingly.
Ideal for growth 2 videos per week: one Tutorial/Educational video + one Lifestyle/Community/Behind-the-scenes video. Different video types reach different audience segments and search queries.
Best upload times for EA Tuesday and Thursday, 6–8pm EAT. Viewers are typically home from work or school. Upload 2–3 hours before the target viewing time to allow YouTube's processing and indexing to complete.
Upload workflow — private first Upload videos as Private to complete the title, description, tags, chapters, end screens, and cards before going live. Switch to Public (or use Scheduled) only when metadata is complete. Public videos with incomplete metadata miss the algorithm's initial indexing window — a gap that cannot be recovered.
Post-publish boost window YouTube gives every newly published video a 24–48 hour promotional window to test audience response. Stack all community promotion, email notifications, and social sharing in this window to maximise the algorithm signal from the first day.
Scheduling vs. live upload Use YouTube's scheduled upload feature to maintain consistency even when production is ahead of schedule. Pre-schedule the next 2 weeks of content whenever possible.
What Shorts are Shorts are vertical videos under 60 seconds with their own algorithm, their own subscriber shelf on the channel homepage, and their own audience discovery pathway. They grow independently from long-form videos and attract a different — typically younger — audience segment.
Content for Shorts
Shorts CTA Always include one of the following: "Full guide in the description", "Watch the full video — link below", or "Subscribe for the full tutorial." Shorts drive viewers to long-form content — this is the primary commercial use of Shorts for business channels.
Frequency 3–5 Shorts per week in addition to long-form uploads. Shorts require significantly less production time. Batch-produce Shorts from existing long-form footage to maintain frequency without additional filming.
Shorts and subscriber counting Subscribers gained through Shorts are counted the same as long-form subscribers for monetisation milestones. However, Shorts audiences do not always cross over to watch long-form content — monitor both separately.
Available once the channel reaches 500 subscribers. Activate immediately upon reaching this threshold.
Use cases
| Post type | Content | |---|---| | Poll | "Which video should I make next?" — list 3–4 options. Polls generate notifications to subscribers and drive channel visits. | | Behind-the-scenes image | Studio, workspace, or production photos. Humanises the channel between video uploads. | | Announcement | New video alerts, upcoming events, offers, or milestones. | | Re-share | Reshare a top-performing older video with new commentary: "This video from 6 months ago still gets [X] views per month. Here's why it still matters." | | Question | Ask the audience a question about their challenges, preferences, or experiences. Use responses as video topic research. |
Frequency 2–3 Community posts per week once the tab is active. Community posts appear in the subscriber's notification feed — use them to stay visible between video uploads.
4 long-form videos + 8 Shorts across 30 days. Adjust volume based on the client's stated production capacity.
| Week | # | Type | Title | 3-sentence video brief | Thumbnail concept | CTA | |---|---|---|---|---|---|---| | 1 | LF1 | Channel trailer / brand intro | "Welcome to [Channel Name] — What You'll Learn Here" | Founder introduces the channel, states who it is for, and lists 3 specific things viewers will learn from subscribing. Keep to 90 seconds. Show the workspace or product in the background. | Founder facing camera, bold text: "START HERE" | Subscribe + enable notifications | | 1 | S1 | Short — Quick tip | "[One specific tip] in 30 seconds" | The single most useful tip the client can share in under 30 seconds. No intro. Start with the tip. | Text overlay on action shot | "Full guide in description" | | 1 | S2 | Short — Product showcase | "This is [product] — and here's why it works" | Show the product in use. 20 seconds of demonstration, 10 seconds on the key benefit. No narration needed. | Close-up product shot + "Watch this" text | "Order via link in bio" | | 2 | LF2 | Tutorial / How-to | "How to [Solve Specific Problem] — [Number] Steps" | Step-by-step guide to the most common problem the target audience faces. Include chapters. Real demonstration, not theoretical. | Founder + text: "[Problem] — SOLVED" | Subscribe + link to related playlist | | 2 | S3 | Short — Behind-the-scenes | "A day in [Business Name] — 45 seconds" | Fast-cut behind-the-scenes of one operational moment. No narration required — text overlays and natural sound. | Action shot from behind-the-scenes | "Full vlog in description" | | 2 | S4 | Short — Tip repurposed from LF2 | "The one step most people skip in [process]" | Clip the single most surprising step from LF2 and reframe it as a standalone insight. | Text: "Don't skip this" + action shot | "Watch the full tutorial — link below" | | 3 | LF3 | Client testimonial / case study | "[Client Name]'s Story: From [Problem] to [Result]" | Interview or narrated case study. Opens with the problem, moves to the solution, ends with the measurable result. Real numbers or specific outcomes where the client consents. | Client face + result stat text overlay | Subscribe + DM or WhatsApp for enquiries | | 3 | S5 | Short — Surprising fact | "[Counterintuitive claim] — here's the proof" | One surprising industry fact, proven in under 45 seconds with visual evidence or data. | Bold text claim + reaction shot | "Full explanation — link in bio" | | 3 | S6 | Short — FAQ | "Everyone asks us: [question]" | Answer one of the most common enquiries in under 30 seconds. Conversational, direct. | Text: "Good question." + founder face | "More answers — subscribe" | | 4 | LF4 | Q&A / FAQ video | "Your Top [Number] Questions Answered — [Topic]" | Compile 5–8 real questions from WhatsApp, DMs, and comments. Chapter each question. Answer fully and honestly — include answers that acknowledge limitations. | Founder + text: "[Number] Questions" | Subscribe + "Send your question — link in bio" | | 4 | S7 | Short — Opinion / reaction | "Hot take on [industry topic]" | One clear, defensible position on a common industry assumption or practice. Under 30 seconds. No hedging. | Bold text claim + direct-to-camera shot | "Agree or disagree? Comment below" | | 4 | S8 | Short — Month milestone | "30 days on YouTube — here's what happened" | Honest reflection on the first month: views, subscribers, what performed, what did not. Invites the audience to come with the channel on the journey. | Stats screenshot + founder face | "Subscribe to follow along" |
Review monthly. Prioritise watch time and average view duration as the primary algorithm signals.
| KPI | Target / Benchmark | Why it matters | |---|---|---| | Views | Baseline Month 1; target 20% growth per month | Raw reach signal | | Watch time (hours) | Most important metric for the algorithm. Track total and per-video. | YouTube distributes content with high watch time to more viewers | | Average view duration | Target 40%+ of total video length | Low average duration signals weak content or misleading titles — YouTube demotes these videos | | Subscribers gained per month | Track monthly; acceleration after a specific video indicates the topic resonates | Audience-building signal | | CTR on impressions | Target 3–7% — this measures thumbnail + title performance | Low CTR means the title or thumbnail is not compelling enough to earn the click | | Top traffic sources | Break down: YouTube search vs. browse features vs. suggested vs. external | High search traffic validates SEO. High browse/suggested traffic validates algorithm favour. | | Top performing videos | Review monthly — identify the top 3 videos by watch time, not views. Make more content on those topics. | Reveals what the audience actually values | | Shorts views vs. long-form views | Track separately — Shorts and long-form have distinct algorithms | Helps allocate production effort correctly |
Understanding how YouTube distributes content is not optional — it determines the entire channel strategy.
How the algorithm works YouTube uses a dual neural network: the first network assesses a video's candidacy (is it relevant to this viewer?), the second ranks candidates against each other (which is best for this viewer right now?). The algorithm optimises for viewer satisfaction, not publisher satisfaction.
Traffic source breakdown for most channels:
This means: the goal is to become a suggested video, not just a search result. SEO is the entry point; watch time and engagement are what keep the algorithm distributing content.
The watch time hierarchy
Implication: a 15-minute video at 50% completion delivers more algorithm value than a 5-minute video at 80% completion. Longer videos that hold attention outperform shorter videos even when completion rate is lower. Playlists directly increase session time by auto-playing related content — this is the most underused lever for EA business channels.
Non-obvious algorithm rules
CTA placement for EA For data-cost-sensitive EA viewers, the primary CTA (subscribe, visit website, WhatsApp) must appear before the 3-minute mark. Viewers on metered data may close the video once their question is answered. Do not save the CTA only for the end screen. Use the reward-first CTA formula: deliver the most useful insight first, then ask for the subscription as a thank-you — not as a precondition.
B2B channels and monetisation caution Business and professional channels using YouTube as a credibility tool should consider carefully before joining the YouTube Partner Programme (YPP). YPP places competitor advertisements on your videos, which can drive prospects away at the moment of highest intent. Workshop recordings, webinars, and client case study videos are excellent for B2B authority — the channel does not need to be monetised to be commercially valuable.
Use with the blog-writer skill to generate client-attracting content for the agency's own channels or for clients in the content creation space.
| Title | Target audience | |---|---| | Why Your YouTube Videos Get No Views (And It's Not What You Think) | SME owners who have tried YouTube and failed | | The YouTube Algorithm Explained in Plain English for East African Businesses | Business owners new to video marketing | | How to Rank YouTube Videos in Uganda: A Step-by-Step SEO Guide | Local businesses targeting Ugandan search traffic | | The 7 YouTube Mistakes That Are Costing You Subscribers | Channel owners with stalled growth | | YouTube vs TikTok for East African Business: Which Platform Should You Choose? | Businesses deciding where to invest video effort | | How to Start a YouTube Channel for Your Business With a Smartphone | Budget-conscious SMEs hesitant to start | | The Exact Upload Schedule That Helped Our Clients Grow Their YouTube Channels | Aspiring video marketers looking for a plan | | How to Get More Watch Time on YouTube: The Metric That Actually Matters | Intermediate creators who understand basic SEO | | YouTube Shorts for Business: The Fast Track to Your First 1,000 Subscribers | New channels wanting quick growth | | How to Use YouTube to Generate Leads for Your Business Without Running Ads | Business owners sceptical of paid advertising |
Output from this skill meets the standard when it:
[Primary keyword] — [Benefit] | [Brand] formattools
Generates a foundational social media training guide for clients and their teams who are completely new to social media marketing, or who have been posting without any strategic understanding. Invoke when the user says "write a social media basics guide", "create a beginner training document", "the client doesn't understand social media", "start-here training", or when a client needs to understand social media before any strategy or content work begins. Distinct from training-client-team (operational handover of an existing strategy) and training-diy-content (content creation for self-managing clients). This skill covers what social media is, how it works, and how to approach it intelligently — the conceptual foundation that makes all downstream strategy work land.
tools
Generates a practical smartphone video production training guide for East African clients and content teams. Covers shooting, audio, lighting, framing, editing, and platform-specific formats using only a smartphone — no professional equipment required. Invoke this skill when a client or their team needs to produce their own social video content and requires a hands-on, jargon-free training document tailored to EA field conditions.
tools
Generates a complete DIY content creation handbook for clients who want to manage some or all of their own content after the initial strategy engagement. Invoke when the user says "write a DIY content guide", "create a self-managed content handbook", "the client wants to manage their own content", or when a handover guide is needed at the end of a strategy engagement. Output is a self-contained reference document — not a training presentation — that the client keeps and uses independently.
tools
Generates a complete 2-hour in-person training workbook for a client's internal team — employees who will assist with content creation or community management. Invoke when the user says "create a team training guide", "write a staff training workbook", "onboard our internal team on social media", or needs a printable workshop document for client employees. Output is a structured, print-ready workbook — not a presentation deck.