@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/youtube-thumbnail-design/data/styles.csv

@@ -1,18 +0,0 @@
-No,Style Name,Category,Keywords,Background,Typography,Key Elements,Best For,Avoid For,Complexity,CTR Impact
-1,Facecam,People,"face, expression, emotion, reaction, vlog, personality",Solid color or gradient,Bold sans-serif 80px+,"Expressive face closeup, 1-3 words, solid/gradient bg",Vlogs reactions reviews commentary,Faceless channels product-only content,Low,High
-2,Before-After,Transformation,"split, comparison, result, transformation, glow-up",Split layout two halves,Bold with arrow indicator,"Two contrasting images, arrow or divider, transformation text",Tutorials makeovers fitness weight-loss,Abstract topics opinion pieces,Medium,High
-3,Listicle,Numbered,"top, best, list, ranking, number, countdown",Clean with number overlay,Extra-bold number 200px+,"Large number as hero element, small preview grid",Top-N videos rankings compilations,Single-topic deep dives,Low,High
-4,Tutorial,Educational,"how-to, step, guide, learn, teach, DIY",Clean light or dark,Clear readable sans-serif,"Step preview screenshot, tool/subject, clean layout",How-to educational DIY guides,Entertainment vlogs gaming,Medium,Medium
-5,Reaction,Commentary,"surprised, shocked, OMG, react, response",Subject image or screenshot,Bold caps with stroke,"Exaggerated facial expression, subject being reacted to",Commentary reactions drama news,Professional educational,Low,High
-6,Cinematic,Visual,"film, movie, travel, documentary, epic, mood",Full-bleed photo cinematic crop,Minimal or none,"Widescreen letterbox, moody lighting, atmospheric",Travel documentary film storytelling,Quick tips listicles,High,Medium
-7,Bold Text,Typography,"text, statement, opinion, headline, news",Solid dark or bright,Oversized fills 60% of frame,"Text as primary element, minimal imagery",Opinion hot-takes news announcements,Visual tutorials product reviews,Low,Medium
-8,Mystery,Curiosity,"blur, hidden, question, secret, reveal, shocking",Blurred or obscured subject,Question mark or teaser text,"Blur effect, circle highlight, red arrow, question mark",Reveals mysteries storytelling,Straightforward tutorials,Medium,Very High
-9,Product Showcase,Review,"product, review, unbox, gadget, tech, item",Clean gradient or solid,Product name + verdict,Product hero image centered clean bg,"Reviews unboxing tech gadgets",Vlogs personal content,Medium,Medium
-10,Comparison,Versus,"vs, versus, compare, battle, which, better",Split screen with VS badge,Brand/product names both sides,"Two subjects side by side, VS badge center, split colors",Comparison videos battles reviews,Single subject content,Medium,High
-11,Meme,Trending,"meme, trend, viral, funny, relatable, format",Recognizable meme template,Impact or bold sans,"Known meme format, humor, relatable situation",Entertainment comedy trending,Professional educational,Low,High
-12,Minimalist,Clean,"minimal, clean, simple, modern, tech, sleek",White or single color,Thin modern sans-serif,"Few elements, lots of whitespace, high contrast",Tech SaaS professional,Entertainment kids gaming,Low,Medium
-13,Dark Dramatic,Gaming,"dark, dramatic, glow, neon, epic, intense",Dark black or deep blue,Bold with glow or neon effect,"Dark background, rim lighting, glow effects, dramatic",Gaming thriller action horror,Lifestyle cooking bright,High,Medium
-14,Bright Pop,Fun,"bright, colorful, fun, kids, pop, saturated",Bright saturated solid colors,Rounded bold fun fonts,"Saturated colors, fun shapes, stickers, energetic",Kids lifestyle entertainment,Professional finance legal,Low,Medium
-15,Screenshot,Demo,"screenshot, UI, demo, walkthrough, screen, app",Actual UI screenshot,Annotation arrows circles,"UI screenshot with annotations, highlights, callouts",Demos walkthroughs software,Non-tech entertainment,Medium,Low
-16,Diagram,Explainer,"diagram, flowchart, architecture, system, map, excalidraw, sketch, mind map, process",White or light canvas with sketched diagram,Bold overlaid on whiteboard area,"Hand-drawn Excalidraw-style diagram with rough lines arrows and nodes, optional face pointing at diagram",Tech explainers system design architecture tutorials,Entertainment vlogs cooking,Medium,High
-17,Whiteboard,Educational,"whiteboard, marker, sketch, draw, explain, teach, brainstorm, concept",White or light gray board,Dark text with white stroke,"Colorful marker-style sketches icons and annotations on whiteboard, process flow or concept map",Educational brainstorm concept explainer,Gaming entertainment lifestyle,Medium,Medium

