takomi 2.0.4

package/assets/.agent/skills/global-brand-namer/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: global-brand-namer
+description: Generate memorable, brandable product and SaaS names using global linguistics (African, Asian, Nordic, Indigenous, and classical languages) to bypass English domain saturation. Use when the user asks to brainstorm product names, find available domains, develop cross-cultural brand identity, name a startup or side project, or needs a distinctive tech brand name that isn't just another English portmanteau. Triggers include "name my product," "brand name ideas," "domain name brainstorm," "SaaS name," "startup name," "what should I call," "name generator," or any request for creative, globally-inspired naming.
+---
+
+# Global Brand Namer
+
+Generate premium, cross-culturally resonant brand names by mining non-English vocabulary and pairing with strategic domain modifiers. This skill transforms generic naming sessions into systematic linguistic exploration.
+
+## Core Naming Principles
+
+1. **Phonetic Fluidity** - The word must be easily pronounceable by an English-speaking audience without phonetic training. Avoid heavy consonant clusters, tonal requirements, or characters that don't transliterate cleanly.
+2. **Domain Viability** - Assume all raw, single words (e.g., *Takumi*, *Agbara*) are squatted. Always pair the base word with a strategic modifier. See `references/saas-modifiers.md`.
+3. **Syllabic Brevity** - Target 2-3 syllables maximum for the base word. One-syllable words work if they're distinctive.
+4. **Semantic Depth** - The meaning behind the word should resonate with the product's purpose. A name with real meaning creates richer brand storytelling.
+5. **Cross-Lingual Safety** - Verify the transliterated word doesn't mean something offensive in major world languages (English slang, Spanish, French, Portuguese, Mandarin).
+
+## Workflow
+
+### Step 1: Distill the Core Concept
+
+Extract 2-4 English keywords capturing the product's function, feeling, or identity.
+
+**Prompting questions:**
+- What does the product DO? (build, connect, analyze, create)
+- What FEELING should it evoke? (speed, trust, power, calm)
+- Who is the audience? (developers, creators, enterprise, consumers)
+- What's the competitive landscape? (crowded SaaS, niche tool, consumer app)
+
+**Example:** A developer workflow tool might yield: *build, flow, craft, forge*
+
+### Step 2: Linguistic Translation & Exploration
+
+Translate concepts across diverse language families. Select language categories that match the project's aesthetic.
+
+**Reference:** Load `references/language-matrices.md` for full language-to-aesthetic mapping.
+
+Quick selection guide:
+
+| Project Vibe | Best Language Families |
+|---|---|
+| Dev tools / Infrastructure | Japanese, Nordic, Latin, German |
+| Creative / AI / Workflows | Yoruba, Sanskrit, Maori, Swahili |
+| Minimalist SaaS / Analytics | Mandarin (Pinyin), Esperanto, Finnish |
+| Community / Social | Zulu, Hawaiian, Portuguese, Tagalog |
+| Security / Trust | Arabic, Norse, Latin, Greek |
+
+### Step 3: Phonetic Filtering
+
+Discard any translations that fail these checks:
+
+- [ ] Can a native English speaker spell it after hearing it once?
+- [ ] Is it <= 3 syllables?
+- [ ] Does it avoid unfortunate homophones in English, Spanish, French, or Portuguese?
+- [ ] Does it NOT require diacritics or special characters for the domain?
+- [ ] Is it distinct from existing major brands?
+
+### Step 4: Modifier Integration
+
+Attach industry-standard structural words to create a viable, registrable domain.
+
+**Reference:** Load `references/saas-modifiers.md` for the full modifier taxonomy.
+
+Quick modifier selection:
+
+| Product Type | Recommended Modifiers |
+|---|---|
+| Dev tools / APIs | Protocol, Core, Syntax, OS, Kit |
+| Creative tools | Forge, Labs, Studio, UI, Works |
+| Consumer apps | Get, Use, Run, App, Try |
+| Enterprise / Platform | HQ, Cloud, Suite, Base, Stack |
+
+### Step 5: Output Formatting
+
+Present results in a structured grid:
+
+```
+## Name Suggestions for [Product]
+
+### Tier 1: Top Picks
+| # | Name | Base Word | Origin | Meaning | Domain Suggestion | TLD Options |
+|---|------|-----------|--------|---------|-------------------|-------------|
+| 1 | KodoForge | Kodo | Japanese | Heartbeat / Pulse | kodoforge.dev | .dev, .io |
+| 2 | SareLabs | Sare | Yoruba | Run / Speed | sarelabs.com | .com, .io |
+| 3 | VahvaKit | Vahva | Finnish | Strong / Robust | vahvakit.dev | .dev, .com |
+
+### Tier 2: Strong Alternatives
+[... more options ...]
+
+### Tier 3: Creative Wild Cards
+[... experimental options ...]
+
+## Recommendation
+[Top pick with rationale]
+```
+
+**Always generate at minimum 10 names across all tiers.**
+
+## Constraints
+
+- **Never** suggest exact-match `.com` domains for single dictionary words without a disclaimer about extreme cost/unavailability.
+- **Never** use words with heavy cultural/religious significance (e.g., *Karma*, *Nirvana*, *Allah*, *Dharma*) unless the brand explicitly operates in that cultural space.
+- **Always** verify the transliterated word doesn't clash with English slang, profanity, or brand names.
+- **Always** present at least 3 TLD options per suggestion (.com, .dev, .io, .ai, .app, .co).
+- **Flag** any name where cultural appropriation risk exists with a `[!] Cultural Note` callout.
+
+## Pre-Mortem Checklist
+
+Before finalizing any name, run through these risk checks:
+
+1. **Cultural Appropriation** - Is the word sacred, ceremonial, or deeply tied to a marginalized group's identity? If yes, flag it.
+2. **Transliteration Drift** - Does the Romanized spelling diverge enough from the original to lose meaning or create confusion?
+3. **Accidental Homophones** - Cross-check against Spanish, French, Portuguese, German, and Mandarin for unintended meanings.
+4. **Trademark Collision** - Does a quick mental scan suggest overlap with existing tech brands?
+5. **Verbal Shareability** - Can someone say "Check out [Name]" in a conversation and have the listener spell it correctly?
+
+## Integration with Domain Brainstormer
+
+This skill complements the `domain-name-brainstormer` skill. Use **this skill** when the creative direction is "linguistically rich, globally inspired names." Use `domain-name-brainstormer` for straightforward English-based domain availability checking.

