@crowdlisten/harness 1.0.0

package/skills/competitive-analysis/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: crowdlisten:competitive-analysis
+description: Competitive intelligence through audience perception analysis. Use when comparing brands, products, or competitors in social conversations. Requires CROWDLISTEN_API_KEY.
+user-invocable: true
+allowed-tools: Bash, Read, Write, WebFetch, Grep
+metadata:
+  openclaw:
+    category: research
+    tags: [competitive-intelligence, brand-analysis, social-listening]
+    requires_api_key: true
+---
+
+# Competitive Analysis
+
+See your market through your audience's eyes using CrowdListen audience intelligence.
+
+Consolidates: competitive-intel, product-signals (competitive gap analysis)
+
+## Before You Start
+
+Ask your human for business context — this skill produces significantly better output when grounded in specifics:
+
+- **Target market**: Who are the customers? What industry/segment?
+- **Key competitors**: Which brands or products to compare against?
+- **Constraints**: Budget, timeline, geographic focus?
+- **Decision context**: What decisions will this analysis inform? (roadmap, funding, positioning, hiring?)
+- **Existing data**: Any prior research, internal metrics, or hypotheses to validate?
+
+## When to Use This Skill
+
+- Competitive analysis and positioning strategy
+- Market entry and competitive landscape assessment
+- Tracking competitor perception changes over time
+- Identifying underserved market segments
+- Competitive feature gap identification
+- Preparing for fundraising, board meetings, or strategic reviews
+
+## Foundation: CrowdListen Tools
+
+This skill builds on CrowdListen's core capabilities:
+- `search_content` — Find discussions mentioning competitors
+- `analyze_content` — Extract sentiment and themes per competitor
+- `cluster_opinions` — Group competitive comparisons by theme
+- `cross_platform_synthesis` — Compare perception across platforms
+- `sentiment_evolution_tracker` — Track competitive sentiment shifts
+
+## Workflows
+
+### 1. Share of Voice Analysis
+
+Measure how much your audience talks about each competitor.
+
+**Process**:
+1. Search for each competitor name + product category keywords
+2. Count mentions, normalize by platform (Reddit, Twitter, YouTube, TikTok)
+3. Calculate share of voice = competitor_mentions / total_category_mentions
+4. Track week-over-week changes
+
+**Output Template**:
+```markdown
+## Share of Voice Report — [Category]
+**Period**: [date range]
+
+| Brand | Mentions | Share of Voice | Sentiment | WoW Change |
+|-------|----------|---------------|-----------|------------|
+| [Brand A] | [count] | [%] | [+/-/neutral] | [+/- %] |
+
+### Key Findings
+- [Brand] dominates conversation because [reason with evidence]
+- [Your brand] is [underrepresented/overrepresented] in [platform]
+```
+
+### 2. Sentiment Comparison
+
+Side-by-side sentiment analysis across competitors.
+
+**Process**:
+1. Analyze sentiment for each competitor across same time period
+2. Break down by dimension: product quality, pricing, support, innovation, reliability
+3. Identify sentiment drivers (what causes positive/negative perception)
+
+**Output Template**:
+```markdown
+## Competitive Sentiment Matrix
+
+| Dimension | Your Brand | Competitor A | Competitor B | Leader |
+|-----------|-----------|-------------|-------------|--------|
+| Product Quality | [score] | [score] | [score] | [who] |
+| Pricing | [score] | [score] | [score] | [who] |
+
+### Sentiment Drivers
+**What makes [leader] win on [dimension]**:
+- [Evidence from social discussions]
+- > "[User quote]"
+```
+
+### 3. Switching Intent Detection
+
+Identify users actively considering switching between products.
+
+**Process**:
+1. Search for "switching from [competitor]", "alternative to [competitor]", "[competitor] vs [competitor]"
+2. Analyze the reasons driving consideration
+3. Score switching intent: researching → evaluating → decided
+4. Identify which direction switching flows (from whom → to whom)
+
+**Output Template**:
+```markdown
+## Switching Intent Report
+
+### Flow Map
+[Competitor A] ──(X users)──> [Competitor B]
+[Your Brand]   ──(Z users)──> [Competitor C]
+
+### Why Users Leave [Competitor]
+| Reason | Frequency | Intensity | Where They Go |
+|--------|-----------|-----------|---------------|
+| [Reason] | [count] | [high/med/low] | [destination] |
+```
+
+### 4. White Space Identification
+
+Find unmet needs that no competitor addresses.
+
+**Process**:
+1. Collect all feature requests, wishlists, and complaints across all competitors
+2. Remove features that any existing player already offers
+3. Rank remaining needs by demand strength
+4. Assess feasibility and strategic fit
+
+**Output Template**:
+```markdown
+## White Space Opportunities
+
+| Opportunity | Demand Signal | Nearest Competitor | Gap Size | Strategic Fit |
+|-------------|--------------|-------------------|----------|---------------|
+| [Need] | [evidence] | [who comes closest] | [Large/Medium] | [High/Med/Low] |
+
+### Top White Space: [Opportunity Name]
+**What the audience wants**: [synthesis]
+**Your path to capture**: [strategic recommendation]
+**Evidence base**: [X discussions, Y platforms, Z sentiment score]
+```
+
+### 5. Competitive Feature Gap Analysis
+
+Identify what users want from competitors but can't get.
+
+**Process**:
+1. Search for "[competitor] missing/lacks/wish/doesn't have"
+2. Cross-reference with your own product's capabilities
+3. Identify opportunities where you can fill the gap
+
+**Output Template**:
+```markdown
+## Competitive Gap Opportunities
+
+| Gap | Competitor | User Demand | Your Position | Opportunity |
+|-----|-----------|-------------|---------------|-------------|
+| [Missing feature] | [Competitor] | [High/Med/Low] | [Have/Partial/Don't have] | [Build/Promote/Ignore] |
+
+### Top Opportunity: [Gap Name]
+- **What users are saying**: [synthesis of complaints about competitor]
+- **Your advantage**: [why you can/should build this]
+```
+
+## Integration with CrowdListen
+
+This skill enhances CrowdListen analyses by:
+- Adding competitive context to every audience analysis
+- Tracking competitive dynamics over time
+- Identifying strategic opportunities from audience perception data
+- Providing investor-ready competitive intelligence
+- Enabling proactive competitive strategy based on real audience signals