package/.opencode/skills/youtube-thumbnail-design/references/thumbnail-styles.md

@@ -1,170 +0,0 @@
-# YouTube Thumbnail Styles Reference
-
-## 15 Art Direction Styles
-
-### 1. Facecam
-- **Layout:** Face on left third (cropped shoulders-up), text on right
-- **Background:** Solid color or gradient matching brand
-- **Face:** Expressive emotion — surprise, excitement, disbelief
-- **Text:** 1-3 bold words, 80px+ with stroke outline
-- **Best for:** Vlogs, reactions, reviews, commentary
-- **CTR tip:** Exaggerated expressions outperform neutral by 2-3x
-
-### 2. Before-After
-- **Layout:** Split vertically — "before" left, "after" right
-- **Divider:** Arrow, lightning bolt, or hard color split
-- **Contrast:** Make the difference dramatic and obvious
-- **Text:** "BEFORE" / "AFTER" or result metric
-- **Best for:** Tutorials, transformations, fitness, makeovers
-- **CTR tip:** The bigger the contrast, the higher the click
-
-### 3. Listicle
-- **Layout:** Large number (200px+) as hero element
-- **Background:** Clean gradient or solid with subtle grid
-- **Grid:** Small preview images of items in the list
-- **Text:** "TOP [N]" or just the number
-- **Best for:** Top-N videos, rankings, compilations
-- **CTR tip:** Odd numbers (7, 11, 13) outperform even
-
-### 4. Tutorial
-- **Layout:** Clean instructional composition
-- **Elements:** Tool/subject centered, step preview, result teaser
-- **Background:** Light (white/cream) or dark (charcoal)
-- **Text:** Action verb — "BUILD", "CREATE", "LEARN"
-- **Best for:** How-to, educational, DIY, coding
-- **CTR tip:** Show the end result, not the process
-
-### 5. Reaction
-- **Layout:** Face (exaggerated) left, subject/screenshot right
-- **Expression:** Jaw-drop, wide eyes, hands on face
-- **Background:** Bright accent color or subject screenshot
-- **Text:** "OMG", "WOW", "NO WAY" — emotional trigger
-- **Best for:** Commentary, reactions, drama, news
-- **CTR tip:** The more extreme the expression, the more clicks
-
-### 6. Cinematic
-- **Layout:** Full-bleed hero image, widescreen feel
-- **Lighting:** Golden hour, dramatic shadows, film-like
-- **Color grading:** Teal-orange, moody blues, warm golds
-- **Text:** Minimal or none — let the image speak
-- **Best for:** Travel, documentary, film, storytelling
-- **CTR tip:** Horizon/landscape shots with human figure for scale
-
-### 7. Bold Text
-- **Layout:** Text fills 60%+ of the frame
-- **Background:** Simple solid or gradient
-- **Typography:** Oversized, bold condensed, high contrast
-- **Imagery:** Minimal — small icon or face as accent
-- **Best for:** Opinion, hot takes, news, announcements
-- **CTR tip:** Controversial or strong statements drive curiosity
-
-### 8. Mystery / Curiosity
-- **Layout:** Subject partially hidden, blurred, or circled
-- **Effects:** Gaussian blur, red circle, red arrow, "?"
-- **Background:** Dark or obscured scene
-- **Text:** Question or teaser — never the answer
-- **Best for:** Reveals, mysteries, storytelling, secrets
-- **CTR tip:** Highest CTR style when done right — never give away the answer
-
-### 9. Product Showcase
-- **Layout:** Product hero shot centered on clean bg
-- **Background:** Gradient (dark-to-light) or solid brand color
-- **Angle:** 3/4 view, slight tilt, dramatic shadow
-- **Text:** Product name + verdict ("BEST", "WORTH IT?")
-- **Best for:** Reviews, unboxing, tech, gadgets
-- **CTR tip:** Show the product at its best angle, not the box
-
-### 10. Comparison (VS)
-- **Layout:** Split screen, two subjects side by side
-- **Center:** "VS" badge, lightning bolt, or divider
-- **Colors:** Each side gets its own color zone
-- **Text:** Subject names on each side
-- **Best for:** Comparison videos, battles, reviews
-- **CTR tip:** Make both options look appealing to create tension
-
-### 11. Meme / Trending
-- **Layout:** Follows recognizable meme template
-- **Style:** Internet-native, casual, relatable
-- **Typography:** Impact font or meme-standard fonts
-- **Tone:** Humorous, self-aware, culturally relevant
-- **Best for:** Entertainment, comedy, trending topics
-- **CTR tip:** Use currently trending formats, refresh frequently
-
-### 12. Minimalist
-- **Layout:** 1-2 elements max, lots of whitespace
-- **Background:** Single color or very subtle gradient
-- **Typography:** Thin modern sans-serif, precise spacing
-- **Elements:** One strong focal point
-- **Best for:** Tech, SaaS, professional, premium content
-- **CTR tip:** Stands out by being different from busy thumbnails
-
-### 13. Dark Dramatic
-- **Layout:** Dark background with glowing subject
-- **Lighting:** Rim light, neon glow, spotlight effect
-- **Colors:** Dark base with neon accents (cyan, magenta, green)
-- **Effects:** Light rays, particles, smoke
-- **Best for:** Gaming, thriller, action, horror, tech
-- **CTR tip:** Glow effects on dark backgrounds are highly eye-catching
-
-### 14. Bright Pop
-- **Layout:** Full bright background, fun elements scattered
-- **Colors:** Saturated primaries — yellow, cyan, magenta, lime
-- **Typography:** Rounded, bold, playful fonts
-- **Elements:** Stickers, stars, emoji-like shapes
-- **Best for:** Kids, lifestyle, entertainment, vlogs
-- **CTR tip:** Use complementary color pairs for maximum pop
-
-### 15. Screenshot
-- **Layout:** Actual UI/app screenshot with annotations
-- **Annotations:** Red circles, arrows, highlight boxes
-- **Background:** Dark mode UI or browser chrome
-- **Text:** Feature name or "NEW" / "HOW?"
-- **Best for:** Software demos, walkthroughs, bug reveals
-- **CTR tip:** Annotate the specific thing that matters, not the whole screen
-
-### 16. Diagram
-- **Layout:** Excalidraw-style hand-drawn diagram fills right two-thirds, optional face on left third
-- **Diagram types:** System architecture, flowchart, mind map, process flow, data pipeline
-- **Style:** Rough hand-drawn lines, rounded rectangles, simple arrows, handwritten labels
-- **Text:** Bold overlaid on whiteboard area, top-left or bottom
-- **Best for:** Tech explainers, system design, architecture tutorials
-- **CTR tip:** Authentic sketch feel outperforms polished vector diagrams — looks "real"
-
-### 17. Whiteboard
-- **Layout:** Full whiteboard background with colorful marker-style sketches
-- **Elements:** Icons, arrows, annotations in blue/red/green/black markers
-- **Content:** Roadmaps, concept maps, brainstorm sessions, learning paths
-- **Text:** Dark text with white stroke, corner placement
-- **Best for:** Educational content, roadmaps, concept explainers, brainstorms
-- **CTR tip:** Filled whiteboards feel information-dense and valuable
-
-## YouTube-Specific Design Rules
-
-### Readability Matrix
-| View Context | Size | Must Read |
-|--------------|------|-----------|
-| Suggested sidebar | 168 × 94px | Title text only |
-| Mobile feed | 246 × 138px | Title + face |
-| Home feed desktop | 360 × 202px | All elements |
-| Search results | 360 × 202px | All elements |
-
-### Dead Zones
-- **Bottom-right:** Video duration badge (dark semi-transparent)
-- **Bottom-left:** "Watch Later" and "Add to Queue" on hover
-- **Top-right:** Channel watermark area (if enabled)
-
-### Color Dos and Don'ts
-| Do | Don't |
-|----|-------|
-| High contrast pairs | YouTube red (#FF0000) as primary |
-| Complementary colors | Low contrast pastel-on-pastel |
-| Brand-consistent palette | More than 3 colors |
-| Dark bg + bright text | Light bg + light text |
-
-### Typography Rules
-- **Maximum:** 3 words
-- **Minimum font:** 80px at 1280×720
-- **Weight:** Bold or Extra-Bold only
-- **Outline:** 3-4px stroke in contrasting color
-- **Shadow:** Drop shadow for depth on photo backgrounds
-- **Font stacks:** Impact, Montserrat Black, Anton, Bebas Neue, Oswald Bold

package/.opencode/skills/youtube-thumbnail-design/scripts/core.py

@@ -1,150 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-YouTube Thumbnail Design Core - BM25 search engine for thumbnail design guidelines
-"""
-
-import csv
-import re
-from pathlib import Path
-from math import log
-from collections import defaultdict
-
-DATA_DIR = Path(__file__).parent.parent / "data"
-MAX_RESULTS = 3
-
-CSV_CONFIG = {
-    "style": {
-        "file": "styles.csv",
-        "search_cols": ["Style Name", "Category", "Keywords", "Best For"],
-        "output_cols": ["Style Name", "Category", "Keywords", "Background", "Typography", "Key Elements", "Best For", "Avoid For", "Complexity", "CTR Impact"]
-    },
-    "niche": {
-        "file": "niches.csv",
-        "search_cols": ["Niche", "Keywords", "Recommended Styles", "Mood"],
-        "output_cols": ["Niche", "Keywords", "Recommended Styles", "Primary Colors", "Typography", "Common Elements", "Mood", "Best Practices", "Avoid"]
-    }
-}
-
-# Cache: domain -> (rows, config, bm25_index, documents)
-_search_cache = {}
-
-
-class BM25:
-    def __init__(self, k1=1.5, b=0.75):
-        self.k1 = k1
-        self.b = b
-        self.corpus = []
-        self.doc_lengths = []
-        self.avgdl = 0
-        self.idf = {}
-        self.doc_freqs = defaultdict(int)
-        self.N = 0
-
-    def tokenize(self, text):
-        text = re.sub(r'[^\w\s]', ' ', str(text).lower())
-        return [w for w in text.split() if len(w) > 2]
-
-    def fit(self, documents):
-        self.corpus = [self.tokenize(doc) for doc in documents]
-        self.N = len(self.corpus)
-        if self.N == 0:
-            return
-        self.doc_lengths = [len(doc) for doc in self.corpus]
-        self.avgdl = sum(self.doc_lengths) / self.N
-
-        for doc in self.corpus:
-            seen = set()
-            for word in doc:
-                if word not in seen:
-                    self.doc_freqs[word] += 1
-                    seen.add(word)
-
-        for word, freq in self.doc_freqs.items():
-            self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
-
-    def score(self, query):
-        query_tokens = self.tokenize(query)
-        scores = []
-        for idx, doc in enumerate(self.corpus):
-            score = 0
-            dl = self.doc_lengths[idx]
-            for term in query_tokens:
-                if term not in self.idf:
-                    continue
-                tf = doc.count(term)
-                idf = self.idf[term]
-                numerator = tf * (self.k1 + 1)
-                denominator = tf + self.k1 * (1 - self.b + self.b * dl / self.avgdl)
-                score += idf * numerator / denominator
-            scores.append((idx, score))
-        return sorted(scores, key=lambda x: x[1], reverse=True)
-
-
-def _get_cached(domain):
-    """Load CSV and build BM25 index, cached per domain"""
-    if domain in _search_cache:
-        return _search_cache[domain]
-
-    config = CSV_CONFIG.get(domain)
-    if not config:
-        return None
-
-    filepath = DATA_DIR / config["file"]
-    if not filepath.exists():
-        return None
-
-    with open(filepath, newline='', encoding='utf-8') as f:
-        rows = list(csv.DictReader(f))
-
-    if not rows:
-        return None
-
-    documents = [
-        " ".join(str(row.get(col, "")) for col in config["search_cols"])
-        for row in rows
-    ]
-    bm25 = BM25()
-    bm25.fit(documents)
-
-    entry = (rows, config, bm25)
-    _search_cache[domain] = entry
-    return entry
-
-
-def search(query, domain, max_results=None):
-    if max_results is None:
-        max_results = MAX_RESULTS
-
-    cached = _get_cached(domain)
-    if not cached:
-        return {"error": f"Domain '{domain}' not found or empty"}
-
-    rows, config, bm25 = cached
-    ranked = bm25.score(query)
-
-    results = []
-    for idx, score in ranked[:max_results]:
-        if score > 0:
-            results.append({col: rows[idx].get(col, "") for col in config["output_cols"]})
-
-    return {
-        "domain": domain,
-        "query": query,
-        "file": config["file"],
-        "count": len(results),
-        "results": results
-    }
-
-
-def search_all(query, max_results=None):
-    if max_results is None:
-        max_results = MAX_RESULTS
-
-    all_results = {}
-    for domain in CSV_CONFIG:
-        result = search(query, domain, max_results)
-        if result.get("results"):
-            all_results[domain] = result["results"]
-
-    return all_results