package/assets/.agent/skills/global-brand-namer/references/language-matrices.md

@@ -0,0 +1,196 @@
+# Language Matrices for Brand Aesthetics
+
+Select language families that match the structural "vibe" of the project. Each category includes curated words with proven phonetic appeal for English-speaking audiences.
+
+---
+
+## 1. "Forge & Precision" (Dev Tools, Infrastructure, APIs)
+
+Hard consonants, clean syllables, structural authority.
+
+### Japanese (Craftsmanship & Structure)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Kodo | Heartbeat / Pulse | 2 | High | Also evokes "code" |
+| Kaitaku | Pioneer / Trailblazer | 3 | Medium | Slightly long |
+| Takumi | Artisan / Master | 3 | High | Strong brand feel |
+| Tetsu | Iron / Steel | 2 | High | Very punchy |
+| Kaizen | Continuous improvement | 3 | High | Already well-known concept |
+| Shokunin | Craftsperson | 4 | Low | Too many syllables |
+| Tsukuru | To build / To create | 3 | Medium | Tricky "tsu" for English speakers |
+
+### Germanic / Nordic (Strength & Starkness)
+| Word | Language | Meaning | Syllables | Phonetic Score |
+|------|----------|---------|-----------|----------------|
+| Smidr | Icelandic | Builder / Smith | 2 | Medium |
+| Vahva | Finnish | Strong / Robust | 2 | High |
+| Verk | Norwegian | Work / Creation | 1 | High |
+| Stark | Swedish/German | Strong | 1 | High (but common brand) |
+| Bygga | Swedish | To build | 2 | Medium |
+| Tunna | Finnish | Hour / Grit | 2 | High |
+| Rauta | Finnish | Iron | 2 | High |
+
+### Latin (Foundational & Structural)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Novus | New | 2 | High | Clean, modern feel |
+| Faber | Maker / Builder | 2 | High | Root of "fabricate" |
+| Apex | Peak / Summit | 2 | High | Already used by some brands |
+| Nexus | Connection / Link | 2 | High | Strong but common |
+| Opus | Work / Masterpiece | 2 | High | Elegant |
+| Signum | Sign / Signal | 2 | High | Technical feel |
+| Vertex | Turning point | 2 | High | Mathematical authority |
+
+---
+
+## 2. "Energy & Flow" (Creative Tools, AI, Workflows)
+
+Vowel-rich endings, rhythmic quality, vitality.
+
+### Yoruba / West African (Vitality & Rhythm)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Irawo | Star | 3 | High | Beautiful sound, memorable |
+| Sare | Run / Speed | 2 | High | Punchy, action-oriented |
+| Agbara | Power / Force | 3 | High | Strong vowel pattern |
+| Emi | Spirit / Vibe | 2 | High | Short, evocative |
+| Adura | Prayer / Invocation | 3 | Medium | Spiritual connotation |
+| Ilera | Health / Wellness | 3 | High | Smooth flow |
+| Asa | Culture / Tradition | 2 | High | Very clean |
+| Owo | Money / Wealth | 2 | High | Commercial appeal |
+
+### Sanskrit (Sequence, Mind & Connection)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Sutra | Thread / Formula | 2 | High | Well-known, elegant |
+| Prana | Breath / Life force | 2 | High | Wellness connotation |
+| Maya | Illusion / Creative power | 2 | High | Also a common name |
+| Tantra | Loom / Framework | 2 | High | Some cultural baggage |
+| Vidya | Knowledge | 2 | High | Clean academic feel |
+| Mantra | Sacred utterance | 2 | High | Overused in tech |
+| Rasa | Essence / Flavor | 2 | High | Elegant, culinary appeal |
+
+### Maori (Life-Force & Nature)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Mauri | Essence / Life force | 2 | High | Beautiful sound |
+| Hiko | Flash / Electricity | 2 | High | Punchy, tech-friendly |
+| Kaha | Strength / Ability | 2 | High | Simple, powerful |
+| Wairua | Spirit / Soul | 3 | Medium | Harder to spell |
+| Mana | Authority / Prestige | 2 | High | Known concept, gaming ties |
+| Aroha | Love / Compassion | 3 | High | Warm brand feel |
+
+### Swahili (Rhythm & Accessibility)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Haraka | Speed / Quick | 3 | High | Action-oriented |
+| Nguvu | Power / Strength | 2 | Medium | "Ng" tricky for English |
+| Pamoja | Together | 3 | High | Community feel |
+| Sawa | Okay / Right / Equal | 2 | High | Universal positive |
+| Bora | Best / Excellent | 2 | High | Clean, positive |
+| Jenga | Build | 2 | High | Known (game), but strong |
+
+---
+
+## 3. "Minimalist SaaS" (Productivity, Analytics, Data)
+
+Punchy monosyllables, universal roots, technical precision.
+
+### Mandarin (Pinyin - Single-Syllable Impact)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Zao | Build / Create | 1 | High | Very punchy |
+| Kuai | Fast / Quick | 1 | High | Clean sound |
+| Ming | Bright / Clear | 1 | High | Already common as name |
+| Liang | Measure / Quantity | 2 | High | Data/analytics vibe |
+| Shu | Number / Data | 1 | High | Analytics perfect |
+| Yun | Cloud | 1 | High | Cloud computing natural |
+| Huo | Fire / Spark | 1 | High | Energy, startup vibe |
+
+### Esperanto (Universal & Intuitive)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Krei | Create | 1 | High | Short, active |
+| Bazo | Base / Foundation | 2 | High | Structural |
+| Rapida | Fast / Quick | 3 | Medium | A bit long |
+| Fluo | Flow | 2 | High | Natural, smooth |
+| Nova | New | 2 | High | Universal recognition |
+| Klara | Clear / Bright | 2 | High | Transparency feel |
+
+### Korean (Clean Minimalism)
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Nuri | World / Enjoy | 2 | High | Friendly, warm |
+| Baram | Wind / Wish | 2 | High | Aspirational |
+| Dari | Bridge | 2 | High | Connection metaphor |
+| Haru | Day / One day | 2 | High | Simple, bright |
+| Saem | Spring / Source | 1 | High | Origin/source concept |
+
+---
+
+## 4. "Community & Social" (Social Platforms, Collaboration)
+
+Warm vowels, approachable sounds, communal meaning.
+
+### Zulu / Southern African
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Ubuntu | Humanity / Togetherness | 3 | High | Very well-known |
+| Simba | Strength / Lion | 2 | High | Known (Disney), bold |
+| Amandla | Power | 3 | High | Political resonance |
+
+### Hawaiian
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Ohana | Family | 3 | High | Very well-known |
+| Aloha | Love / Greeting | 3 | High | Universal recognition |
+| Moku | Island / District | 2 | High | Clean, distinctive |
+| Lani | Sky / Heaven | 2 | High | Ethereal, beautiful |
+
+### Portuguese / Brazilian
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Brio | Vigor / Vivacity | 2 | High | Punchy, energetic |
+| Alma | Soul | 2 | High | Warm, human |
+| Nexo | Link / Connection | 2 | High | Tech-friendly |
+| Vivo | Alive / Living | 2 | High | Already a telecom brand |
+
+---
+
+## 5. "Security & Trust" (Cybersecurity, Fintech, Enterprise)
+
+Gravitas, authority, ancient reliability.
+
+### Arabic
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Aman | Safety / Security | 2 | High | Direct, trustworthy |
+| Qadr | Worth / Value | 1 | Medium | Hard "q" for English |
+| Sahm | Arrow / Share | 1 | High | Directional, financial |
+| Burj | Tower | 1 | High | Known (Burj Khalifa) |
+
+### Norse / Old English
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Aegis | Shield / Protection | 2 | High | Already used by some |
+| Fenrir | Great wolf | 2 | High | Mythological power |
+| Runa | Secret / Rune | 2 | High | Mystical authority |
+| Sigr | Victory | 1 | Medium | Short but uncommon |
+
+### Greek
+| Word | Meaning | Syllables | Phonetic Score | Notes |
+|------|---------|-----------|----------------|-------|
+| Archos | Leader / Ruler | 2 | High | Root of "architect" |
+| Kratos | Power / Strength | 2 | High | Known (gaming) |
+| Axios | Worthy | 3 | High | Already a media brand |
+| Pragma | Action / Deed | 2 | High | Root of "pragmatic" |
+
+---
+
+## Usage Notes
+
+- **Phonetic Score: High** = English speakers can spell it after hearing it once
+- **Phonetic Score: Medium** = May require one repetition or clarification
+- **Phonetic Score: Low** = Avoid unless the audience is multilingual
+- When a word is noted as "already used," it can still inspire derivatives (e.g., *KaizenKit*, *MantraOS*)
+- Words with cultural/spiritual weight are flagged in the Notes column

