@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/ui-ux-pro-max/scripts/search.py

@@ -1,114 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
-
-Domains: style, prompt, color, chart, landing, product, ux, typography, google-fonts
-Stacks: html-tailwind, react, nextjs
-
-Persistence (Master + Overrides pattern):
-  --persist    Save design system to design-system/MASTER.md
-  --page       Also create a page-specific override file in design-system/pages/
-"""
-
-import argparse
-import sys
-import io
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
-from design_system import generate_design_system, persist_design_system
-
-# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
-if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
-    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
-if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
-    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
-
-
-def format_output(result):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append(f"## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append(f"## UI Pro Max Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query, 
-            args.project_name, 
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir
-        )
-        print(result)
-        
-        # Print persistence confirmation
-        if args.persist:
-            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
-            print("\n" + "=" * 60)
-            print(f"✅ Design system persisted to design-system/{project_slug}/")
-            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
-            if args.page:
-                page_filename = args.page.lower().replace(' ', '-')
-                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
-            print("")
-            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
-            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-            print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))

package/.opencode/skills/use-mcp/SKILL.md

@@ -1,39 +0,0 @@
----
-name: ck:use-mcp
-description: Utilize tools of Model Context Protocol (MCP) servers
-argument-hint: "[task]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-Execute MCP operations via **Gemini CLI** to preserve context budget.
-
-## Execution Steps
-
-1. **Execute task via Gemini CLI** (using stdin pipe for MCP support):
-   ```bash
-   # IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
-   echo "$ARGUMENTS. Return JSON only per GEMINI.md instructions." | gemini -y -m gemini-2.5-flash
-   ```
-
-2. **Fallback to mcp-manager subagent** (if Gemini CLI unavailable):
-   - Use `mcp-manager` subagent to discover and execute tools
-   - If the subagent got issues with the scripts of `mcp-management` skill, use `mcp-builder` skill to fix them
-   - **DO NOT** create ANY new scripts
-   - The subagent can only use MCP tools if any to achieve this task
-   - If the subagent can't find any suitable tools, just report it back to the main agent to move on to the next step
-
-## Important Notes
-
-- **MUST use stdin piping** - the deprecated `-p` flag skips MCP initialization
-- Use `-y` flag to auto-approve tool execution
-- **GEMINI.md auto-loaded**: Gemini CLI automatically loads `GEMINI.md` from project root, enforcing JSON-only response format
-- **Parseable output**: Responses are structured JSON: `{"server":"name","tool":"name","success":true,"result":<data>,"error":null}`
-
-## Anti-Pattern (DO NOT USE)
-
-```bash
-# BROKEN - deprecated -p flag skips MCP server connections!
-gemini -y -m gemini-2.5-flash -p "..."
-```

package/.opencode/skills/video/SKILL.md

@@ -1,72 +0,0 @@
----
-name: ckm:video
-description: Video marketing strategy, script writing, storyboards, production workflows, video specs for YouTube/TikTok/Instagram/LinkedIn, thumbnail creation, Veo 3.1 generation, optimization, and repurposing.
-argument-hint: "[create|script-create|storyboard-create] [topic]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# Video
-
-Video production, scripts, storyboards, and AI video generation.
-
-<args>$ARGUMENTS</args>
-
-## When to Use
-
-- Video script writing with creative direction
-- Storyboard creation for video content
-- AI video generation with Veo 3.1
-- Video optimization for platforms
-- Thumbnail design
-- Video SEO optimization
-
-## Subcommands
-
-| Subcommand | Description | Reference |
-|------------|-------------|-----------|
-| `create` | Create a video using Veo 3.1 | `references/create.md` |
-| `script-create` | Create production-ready video script | `references/script-create.md` |
-| `storyboard-create` | Create storyboard for video content | `references/storyboard-create.md` |
-
-## References (Knowledge Base)
-
-| Topic | File |
-|-------|------|
-| Production Workflow | `references/production-workflow.md` |
-| Video Types & Specs | `references/video-types-specs.md` |
-| Script Templates | `references/script-templates.md` |
-| Storyboard Format | `references/storyboard-format.md` |
-| Thumbnail Design | `references/thumbnail-design-guide.md` |
-| Art Directions | `references/video-art-directions.md` |
-| Audio Directives | `references/audio-directive-guide.md` |
-| Veo Prompt Guide | `references/veo-prompt-guide.md` |
-| Video Optimization | `references/video-optimization.md` |
-| Video SEO | `references/video-seo-optimization.md` |
-| Quality Review | `references/quality-review-workflow.md` |
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `scripts/generate-video.cjs` | AI video generation |
-| `scripts/create-storyboard.cjs` | Storyboard generation |
-| `scripts/analyze-video.cjs` | Video analysis |
-| `scripts/extract-captions.cjs` | Caption extraction |
-| `scripts/optimize-for-platform.cjs` | Platform optimization |
-
-## Templates
-
-| Template | Purpose |
-|----------|---------|
-| `templates/explainer.json` | Explainer video template |
-| `templates/product-demo.json` | Product demo template |
-| `templates/short-form.json` | Short-form video template |
-| `templates/testimonial.json` | Testimonial video template |
-
-## Routing
-
-1. Parse subcommand from `$ARGUMENTS` (first word)
-2. Load corresponding `references/{subcommand}.md`
-3. Execute with remaining arguments

package/.opencode/skills/video/references/audio-directive-guide.md

@@ -1,274 +0,0 @@
-# Audio Directive Guide
-
-Audio generation for video production using Veo 3.1 native audio, Gemini TTS, and Lyria music.
-
-## Audio Generation Options
-
-| Source | Use Case | Quality | Control |
-|--------|----------|---------|---------|
-| Veo 3.1 Native | Sync'd dialogue/SFX | Good | Limited |
-| Gemini TTS | Precise voiceover | High | Full voice control |
-| Lyria Music | Background music | High | Real-time params |
-| FFmpeg Mix | Final assembly | Lossless | Full mix control |
-
-## Recommended Workflow
-
-```
-1. VOICEOVER (Gemini TTS) → Generate precise narration
-2. MUSIC (Lyria) → Generate background track
-3. VIDEO (Veo 3.1) → Generate with SFX directives only
-4. MIX (FFmpeg) → Combine all audio layers
-```
-
-## Voiceover with Gemini TTS
-
-### Voice Selection
-
-| Voice | Character | Best For |
-|-------|-----------|----------|
-| Charon | Informative, clear | Product demos, explainers |
-| Puck | Upbeat, energetic | Social media, tutorials |
-| Kore | Firm, authoritative | Corporate, announcements |
-| Aoede | Warm, nurturing | Testimonials, stories |
-| Zephyr | Bright, cheerful | Lifestyle, casual |
-
-### TTS Script Format
-
-```python
-from google import genai
-from google.genai import types
-import base64, wave
-
-# Single speaker voiceover
-response = client.models.generate_content(
-    model='gemini-2.5-flash-preview-tts',
-    contents='''
-    Audio Profile: Professional narrator
-    Director's Notes: Clear, measured pace, slight warmth
-    Transcript: Welcome to our product demo. Watch how easy this is.
-    ''',
-    config=types.GenerateContentConfig(
-        response_modalities=['AUDIO'],
-        speech_config=types.SpeechConfig(
-            voice_config=types.VoiceConfig(
-                prebuilt_voice_config=types.PrebuiltVoiceConfig(voice_name='Charon')
-            )
-        )
-    )
-)
-
-# Save for mixing
-audio_data = base64.b64decode(response.candidates[0].content.parts[0].inline_data.data)
-with wave.open('voiceover.wav', 'wb') as wav:
-    wav.setnchannels(1)
-    wav.setsampwidth(2)
-    wav.setframerate(24000)
-    wav.writeframes(audio_data)
-```
-
-### Style Control Prompts
-
-```
-# Professional/Corporate
-Audio Profile: Professional presenter
-Director's Notes: Authoritative yet approachable, steady pace
-Transcript: {your_script}
-
-# Energetic/Social
-Audio Profile: Enthusiastic creator
-Director's Notes: Quick pace, excitement building, punchy delivery
-Transcript: {your_script}
-
-# Emotional/Story
-Audio Profile: Warm storyteller
-Director's Notes: Gentle pace, emotional resonance, natural pauses
-Transcript: {your_script}
-```
-
-## Music with Lyria
-
-### Style Prompts by Video Type
-
-```python
-# Product Demo
-prompts = [
-    {"prompt": "Modern corporate, uplifting, professional", "weight": 0.9},
-    {"prompt": "Subtle background, not distracting", "weight": 0.6}
-]
-config = {"bpm": 100, "brightness": 0.6, "density": 0.4}
-
-# Social Media
-prompts = [
-    {"prompt": "Trending pop electronic, energetic", "weight": 0.9},
-    {"prompt": "Catchy rhythm, bass-forward", "weight": 0.6}
-]
-config = {"bpm": 128, "brightness": 0.7, "density": 0.7}
-
-# Testimonial
-prompts = [
-    {"prompt": "Warm acoustic, inspiring", "weight": 0.9},
-    {"prompt": "Emotional, subtle", "weight": 0.5}
-]
-config = {"bpm": 70, "brightness": 0.4, "density": 0.3}
-```
-
-### Generate Background Track
-
-```python
-async def generate_background_music(duration_sec, mood):
-    async with client.aio.live.music.connect() as session:
-        await session.set_weighted_prompts([
-            {"prompt": f"{mood} background music", "weight": 0.9},
-            {"prompt": "Supportive underscore, non-distracting", "weight": 0.6}
-        ])
-        await session.set_music_generation_config(
-            guidance=4.0, density=0.4, brightness=0.5
-        )
-        await session.play()
-        
-        audio = []
-        chunks = duration_sec * 48000 // 512
-        async for i, chunk in enumerate(session):
-            audio.append(chunk.audio_data)
-            if i >= chunks: break
-        return b''.join(audio)
-```
-
-## Veo 3.1 SFX Directives
-
-For Veo-native audio, only include SFX (voiceover via TTS, music via Lyria):
-
-### Directive Syntax
-
-```
-SFX: {description} as {trigger action}
-Ambient: {element 1}, {element 2}
-```
-
-### Examples
-
-```
-SFX: Satisfying click as button pressed
-SFX: Whoosh as product slides in
-SFX: Notification chime as message appears
-SFX: Soft pop as feature animates
-
-Ambient: Office typing, distant conversation
-Ambient: Coffee shop murmur, espresso machine
-```
-
-### Rules
-
-- Max 2-3 SFX per 8-second video
-- Tie SFX to specific visual action
-- Max 2 ambient elements
-- No dialogue/music directives (use TTS/Lyria)
-
-## Audio Mixing with FFmpeg
-
-### Final Assembly Pipeline
-
-```bash
-# 1. Convert TTS to match video format
-ffmpeg -i voiceover.wav -ar 48000 -ac 2 voiceover_48k.wav
-
-# 2. Convert music to match (if needed)
-ffmpeg -f s16le -ar 48000 -ac 2 -i music.pcm music.wav
-
-# 3. Extract video audio (SFX only from Veo)
-ffmpeg -i video.mp4 -vn -c:a pcm_s16le sfx.wav
-
-# 4. Mix all layers with volume control
-ffmpeg -i video.mp4 -i voiceover_48k.wav -i music.wav -i sfx.wav \
-    -filter_complex "
-        [1:a]volume=1.0[vo];
-        [2:a]volume=0.3[music];
-        [3:a]volume=0.8[sfx];
-        [vo][music][sfx]amix=inputs=3:duration=first[aout]
-    " \
-    -map 0:v -map "[aout]" -c:v copy -c:a aac output.mp4
-```
-
-### Volume Guidelines
-
-| Layer | Volume | Purpose |
-|-------|--------|---------|
-| Voiceover | 1.0 | Primary, always audible |
-| SFX | 0.7-0.8 | Supporting, impactful |
-| Music | 0.2-0.4 | Background, atmosphere |
-| Ambient | 0.1-0.2 | Subtle environment |
-
-### Ducking (Auto-lower music under voice)
-
-```bash
-ffmpeg -i video.mp4 -i voiceover.wav -i music.wav \
-    -filter_complex "
-        [2:a]sidechaincompress=threshold=0.01:ratio=4:attack=10:release=100[ducked];
-        [1:a][ducked]amix=inputs=2[aout]
-    " \
-    -map 0:v -map "[aout]" output.mp4
-```
-
-## Timing Sync
-
-### Voiceover Pacing
-
-| Duration | Max Words | Style |
-|----------|-----------|-------|
-| 2s | 4-6 | Punchy |
-| 4s | 8-12 | Normal |
-| 6s | 12-18 | Detailed |
-| 8s | 15-24 | Full |
-
-### SFX Timing Template
-
-```
-[0:00.0] - Video starts
-[0:00.5] - SFX: Hook sound
-[0:02.2] - SFX: Transition
-[0:04.3] - SFX: Action click
-[0:05.5] - SFX: Success chime
-[0:07.0] - SFX: CTA whoosh
-```
-
-### Music Arc
-
-```
-[0:00-0:02] - Intro, building anticipation
-[0:02-0:06] - Stable, under content (ducked for VO)
-[0:06-0:08] - Resolve, conclusion
-```
-
-## Platform Considerations
-
-### YouTube (Full Audio)
-- All layers: VO + Music + SFX
-- Professional broadcast quality
-- Full dynamic range
-
-### TikTok/Reels (Music Forward)
-- Minimal VO, punchy SFX
-- Trending music style prominent
-- Mobile-optimized levels
-
-### LinkedIn (Speech Priority)
-- Clear VO dominant
-- Subtle music (0.15-0.2)
-- Minimal SFX
-- Business appropriate
-
-## Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| VO unclear | Increase VO volume, add ducking |
-| Music too loud | Reduce to 0.2-0.3, add sidechaincompress |
-| SFX missing | Add explicit timing in Veo prompt |
-| Audio sync off | Check sample rates match (48kHz) |
-
-## Resources
-
-- [Gemini TTS Docs](https://ai.google.dev/gemini-api/docs/speech-generation)
-- [Lyria Music Docs](https://ai.google.dev/gemini-api/docs/music-generation)
-- [FFmpeg Filters](https://ffmpeg.org/ffmpeg-filters.html)
-- [media-processing skill](../../media-processing/SKILL.md)