bobo-ai-cli 1.0.1

package/knowledge/skills/tiktok-research.md

@@ -0,0 +1,208 @@
+---
+id: "tiktok-research"
+title: "TikTok Research"
+category: "other"
+tags: ["tiktok research", "prerequisites", "workflow", "tiktok research report", "top performing hooks", "content structure patterns", "cta strategies", "all outliers", "trending topics", "actionable takeaways"]
+triggers: []
+dependencies: []
+source: "E:/Bobo's Coding cache/.claude/skills/tiktok-research"
+---
+
+---
+name: tiktok-research
+description: |
+  Research high-performing TikTok videos from tracked accounts using Apify's TikTok Scraper.
+  Identifies outlier content, analyzes top 5 videos with AI, and generates reports with actionable hook formulas.
+
+  Use when asked to:
+  - Find trending TikTok content in a niche
+  - Research what's performing on TikTok
+  - Identify high-performing video patterns
+  - Analyze competitors' TikTok content
+  - Generate content ideas from TikTok trends
+  - Run TikTok research
+  - Find viral TikToks
+  - Analyze hooks and content structure
+
+  Triggers: "tiktok research", "tt research", "find trending tiktoks", "analyze tiktok accounts",
+  "what's working on tiktok", "content research tiktok", "tiktok analysis", "tiktok trends"
+---
+
+# TikTok Research
+
+Research high-performing TikTok videos, identify outliers, and analyze top video content for hooks and structure.
+
+## Prerequisites
+
+- `APIFY_TOKEN` environment variable or in `.env`
+- `GEMINI_API_KEY` environment variable or in `.env`
+- `apify-client` and `google-genai` Python packages
+- Accounts configured in `.claude/context/tiktok-accounts.md`
+
+Verify setup:
+```bash
+python3 -c "
+import os
+try:
+    from dotenv import load_dotenv
+    load_dotenv()
+except ImportError:
+    pass
+from apify_client import ApifyClient
+from google import genai
+assert os.environ.get('APIFY_TOKEN'), 'APIFY_TOKEN not set'
+assert os.environ.get('GEMINI_API_KEY'), 'GEMINI_API_KEY not set'
+" && echo "Prerequisites OK"
+```
+
+## Workflow
+
+### 1. Create Run Folder
+
+```bash
+RUN_FOLDER="tiktok-research/$(date +%Y-%m-%d_%H%M%S)" && mkdir -p "$RUN_FOLDER" && echo "$RUN_FOLDER"
+```
+
+### 2. Fetch Content
+
+```bash
+python3 .claude/skills/tiktok-research/scripts/fetch_tiktok.py \
+  --days 30 \
+  --limit 50 \
+  --sorting latest \
+  --output {RUN_FOLDER}/raw.json
+```
+
+Parameters:
+- `--days`: Days back to search (default: 30)
+- `--limit`: Max videos per account (default: 50)
+- `--sorting`: "latest", "popular", or "oldest" (default: latest)
+- `--usernames`: Override accounts file with specific usernames
+
+### 3. Identify Outliers
+
+```bash
+python3 .claude/skills/tiktok-research/scripts/analyze_posts.py \
+  --input {RUN_FOLDER}/raw.json \
+  --output {RUN_FOLDER}/outliers.json \
+  --threshold 2.0
+```
+
+Output JSON contains:
+- `total_videos`: Number of videos analyzed
+- `outlier_count`: Number of outliers found
+- `topics`: Top hashtags, sounds, and keywords
+- `accounts`: List of accounts analyzed
+- `outliers`: Array of outlier videos with engagement metrics
+
+### 4. Analyze Top Videos with AI
+
+```bash
+python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \
+  --input {RUN_FOLDER}/outliers.json \
+  --output {RUN_FOLDER}/video-analysis.json \
+  --platform tiktok \
+  --max-videos 5
+```
+
+Extracts from each video:
+- Hook technique and replicable formula
+- Content structure and sections
+- Retention techniques
+- CTA strategy
+
+See the `video-content-analyzer` skill for full output schema and hook/format types.
+
+### 5. Generate Report
+
+Read `{RUN_FOLDER}/outliers.json` and `{RUN_FOLDER}/video-analysis.json`, then generate `{RUN_FOLDER}/report.md`.
+
+**Report Structure:**
+
+```markdown
+# TikTok Research Report
+
+Generated: {date}
+
+## Top Performing Hooks
+
+Ranked by engagement. Use these formulas for your content.
+
+### Hook 1: {technique} - @{username}
+- **Opening**: "{opening_line}"
+- **Why it works**: {attention_grab}
+- **Replicable Formula**: {replicable_formula}
+- **Engagement**: {diggCount} likes, {commentCount} comments, {playCount} views
+- [Watch Video]({webVideoUrl})
+
+[Repeat for each analyzed video]
+
+## Content Structure Patterns
+
+| Video | Format | Pacing | Key Retention Techniques |
+|-------|--------|--------|--------------------------|
+| @username | {format} | {pacing} | {techniques} |
+
+## CTA Strategies
+
+| Video | CTA Type | CTA Text | Placement |
+|-------|----------|----------|-----------|
+| @username | {type} | "{cta_text}" | {placement} |
+
+## All Outliers
+
+| Rank | Username | Likes | Comments | Shares | Views | Engagement Rate |
+|------|----------|-------|----------|--------|-------|-----------------|
+[List all outliers with metrics and links]
+
+## Trending Topics
+
+### Top Hashtags
+[From outliers.json topics.hashtags]
+
+### Top Sounds
+[From outliers.json topics.sounds]
+
+### Top Keywords
+[From outliers.json topics.keywords]
+
+## Actionable Takeaways
+
+[Synthesize patterns into 4-6 specific recommendations]
+
+## Accounts Analyzed
+[List accounts]
+```
+
+Focus on actionable insights. The "Top Performing Hooks" section with replicable formulas should be prominent.
+
+## Quick Reference
+
+Full pipeline:
+```bash
+RUN_FOLDER="tiktok-research/$(date +%Y-%m-%d_%H%M%S)" && mkdir -p "$RUN_FOLDER" && \
+python3 .claude/skills/tiktok-research/scripts/fetch_tiktok.py -o "$RUN_FOLDER/raw.json" && \
+python3 .claude/skills/tiktok-research/scripts/analyze_posts.py -i "$RUN_FOLDER/raw.json" -o "$RUN_FOLDER/outliers.json" && \
+python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py -i "$RUN_FOLDER/outliers.json" -o "$RUN_FOLDER/video-analysis.json" -p tiktok
+```
+
+Then read both JSON files and generate the report.
+
+## Engagement Metrics
+
+**Engagement Score**: `likes + (3 x comments) + (2 x shares) + (2 x saves) + (0.05 x views)`
+
+**Outlier Detection**: Videos with engagement rate > mean + (threshold x std_dev)
+
+**Engagement Rate**: (score / followers) x 100
+
+## TikTok-Specific Fields
+
+- `diggCount`: Likes/hearts
+- `shareCount`: Shares
+- `playCount`: Video views
+- `commentCount`: Comments
+- `collectCount`: Saves/bookmarks
+- `authorFollowers`: Creator's follower count
+- `musicName`: Sound used in video
+- `musicOriginal`: Whether sound is original