package/assets/.agent/skills/global-brand-namer/references/saas-modifiers.md

@@ -0,0 +1,132 @@
+# SaaS Domain Modifiers
+
+Bypass domain squatting by pairing foreign base words with functional modifiers. Select modifiers that reinforce the product's positioning.
+
+---
+
+## Structural / Protocol
+
+Best for: dev tools, APIs, infrastructure, SDKs, CLIs.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `[Name]Protocol` | irawoprotocol.dev | .dev, .io |
+| `[Name]Syntax` | kodosyntax.dev | .dev, .io |
+| `[Name]Core` | vahvacore.com | .com, .dev |
+| `[Name]OS` | sareos.dev | .dev, .io |
+| `[Name]Kit` | takumikit.dev | .dev, .com |
+| `[Name]SDK` | emosdk.dev | .dev |
+| `[Name]CLI` | zaocli.dev | .dev |
+| `[Name]Engine` | agbaraengine.com | .com, .io |
+| `[Name]Stack` | faberstack.dev | .dev, .com |
+| `[Name]Wire` | hikowire.io | .io, .dev |
+
+---
+
+## Creative / Studio
+
+Best for: design tools, creative platforms, visual builders, content tools.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `[Name]Forge` | kodoforge.dev | .dev, .com |
+| `[Name]Labs` | sarelabs.com | .com, .io |
+| `[Name]Studio` | irawostudio.com | .com, .design |
+| `[Name]UI` | vahvaui.dev | .dev, .design |
+| `[Name]Works` | takumiworks.com | .com, .io |
+| `[Name]Canvas` | emicanvas.com | .com, .design |
+| `[Name]Craft` | fabercraft.com | .com, .io |
+| `[Name]Space` | mauri.space | .space, .com |
+
+---
+
+## Action-Oriented
+
+Best for: consumer apps, productivity tools, high-velocity workflows.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `Get[Name]` | getvahva.com | .com, .app |
+| `Use[Name]` | usesare.com | .com, .io |
+| `[Name]App` | kodoapp.com | .com, .app |
+| `Run[Name]` | runagbara.com | .com, .io |
+| `Try[Name]` | tryhiko.com | .com, .app |
+| `[Name]Flow` | sareflow.com | .com, .io |
+| `[Name]Run` | vahvarun.com | .com, .app |
+| `[Name]Go` | emigo.app | .app, .com |
+
+---
+
+## Enterprise / Platform
+
+Best for: B2B SaaS, platforms, enterprise tools, data infrastructure.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `[Name]HQ` | irawohq.com | .com, .io |
+| `[Name]Cloud` | vahvacloud.com | .com, .io |
+| `[Name]Suite` | kodosuite.com | .com |
+| `[Name]Base` | faberbase.com | .com, .io |
+| `[Name]Hub` | sarehub.com | .com, .io |
+| `[Name]Platform` | agbaraplatform.com | .com |
+| `[Name]Ops` | vahvaops.com | .com, .dev |
+| `[Name]Dock` | hicodock.io | .io, .com |
+
+---
+
+## Data / Analytics
+
+Best for: analytics tools, data platforms, BI tools, observability.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `[Name]Data` | shudata.com | .com, .io |
+| `[Name]Metric` | liangmetric.com | .com, .io |
+| `[Name]Signal` | kodosingal.com | .com, .io |
+| `[Name]Pulse` | vahvapulse.com | .com, .io |
+| `[Name]Scope` | zaoscope.com | .com, .dev |
+| `[Name]Lens` | irawolens.com | .com, .io |
+| `[Name]Insight` | faberinsight.com | .com |
+
+---
+
+## Community / Social
+
+Best for: social platforms, community tools, collaboration software.
+
+| Pattern | Example | Best TLDs |
+|---------|---------|-----------|
+| `[Name]Circle` | pamojacircle.com | .com |
+| `[Name]Tribe` | irawotribe.com | .com, .io |
+| `[Name]Guild` | takumiguild.com | .com |
+| `[Name]Crew` | sarecrew.com | .com |
+| `[Name]Hive` | emihive.com | .com, .io |
+| `[Name]Club` | boraclub.com | .com |
+| `Join[Name]` | joinhiko.com | .com |
+
+---
+
+## TLD Selection Guide
+
+| TLD | Best For | Price Range | Trust Level |
+|-----|----------|-------------|-------------|
+| .com | Universal, businesses | $10-15/yr | Highest |
+| .io | Tech startups, dev tools | $30-50/yr | High (tech) |
+| .dev | Developer tools, APIs | $12-15/yr | High (tech) |
+| .ai | AI/ML products | $50-90/yr | High (AI) |
+| .app | Mobile/web apps | $14-20/yr | Medium-High |
+| .co | .com alternative | $25-35/yr | Medium |
+| .xyz | Creative, experimental | $10-12/yr | Medium |
+| .design | Design agencies | $30-40/yr | Niche |
+| .space | Creative projects | $10-15/yr | Low-Medium |
+
+---
+
+## Anti-Patterns (Avoid These)
+
+- **Double-modifier**: `GetKodoForge.com` -- too long, confusing
+- **Hyphens**: `kodo-forge.dev` -- hard to share verbally
+- **Numbers**: `kodo2.com` -- looks cheap, hard to remember
+- **Misspellings**: `kodoh.com` -- creates confusion, not clever
+- **Overly long compounds**: `vagbaraprotocolengine.com` -- nobody will type this
+- **Ambiguous abbreviations**: `vhv.io` -- meaningless, no brand recall