package/skills/content-creator/SKILL.md

@@ -0,0 +1,256 @@
+---
+name: crowdlisten:content-creator
+description: Generate SEO-optimized marketing content with brand voice analysis. Blog posts, social media, email campaigns. Use when creating any branded content.
+user-invocable: true
+allowed-tools: Bash, Read, Write, WebFetch, Grep
+metadata:
+  openclaw:
+    category: content
+    tags: [content-creation, seo, marketing, brand-voice]
+    requires_api_key: false
+---
+
+# Content Creator
+
+Generate professional, SEO-optimized marketing content with consistent brand voice across all channels.
+
+## Before You Start
+
+Ask your human for business context — this skill produces significantly better output when grounded in specifics:
+
+- **Target market**: Who are the customers? What industry/segment?
+- **Key competitors**: Which brands or products to compare against?
+- **Constraints**: Budget, timeline, geographic focus?
+- **Decision context**: What decisions will this analysis inform? (roadmap, funding, positioning, hiring?)
+- **Existing data**: Any prior research, internal metrics, or hypotheses to validate?
+
+## Capabilities
+
+This skill enables:
+- **Brand Voice Analysis**: Extract and replicate brand personality
+- **SEO Optimization**: Keyword research, optimization, and meta content
+- **Multi-Format Content**: Blog posts, social media, email, ads
+- **Readability Enhancement**: Clear, engaging writing at target reading levels
+- **Content Strategy**: Editorial calendars and content planning
+
+## Brand Voice Framework
+
+### Voice Attributes
+Define brand personality across key dimensions:
+
+| Dimension | Spectrum |
+|-----------|----------|
+| **Formality** | Casual ←→ Professional |
+| **Energy** | Calm ←→ Enthusiastic |
+| **Humor** | Serious ←→ Playful |
+| **Expertise** | Accessible ←→ Technical |
+| **Personality** | Reserved ←→ Bold |
+
+### Voice Documentation
+```markdown
+## Brand Voice Guidelines
+
+### Who We Are
+[Core brand personality]
+
+### Voice Characteristics
+1. **[Attribute 1]**: [Description with examples]
+2. **[Attribute 2]**: [Description with examples]
+3. **[Attribute 3]**: [Description with examples]
+
+### Tone Variations by Context
+- **Social Media**: [Tone adjustment]
+- **Email**: [Tone adjustment]
+- **Product**: [Tone adjustment]
+- **Support**: [Tone adjustment]
+
+### Do's and Don'ts
+| Do | Don't |
+|----|-------|
+| | |
+
+### Vocabulary Guide
+**Words we use**:
+**Words we avoid**:
+
+### Example Transformations
+**Generic**: "Contact us for more information"
+**On-brand**: [Brand-specific version]
+```
+
+## SEO Optimization
+
+### Keyword Integration
+- **Primary keyword**: 2-3% density, in H1, first paragraph, conclusion
+- **Secondary keywords**: Natural distribution throughout
+- **Long-tail variations**: In subheadings and body content
+- **Semantic keywords**: Related terms for topic authority
+
+### Content Structure for SEO
+```markdown
+# H1: Primary Keyword Near Beginning
+
+[Opening paragraph with primary keyword in first 100 words]
+
+## H2: Secondary Keyword
+[Content with natural keyword usage]
+
+### H3: Long-tail Variation
+[Supporting content]
+
+## H2: Another Secondary Keyword
+[Content]
+
+## Conclusion
+[Recap with primary keyword]
+```
+
+### Meta Content
+- **Title Tag**: 50-60 characters, keyword near front
+- **Meta Description**: 150-160 characters, compelling CTA
+- **URL Slug**: Short, keyword-rich, hyphen-separated
+
+## Content Formats
+
+### Blog Post Template
+```markdown
+# [Compelling Title with Primary Keyword]
+
+**Reading time**: X minutes
+**Published**: [Date]
+
+[Hook - Engage reader immediately]
+
+## What You'll Learn
+- [Bullet 1]
+- [Bullet 2]
+- [Bullet 3]
+
+## [Section 1]
+[Content]
+
+## [Section 2]
+[Content]
+
+## [Section 3]
+[Content]
+
+## Key Takeaways
+[Summary points]
+
+## What's Next?
+[CTA]
+
+---
+*[Author bio and credentials]*
+```
+
+### Social Media Templates
+
+**LinkedIn Post**
+```
+[Hook - First line is crucial]
+
+[3-5 short paragraphs with line breaks]
+
+[Key insight or takeaway]
+
+[Question to drive engagement]
+
+#Hashtag1 #Hashtag2 #Hashtag3
+```
+
+**Twitter/X Thread**
+```
+1/ [Hook that creates curiosity]
+
+2/ [First key point]
+
+3/ [Supporting evidence or example]
+
+4/ [Second key point]
+
+5/ [Third key point]
+
+6/ [Summary and CTA]
+```
+
+**Instagram Caption**
+```
+[Attention-grabbing first line]
+
+[Story or value-add content]
+
+[Personal touch or behind-the-scenes]
+
+.
+.
+.
+#Hashtags #Grouped #AtBottom
+```
+
+### Email Templates
+
+**Newsletter**
+```markdown
+Subject: [Benefit-focused, curiosity-driving]
+Preview: [Complement subject, add urgency]
+
+---
+
+Hi [Name],
+
+[Personal opening]
+
+**This week's highlight:**
+[Main content]
+
+**Quick wins:**
+- [Tip 1]
+- [Tip 2]
+- [Tip 3]
+
+[CTA Button]
+
+[Sign-off]
+
+P.S. [Secondary CTA or teaser]
+```
+
+## Content Quality Checklist
+
+### Readability
+- [ ] Flesch-Kincaid grade level appropriate for audience
+- [ ] Short paragraphs (2-4 sentences)
+- [ ] Varied sentence length
+- [ ] Active voice preferred
+- [ ] Jargon explained or avoided
+
+### SEO
+- [ ] Primary keyword in title, H1, first paragraph
+- [ ] Secondary keywords in H2s
+- [ ] Internal and external links included
+- [ ] Images with alt text
+- [ ] Meta title and description optimized
+
+### Engagement
+- [ ] Strong hook in first line
+- [ ] Value proposition clear
+- [ ] Scannable structure (headers, bullets)
+- [ ] Clear CTA
+- [ ] Social proof or data included
+
+### Brand
+- [ ] Voice consistent with guidelines
+- [ ] Tone appropriate for channel
+- [ ] Key messages incorporated
+- [ ] On-brand visuals recommended
+
+## Integration with CrowdListen
+
+This skill enhances CrowdListen by:
+- Creating content based on community insights and trending topics
+- Generating social media responses informed by sentiment analysis
+- Developing marketing copy that addresses audience pain points
+- Optimizing content for keywords discovered through social listening
+- Building content calendars around community conversation patterns