package/knowledge/skills/typescript-lsp.md

@@ -0,0 +1,36 @@
+---
+id: "typescript-lsp"
+title: "typescript-lsp"
+category: "other"
+tags: ["typescript-lsp", "supported extensions", "installation", "more information"]
+triggers: []
+dependencies: []
+source: "E:/Bobo's Coding cache/.claude/skills/typescript-lsp"
+---
+
+# typescript-lsp
+
+TypeScript/JavaScript language server for Claude Code, providing code intelligence features like go-to-definition, find references, and error checking.
+
+## Supported Extensions
+
+`.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.mjs`, `.cjs`
+
+## Installation
+
+Install the TypeScript language server globally via npm:
+
+```bash
+npm install -g typescript-language-server typescript
+```
+
+Or with yarn:
+
+```bash
+yarn global add typescript-language-server typescript
+```
+
+## More Information
+
+- [typescript-language-server on npm](https://www.npmjs.com/package/typescript-language-server)
+- [GitHub Repository](https://github.com/typescript-language-server/typescript-language-server)

package/knowledge/skills/ui-ux-pro-max.md

@@ -0,0 +1,247 @@
+---
+id: "ui-ux-pro-max"
+title: "UI/UX Pro Max - Design Intelligence"
+category: "design"
+tags: ["prerequisites", "how to use this skill", "search reference", "example workflow", "1. search product type", "3. search typography", "4. search color palette", "6. search ux guidelines", "tips for better results", "pre-delivery checklist"]
+triggers: []
+dependencies: []
+source: "E:/Bobo's Coding cache/.claude/skills/ui-ux-pro-max"
+---
+
+---
+name: ui-ux-pro-max
+description: 'UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.'
+---
+
+# UI/UX Pro Max - Design Intelligence
+
+Searchable database of UI styles, color palettes, font pairings, chart types, product recommendations, UX guidelines, and stack-specific best practices.
+
+## Prerequisites
+
+Check if Python is installed:
+
+```bash
+python3 --version || python --version
+```
+
+If Python is not installed, install it based on user's OS:
+
+**macOS:**
+
+```bash
+brew install python3
+```
+
+**Ubuntu/Debian:**
+
+```bash
+sudo apt update && sudo apt install python3
+```
+
+**Windows:**
+
+```powershell
+winget install Python.Python.3.12
+```
+
+---
+
+## How to Use This Skill
+
+When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information from user request:
+
+- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
+- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.
+- **Industry**: healthcare, fintech, gaming, education, etc.
+- **Stack**: React, Vue, Next.js, or default to `html-tailwind`
+
+### Step 2: Search Relevant Domains
+
+Use `search.py` multiple times to gather comprehensive information. Search until you have enough context.
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+```
+
+**Recommended search order:**
+
+1. **Product** - Get style recommendations for product type
+2. **Style** - Get detailed style guide (colors, effects, frameworks)
+3. **Typography** - Get font pairings with Google Fonts imports
+4. **Color** - Get color palette (Primary, Secondary, CTA, Background, Text, Border)
+5. **Landing** - Get page structure (if landing page)
+6. **Chart** - Get chart recommendations (if dashboard/analytics)
+7. **UX** - Get best practices and anti-patterns
+8. **Stack** - Get stack-specific guidelines (default: html-tailwind)
+
+### Step 3: Stack Guidelines (Default: html-tailwind)
+
+If user doesn't specify a stack, **default to `html-tailwind`**.
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
+```
+
+Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`
+
+---
+
+## Search Reference
+
+### Available Domains
+
+| Domain       | Use For                              | Example Keywords                                         |
+| ------------ | ------------------------------------ | -------------------------------------------------------- |
+| `product`    | Product type recommendations         | SaaS, e-commerce, portfolio, healthcare, beauty, service |
+| `style`      | UI styles, colors, effects           | glassmorphism, minimalism, dark mode, brutalism          |
+| `typography` | Font pairings, Google Fonts          | elegant, playful, professional, modern                   |
+| `color`      | Color palettes by product type       | saas, ecommerce, healthcare, beauty, fintech, service    |
+| `landing`    | Page structure, CTA strategies       | hero, hero-centric, testimonial, pricing, social-proof   |
+| `chart`      | Chart types, library recommendations | trend, comparison, timeline, funnel, pie                 |
+| `ux`         | Best practices, anti-patterns        | animation, accessibility, z-index, loading               |
+| `prompt`     | AI prompts, CSS keywords             | (style name)                                             |
+
+### Available Stacks
+
+| Stack           | Focus                                          |
+| --------------- | ---------------------------------------------- |
+| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |
+| `react`         | State, hooks, performance, patterns            |
+| `nextjs`        | SSR, routing, images, API routes               |
+| `vue`           | Composition API, Pinia, Vue Router             |
+| `svelte`        | Runes, stores, SvelteKit                       |
+| `swiftui`       | Views, State, Navigation, Animation            |
+| `react-native`  | Components, Navigation, Lists                  |
+| `flutter`       | Widgets, State, Layout, Theming                |
+
+---
+
+## Example Workflow
+
+**User request:** "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
+
+**AI should:**
+
+```bash
+# 1. Search product type
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --domain product
+
+# 2. Search style (based on industry: beauty, elegant)
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant minimal soft" --domain style
+
+# 3. Search typography
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury" --domain typography
+
+# 4. Search color palette
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --domain color
+
+# 5. Search landing page structure
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "hero-centric social-proof" --domain landing
+
+# 6. Search UX guidelines
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation" --domain ux
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "accessibility" --domain ux
+
+# 7. Search stack guidelines (default: html-tailwind)
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive" --stack html-tailwind
+```
+
+**Then:** Synthesize all search results and implement the design.
+
+---
+
+## Tips for Better Results
+
+1. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"
+2. **Search multiple times** - Different keywords reveal different insights
+3. **Combine domains** - Style + Typography + Color = Complete design system
+4. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues
+5. **Use stack flag** - Get implementation-specific best practices
+6. **Iterate** - If first search doesn't match, try different keywords
+
+---
+
+## Common Rules for Professional UI
+
+These are frequently overlooked issues that make UI look unprofessional:
+
+### Icons & Visual Elements
+
+| Rule                       | Do                                              | Don't                                  |
+| -------------------------- | ----------------------------------------------- | -------------------------------------- |
+| **No emoji icons**         | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons   |
+| **Stable hover states**    | Use color/opacity transitions on hover          | Use scale transforms that shift layout |
+| **Correct brand logos**    | Research official SVG from Simple Icons         | Guess or use incorrect logo paths      |
+| **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6          | Mix different icon sizes randomly      |
+
+### Interaction & Cursor
+
+| Rule                   | Do                                                    | Don't                                        |
+| ---------------------- | ----------------------------------------------------- | -------------------------------------------- |
+| **Cursor pointer**     | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |
+| **Hover feedback**     | Provide visual feedback (color, shadow, border)       | No indication element is interactive         |
+| **Smooth transitions** | Use `transition-colors duration-200`                  | Instant state changes or too slow (>500ms)   |
+
+### Light/Dark Mode Contrast
+
+| Rule                      | Do                                  | Don't                                   |
+| ------------------------- | ----------------------------------- | --------------------------------------- |
+| **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent)     |
+| **Text contrast light**   | Use `#0F172A` (slate-900) for text  | Use `#94A3B8` (slate-400) for body text |
+| **Muted text light**      | Use `#475569` (slate-600) minimum   | Use gray-400 or lighter                 |
+| **Border visibility**     | Use `border-gray-200` in light mode | Use `border-white/10` (invisible)       |
+
+### Layout & Spacing
+
+| Rule                     | Do                                  | Don't                                  |
+| ------------------------ | ----------------------------------- | -------------------------------------- |
+| **Floating navbar**      | Add `top-4 left-4 right-4` spacing  | Stick navbar to `top-0 left-0 right-0` |
+| **Content padding**      | Account for fixed navbar height     | Let content hide behind fixed elements |
+| **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths         |
+
+---
+
+## Pre-Delivery Checklist
+
+Before delivering UI code, verify these items:
+
+### Visual Quality
+
+- [ ] No emojis used as icons (use SVG instead)
+- [ ] All icons from consistent icon set (Heroicons/Lucide)
+- [ ] Brand logos are correct (verified from Simple Icons)
+- [ ] Hover states don't cause layout shift
+- [ ] Use theme colors directly (bg-primary) not var() wrapper
+
+### Interaction
+
+- [ ] All clickable elements have `cursor-pointer`
+- [ ] Hover states provide clear visual feedback
+- [ ] Transitions are smooth (150-300ms)
+- [ ] Focus states visible for keyboard navigation
+
+### Light/Dark Mode
+
+- [ ] Light mode text has sufficient contrast (4.5:1 minimum)
+- [ ] Glass/transparent elements visible in light mode
+- [ ] Borders visible in both modes
+- [ ] Test both modes before delivery
+
+### Layout
+
+- [ ] Floating elements have proper spacing from edges
+- [ ] No content hidden behind fixed navbars
+- [ ] Responsive at 320px, 768px, 1024px, 1440px
+- [ ] No horizontal scroll on mobile
+
+### Accessibility
+
+- [ ] All images have alt text
+- [ ] Form inputs have labels
+- [ ] Color is not the only indicator
+- [ ] `prefers-reduced-motion` respected

package/knowledge/skills/verify.md

@@ -0,0 +1,15 @@
+---
+id: "verify"
+title: "Verify"
+category: "dev-tools"
+tags: []
+triggers: []
+dependencies: []
+source: "E:/Bobo's Coding cache/.claude/skills/verify"
+---
+
+启动开发服务器并检查：
+
+1. 视觉元素正确渲染
+2. 3D 连接正确附着
+3. 无控制台错误

package/knowledge/skills/visual-prompt-engineer.md

@@ -0,0 +1,102 @@
+---
+id: "visual-prompt-engineer"
+title: "Role"
+category: "media"
+tags: ["role", "workflow", "1. analyze intent (分析意图)", "2. execute strategy (执行策略)", "3. output format (输出格式)", "examples", "user input", "ai response"]
+triggers: []
+dependencies: []
+source: "E:/Bobo's Coding cache/.claude/skills/visual-prompt-engineer"
+---
+
+---
+name: visual-prompt-engineer
+description: 全能视觉提示词专家。支持 Midjourney/Gemini(Nano Banana) 生图，以及 Sora/Vidu/Veo 视频生成。
+---
+
+# Role
+
+你是一位精通多模态 AI 的提示词工程师。你深谙各类视觉模型的底层逻辑和最佳实践。
+
+# Workflow
+
+## 1. Analyze Intent (分析意图)
+
+- **Task Type:** Is the user asking for an **[IMAGE]** or a **[VIDEO]**?
+- **Target Model:** Did the user specify a model? (e.g., "Veo", "Sora", "Gemini", "Nano Banana"). If not, use the **Default** strategy for that type.
+
+## 2. Execute Strategy (执行策略)
+
+### branch: IF [IMAGE]
+
+- **Strategy A: Midjourney / Flux (Default)**
+  - _Focus:_ Artistic style, lighting, composition, parameters.
+  - _Syntax:_ Tag-heavy or descriptive.
+  - _Mandatory:_ Always include aspect ratio (e.g., `--ar 16:9`).
+  - _Reference:_ `templates/midjourney.md`
+
+- **Strategy B: Nano Banana (Google Gemini/Imagen)**
+  - _Focus:_ Natural language understanding, **Text Rendering**, complex spatial logic.
+  - _Syntax:_ Long, fluent English sentences. NO tag soup.
+  - _Text:_ If user implies text, specify: "with the text '...' written on it".
+  - _Reference:_ `templates/nano_banana2.md`
+
+### branch: IF [VIDEO]
+
+- **Strategy A: Sora (Default)**
+  - _Focus:_ World simulation, physics interactions, fluid dynamics.
+  - _Syntax:_ Highly descriptive narrative.
+  - _Reference:_ `templates/sora.md`
+
+- **Strategy B: Veo (Google Veo)**
+  - _Focus:_ **Cinematic Camera Control**. Use professional terms: "Pan", "Tilt", "Truck", "Dolly", "Aerial".
+  - _Style:_ Screenplay direction style.
+  - _Reference:_ `templates/veo3.1.md`
+
+- **Strategy C: Vidu**
+  - _Focus:_ Character consistency, anime/stylized motion, high responsiveness.
+  - _Reference:_ `templates/vidu.md`
+
+## 3. Output Format (输出格式)
+
+**Target Model:** [Model Name]
+**Type:** [IMAGE] / [VIDEO]
+
+**Optimized Prompt:**
+(The English prompt tailored to the specific model's syntax)
+
+**Design Rationale:**
+(简短中文解释：为什么针对该模型使用了这些特定的词汇或参数？例如："使用了 Truck Left 运镜指令以适配 Veo 的电影感特性"。)
+
+# Examples
+
+## User Input
+
+"Veo, 拍摄一段赛博朋克城市的空镜头"
+
+## AI Response
+
+**Target Model:** Veo
+**Type:** [VIDEO]
+
+**Optimized Prompt:**
+Aerial drone shot establishing a futuristic cyberpunk city at night. The camera flies forward and slowly tilts down (Tilt Down) to reveal neon-lit skyscrapers and flying vehicles weaving through the fog. Cinematic lighting, HDR, 4k resolution, smooth motion.
+
+**Design Rationale:**
+识别为 Veo 模型，因此使用了 "Aerial drone shot" 和明确的运镜指令 "Tilt Down" 来发挥其镜头控制优势。
+
+---
+
+## User Input
+
+"Nano Banana, 一个写着'OpenAI'的霓虹灯牌子"
+
+## AI Response
+
+**Target Model:** Nano Banana (Gemini)
+**Type:** [IMAGE]
+
+**Optimized Prompt:**
+A cinematic photo of a glowing neon sign mounted on a brick wall in a dim alleyway. The sign clearly spells out the word "OpenAI" in bright blue cursive letters. Rain puddles on the ground reflect the light. Photorealistic, 8k.
+
+**Design Rationale:**
+识别为 Nano Banana (Gemini)，因此使用了自然语言全句描述，并特别强调了文字渲染指令 "clearly spells out..."。