package/assets/.agent/skills/google-trends/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: google-trends
+description: Automated Google Trends research via Node.js CLI. Search YouTube, Web, Images, News for rising/breakout queries. Use for Phase 1 Strategy research or any topic validation.
+---
+
+# Google Trends Skill
+
+Automate Google Trends research without a browser. Query related topics, rising queries, and interest over time for any keyword across YouTube, Web, Images, or News.
+
+## Prerequisites
+
+Node.js 18+ and PNPM required.
+
+```powershell
+# Check Node
+node --version
+
+# Install dependencies (first-time only)
+cd .agent/skills/google-trends/scripts
+pnpm install
+```
+
+---
+
+## Quick Start
+
+```powershell
+# Basic search (YouTube, Last 7 Days, Tech category)
+node .agent/skills/google-trends/scripts/search.js -k "Claude AI"
+
+# Search Web instead of YouTube
+node .agent/skills/google-trends/scripts/search.js -k "AI agents" -p web
+
+# Extended time range (1 month)
+node .agent/skills/google-trends/scripts/search.js -k "VibeCoding" -t "now 1-m"
+
+# Output as JSON for piping
+node .agent/skills/google-trends/scripts/search.js -k "Cursor IDE" -o json
+```
+
+---
+
+## CLI Reference
+
+```
+Usage: search.js [options]
+
+Options:
+  -k, --keyword <string>    Topic to search (required)
+  -p, --property <string>   youtube | web | images | news | froogle (default: youtube)
+  -t, --time <string>       now 7-d | now 1-m | today 3-m | today 12-m (default: now 7-d)
+  -c, --category <number>   Google Trends category ID (default: 5 = Tech)
+  -o, --output <string>     table | json | markdown (default: table)
+  -f, --file <path>         Save output to file (optional)
+  --interest                Include interest-over-time data (default: false)
+  -h, --help                Show help
+```
+
+### Property Options
+
+| Value | What It Searches |
+|-------|------------------|
+| `youtube` | YouTube Search trends |
+| `web` | Google Web Search trends |
+| `images` | Google Images trends |
+| `news` | Google News trends |
+| `froogle` | Google Shopping trends |
+
+### Time Options
+
+| Value | Period |
+|-------|--------|
+| `now 7-d` | Last 7 days |
+| `now 1-m` | Last 30 days |
+| `today 3-m` | Last 90 days |
+| `today 12-m` | Last 12 months |
+
+### Category IDs (Common)
+
+| ID | Category |
+|----|----------|
+| 5 | Computers & Electronics (Tech) |
+| 13 | Arts & Entertainment |
+| 174 | Sports |
+| 3 | Business & Industrial |
+
+Full list: [Google Trends Categories](https://github.com/pat310/google-trends-api/wiki/Google-Trends-Categories)
+
+---
+
+## Example Workflows
+
+### YouTube Phase 1 Research
+
+Use this skill during `/youtube-phase1-strategy` to validate topics:
+
+```powershell
+# Check if "Claude Cowork" is rising on YouTube
+node .agent/skills/google-trends/scripts/search.js -k "Claude Cowork" -p youtube -t "now 7-d"
+```
+
+**Signal:** Look for `BREAKOUT` or values > 100 in related queries.
+
+### General Topic Validation
+
+```powershell
+# Is "RAG" still trending in AI?
+node .agent/skills/google-trends/scripts/search.js -k "RAG AI" -p web -t "today 3-m" --interest
+```
+
+**Signal:** Check if interest-over-time is increasing or peaked.
+
+---
+
+## Output Formats
+
+### Table (Default)
+```
+[TrendProbe] Searching: "Claude AI" on YouTube (Last 7 days)
+
+--- Related Queries (Top) ---
+1. claude ai assistant (100)
+2. anthropic claude (81)
+3. claude vs chatgpt (45)
+
+--- Related Queries (Rising) ---
+1. anthropic (BREAKOUT)
+2. claude code (450%)
+```
+
+### JSON
+```json
+{
+  "keyword": "Claude AI",
+  "property": "youtube",
+  "time": "now 7-d",
+  "top": [...],
+  "rising": [...]
+}
+```
+
+### Markdown
+```markdown
+## Claude AI (YouTube, 7 days)
+### Top Queries
+1. claude ai assistant (100)
+...
+```
+
+---
+
+## Tips
+
+1. **BREAKOUT = Gold.** A "BREAKOUT" query has grown > 5000% — this is a proven opportunity.
+2. **Cross-validate.** Use with YouTube Studio Trends and Competitor VidIQ for 3-source validation.
+3. **Try multiple keywords.** "Claude AI" vs "Claude Cowork" vs "Anthropic Claude" may reveal different signals.
+4. **Category matters.** Category 5 (Tech) gives tech-focused results; omit `-c` for broader trends.

package/assets/.agent/skills/google-trends/scripts/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "google-trends-cli",
+  "version": "1.0.0",
+  "description": "CLI for Google Trends research automation",
+  "main": "search.js",
+  "type": "module",
+  "scripts": {
+    "search": "node search.js"
+  },
+  "keywords": ["google-trends", "youtube", "research"],
+  "author": "J STAR FILMS",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "google-trends-api": "^4.9.2"
+  }
+}

package/assets/.agent/skills/google-trends/scripts/pnpm-lock.yaml

@@ -0,0 +1,31 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      commander:
+        specifier: ^12.0.0
+        version: 12.1.0
+      google-trends-api:
+        specifier: ^4.9.2
+        version: 4.9.2
+
+packages:
+
+  commander@12.1.0:
+    resolution: {integrity: sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==}
+    engines: {node: '>=18'}
+
+  google-trends-api@4.9.2:
+    resolution: {integrity: sha512-gjVSHCM8B7LyAAUpXb4B0/TfnmpwQ2z1w/mQ2bL0AKpr2j3gLS1j2YOnifpfsGJRxAGXB/NoC+nGwC5qSnZIiA==}
+
+snapshots:
+
+  commander@12.1.0: {}
+
+  google-trends-api@4.9.2: {}