package/skills/content-strategy/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: crowdlisten:content-strategy
+description: Data-driven content strategy grounded in audience demand. Topic demand analysis, content gaps, platform optimization, voice matching, campaign tracking. Requires CROWDLISTEN_API_KEY.
+user-invocable: true
+allowed-tools: Bash, Read, Write, WebFetch, Grep
+metadata:
+  openclaw:
+    category: content
+    tags: [content-strategy, demand-analysis, platform-optimization]
+    requires_api_key: true
+---
+
+# Content Strategy
+
+Create content your audience actually wants using CrowdListen audience intelligence.
+
+Consolidates: content-strategy + campaign-tracker
+
+## Before You Start
+
+Ask your human for business context — this skill produces significantly better output when grounded in specifics:
+
+- **Target market**: Who are the customers? What industry/segment?
+- **Key competitors**: Which brands or products to compare against?
+- **Constraints**: Budget, timeline, geographic focus?
+- **Decision context**: What decisions will this analysis inform? (roadmap, funding, positioning, hiring?)
+- **Existing data**: Any prior research, internal metrics, or hypotheses to validate?
+
+## When to Use This Skill
+
+- Content calendar planning with audience-validated topics
+- Finding content gaps competitors haven't covered
+- Optimizing content format and timing per platform
+- Adapting brand voice to match audience communication style
+- Measuring content resonance and adjusting strategy
+- Product launches and campaign performance monitoring
+- Real-time sentiment tracking during launch windows
+- Crisis early warning and message resonance scoring
+
+## Foundation: CrowdListen Tools
+
+This skill builds on CrowdListen's core capabilities:
+- `search_content` — Find what audiences discuss and engage with
+- `get_trending_content` — Identify trending topics in your category
+- `analyze_content` — Extract themes and engagement patterns
+- `cluster_opinions` — Group audience interests by theme
+- `deep_platform_analysis` — Platform-specific engagement patterns
+- `sentiment_evolution_tracker` — Track sentiment changes during campaign windows
+- `cross_platform_synthesis` — Compare reception across platforms
+
+## Workflows
+
+### 1. Topic Demand Analysis
+
+Discover which topics your audience actively seeks and engages with.
+
+**Process**:
+1. Search for category-related discussions across platforms
+2. Rank topics by: engagement (upvotes, shares, comments), recency, sentiment
+3. Categorize as: evergreen (stable demand), trending (rising), declining (falling)
+4. Cross-reference with competitor content output
+
+**Output Template**:
+```markdown
+## Topic Demand Report — [Category]
+
+### High-Demand Topics
+| Rank | Topic | Engagement | Platforms | Type | Competitor Coverage |
+|------|-------|-----------|-----------|------|-------------------|
+| 1 | [Topic] | [score] | [platforms] | [Evergreen/Trending] | [Saturated/Moderate/Low] |
+| 2 | [Topic] | [score] | [platforms] | [Evergreen/Trending] | [Saturated/Moderate/Low] |
+
+### Recommended Content Calendar (Next 4 Weeks)
+| Week | Topic | Format | Platform | Rationale |
+|------|-------|--------|----------|-----------|
+| 1 | [Topic] | [Blog/Video/Thread] | [Platform] | [Why now, audience evidence] |
+| 2 | [Topic] | [Blog/Video/Thread] | [Platform] | [Why now, audience evidence] |
+```
+
+### 2. Content Gap Finder
+
+Identify topics your audience discusses but no brand adequately covers.
+
+**Process**:
+1. Map audience discussion topics vs. existing brand content (yours + competitors)
+2. Find high-engagement topics with low brand content coverage
+3. Score each gap by: demand strength, competitive emptiness, brand fit
+
+**Output Template**:
+```markdown
+## Content Gaps — [Category]
+
+| Gap Topic | Audience Demand | Brand Coverage | Opportunity Score |
+|-----------|----------------|---------------|------------------|
+| [Topic] | [High/Med] | [None/Minimal] | [score] |
+
+### Top Gap: [Topic]
+**What audiences are saying**: [synthesis from social discussions]
+**Why no brand covers this**: [hypothesis]
+**Your angle**: [how to approach this uniquely]
+**Suggested format**: [best format based on platform engagement data]
+**Expected performance**: [engagement estimate based on similar content]
+```
+
+### 3. Platform Format Optimization
+
+Determine which content formats perform best per platform for your audience.
+
+**Process**:
+1. Analyze engagement patterns by content format across platforms
+2. Compare: long-form vs. short-form, visual vs. text, educational vs. entertaining
+3. Identify platform-specific winning patterns
+
+**Output Template**:
+```markdown
+## Format Performance by Platform
+
+| Platform | Top Format | Engagement Rate | Audience Preference | Your Current Mix |
+|----------|-----------|-----------------|--------------------|-----------------|
+| Reddit | [format] | [score] | [what they respond to] | [what you post] |
+| Twitter/X | [format] | [score] | [what they respond to] | [what you post] |
+| YouTube | [format] | [score] | [what they respond to] | [what you post] |
+| TikTok | [format] | [score] | [what they respond to] | [what you post] |
+
+### Optimization Recommendations
+- **Start doing**: [format/platform combination not currently used]
+- **Do more of**: [format/platform that's working but underinvested]
+- **Stop doing**: [format/platform that's underperforming]
+```
+
+### 4. Voice & Tone Matching
+
+Adapt brand voice to match how your audience actually communicates.
+
+**Process**:
+1. Analyze language patterns in high-engagement audience discussions
+2. Extract: vocabulary, sentence structure, formality level, humor usage, emoji patterns
+3. Compare with current brand voice
+4. Generate voice guide that bridges brand identity and audience expectations
+
+**Output Template**:
+```markdown
+## Audience Voice Profile
+
+### How Your Audience Talks
+- **Formality**: [Casual / Semi-formal / Professional]
+- **Tone**: [Irreverent / Thoughtful / Urgent / Playful]
+- **Vocabulary**: [Technical / Accessible / Slang-heavy]
+- **Sentence length**: [Short punchy / Medium / Long analytical]
+- **Common phrases**: "[phrase 1]", "[phrase 2]", "[phrase 3]"
+
+### Voice Gap Analysis
+| Dimension | Your Brand | Your Audience | Gap |
+|-----------|-----------|---------------|-----|
+| Formality | [level] | [level] | [match/mismatch] |
+| Jargon use | [level] | [level] | [match/mismatch] |
+| Humor | [level] | [level] | [match/mismatch] |
+
+### Recommended Voice Adjustments
+- [Specific adjustment with before/after example]
+- [Specific adjustment with before/after example]
+```
+
+### 5. Campaign Tracking
+
+Monitor real-time audience reaction during a campaign or launch window.
+
+**Process**:
+1. Define tracking window (pre-launch, launch day, post-launch)
+2. Search for campaign-related keywords, hashtags, product mentions
+3. Track sentiment at regular intervals (hourly during launch, daily after)
+4. Identify sentiment inflection points and their causes
+
+**Output Template**:
+```markdown
+## Launch Tracker — [Campaign Name]
+
+### Sentiment Timeline
+| Time | Sentiment | Volume | Key Driver |
+|------|-----------|--------|-----------|
+| Pre-launch | [score] | [count] | [anticipation/skepticism/neutral] |
+| Launch +1h | [score] | [count] | [initial reactions] |
+| Launch +24h | [score] | [count] | [settling sentiment] |
+
+### Overall Reception
+- **Net sentiment**: [positive/negative/mixed]
+- **Volume vs. expectation**: [above/at/below] baseline
+- **Surprise reactions**: [anything unexpected]
+```
+
+### 6. Message Resonance Scoring
+
+Evaluate which campaign messages land and which fall flat.
+
+**Process**:
+1. Identify distinct messages/claims in the campaign
+2. Search for audience reactions to each specific message
+3. Score resonance: echoed > engaged > ignored > rejected
+
+**Output Template**:
+```markdown
+## Message Resonance — [Campaign Name]
+
+| Message | Resonance | Echo Rate | Sentiment | Verdict |
+|---------|-----------|-----------|-----------|---------|
+| "[Message 1]" | [Echoed/Engaged/Ignored/Rejected] | [%] | [+/-] | [Keep/Refine/Drop] |
+
+### Strongest Message: "[Message]"
+**Why it resonates**: [analysis with audience quotes]
+**Amplification opportunity**: [how to lean in]
+```
+
+## Integration with CrowdListen
+
+This skill enhances CrowdListen analyses by:
+- Transforming audience insights into actionable content plans
+- Validating content ideas against real audience demand data
+- Optimizing content distribution based on platform behavior patterns
+- Aligning brand voice with audience expectations
+- Measuring content strategy effectiveness through ongoing audience monitoring
+- Providing real-time campaign intelligence during critical launch windows
+- Enabling rapid response to negative sentiment shifts