opencode-skills-collection 4.0.52 → 4.0.54

package/bundled-skills/content-creator/references/social_media_optimization.md

@@ -1,317 +1,61 @@
-# Social Media Optimization Guide
-
-## Platform-Specific Best Practices
-
-### LinkedIn
-**Audience**: B2B professionals, decision-makers, thought leaders
-**Best Times**: Tuesday-Thursday, 8-10 AM and 5-6 PM
-**Optimal Length**: 1,300-2,000 characters for posts
-
-#### Content Formats
-- **Text Posts**: 1,300 characters optimal, use line breaks
-- **Articles**: 1,900-2,000 words, include 5+ images
-- **Videos**: 30 seconds - 10 minutes, native upload preferred
-- **Documents**: PDF carousels, 10-15 slides
-- **Polls**: 4 options max, 1-2 week duration
-
-#### Optimization Tips
-- First 2 lines are crucial (shown in preview)
-- Use emoji sparingly for visual breaks 
-- Include 3-5 relevant hashtags
-- Tag people and companies when relevant
-- Native video gets 5x more engagement
-- Post consistently (3-5x per week optimal)
-
-#### Algorithm Factors
-- Dwell time (time spent reading)
-- Comments valued over likes
-- Early engagement (first hour) crucial
-- Creator mode boosts reach
-- Replies to comments increase visibility
-
-### Twitter/X
-**Audience**: News junkies, tech enthusiasts, real-time conversation
-**Best Times**: Weekdays 9-10 AM and 7-9 PM
-**Optimal Length**: 100-250 characters
-
-#### Content Formats
-- **Single Tweets**: 250 characters, 1-2 hashtags
-- **Threads**: 5-15 tweets, numbered format
-- **Images**: 16:9 ratio, up to 4 per tweet
-- **Videos**: Up to 2:20, square or landscape
-- **Polls**: 2-4 options, 5 minutes - 7 days
-
-#### Optimization Tips
-- Front-load important information
-- Use threads for complex topics
-- Include visuals (2-3x more engagement)
-- Retweet with comment > regular RT
-- Schedule threads for consistency
-- Engage genuinely with replies
-
-#### Algorithm Factors
-- Engagement rate (likes, RTs, replies)
-- Relationship (mutual follows prioritized)
-- Recency over evergreen
-- Topic relevance to user interests
-- Link posts receive less reach
-
-### Instagram
-**Audience**: Visual-first, millennials & Gen Z, lifestyle focused
-**Best Times**: Weekdays 11 AM - 1 PM and 7-9 PM
-**Optimal Length**: 138-150 characters shown in preview
-
-#### Content Formats
-- **Feed Posts**: Square (1:1) or vertical (4:5)
-- **Stories**: 15 seconds max, vertical (9:16)
-- **Reels**: 15-90 seconds, vertical (9:16)
-- **Carousels**: 2-10 images/videos
-- **IGTV/Video**: 1-60 minutes
-
-#### Optimization Tips
-- First sentence crucial (caption preview)
-- Use up to 30 hashtags (5-10 in caption, rest in comment)
-- Carousel posts get highest engagement
-- Stories with polls/questions boost views
-- Reels get maximum organic reach
-- Post consistently (1-2 feed posts daily)
-
-#### Algorithm Factors
-- Relationship (DMs, comments, tags)
-- Interest (based on past interactions)
-- Timeliness (newer posts prioritized)
-- Frequency of app usage
-- Time spent on posts (saves valuable)
-
-### Facebook
-**Audience**: Broad demographic, community-focused, local businesses
-**Best Times**: Wednesday-Friday, 11 AM - 2 PM
-**Optimal Length**: 50-80 characters for posts
-
-#### Content Formats
-- **Text Posts**: 50-80 characters optimal
-- **Images**: 1200x630px for links
-- **Videos**: 1-3 minutes, square format
-- **Stories**: Same as Instagram
-- **Live Videos**: Minimum 10 minutes
-
-#### Optimization Tips
-- Native video gets priority
-- Ask questions to boost comments
-- Share to relevant groups
-- Use Facebook Creator Studio
-- Tag locations for local reach
-- Post 1-2 times per day max
-
-#### Algorithm Factors
-- Meaningful interactions (comments > reactions)
-- Video completion rate
-- Friends and family prioritized
-- Group posts get high visibility
-- Live videos get 6x engagement
-
-### TikTok
-**Audience**: Gen Z, entertainment-focused, trend-driven
-**Best Times**: 6-10 AM and 7-11 PM
-**Optimal Length**: 15-30 seconds
-
-#### Content Formats
-- **Videos**: 15 seconds - 10 minutes
-- **Aspect Ratio**: 9:16 vertical
-- **Sounds**: Trending audio crucial
-- **Effects**: Filters and transitions
-
-#### Optimization Tips
-- Hook viewers in first 3 seconds
-- Use trending sounds and hashtags
-- Create content for FYP, not followers
-- Post 1-4 times daily
-- Engage with comments quickly
-- Jump on trends within 24-48 hours
-
-#### Algorithm Factors
-- Completion rate most important
-- Shares and saves valued
-- Comment engagement
-- Following similar creators
-- Time spent on app
-
-## Content Optimization Strategies
-
-### Hashtag Strategy
-
-#### Research Methods
-1. **Competitor Analysis**: Study successful competitors
-2. **Platform Search**: Use native search for suggestions
-3. **Hashtag Tools**: RiteTag, Hashtagify, All Hashtag
-4. **Trending Topics**: Monitor daily/weekly trends
-5. **Brand Hashtags**: Create unique campaign tags
-
-#### Hashtag Mix Formula
-- 30% High-volume (1M+ posts)
-- 40% Medium-volume (100K-1M posts)
-- 30% Low-volume/Niche (<100K posts)
-
-#### Platform-Specific Guidelines
-- **Instagram**: 10-30 hashtags (mix in caption and first comment)
-- **LinkedIn**: 3-5 professional hashtags
-- **Twitter**: 1-2 hashtags max
-- **Facebook**: 1-3 hashtags
-- **TikTok**: 3-5 trending + niche tags
-
-### Visual Content Optimization
-
-#### Image Best Practices
-- **Resolution**: Minimum 1080px width
-- **File Size**: Under 5MB for faster loading
-- **Alt Text**: Always include for accessibility
-- **Branding**: Consistent filters/overlays
-- **Text Overlay**: Less than 20% of image
-
-#### Video Optimization
-- **Captions**: Always include (85% watch without sound)
-- **Thumbnail**: Custom, eye-catching
-- **Length**: Platform-specific optimal duration
-- **Format**: MP4 for best compatibility
-- **Aspect Ratio**: Vertical for stories/reels, square for feed
-
-### Caption Writing Formulas
-
-#### AIDA Formula
-- **Attention**: Hook in first line
-- **Interest**: Expand on the hook
-- **Desire**: Benefits and value
-- **Action**: Clear CTA
-
-#### PAS Formula
-- **Problem**: Identify pain point
-- **Agitate**: Emphasize consequences
-- **Solution**: Present your answer
-
-#### Before-After-Bridge
-- **Before**: Current situation
-- **After**: Desired outcome
-- **Bridge**: How to get there
-
-### Engagement Tactics
-
-#### Conversation Starters
-- Ask open-ended questions
-- Create polls and surveys
-- "Fill in the blank" posts
-- "This or that" choices
-- Caption contests
-- Opinion requests
-
-#### Community Building
-- Respond to comments within 2 hours
-- Like and reply to user comments
-- Share user-generated content
-- Create branded hashtags
-- Host Q&A sessions
-- Run challenges or contests
-
-### Analytics & KPIs
-
-#### Vanity Metrics (Track but don't obsess)
-- Follower count
-- Like count
-- View count
-
-#### Performance Metrics (Focus here)
-- Engagement rate: (Likes + Comments + Shares) / Reach × 100
-- Click-through rate: Clicks / Impressions × 100
-- Conversion rate: Conversions / Clicks × 100
-- Share/Save rate: Shares / Reach × 100
-
-#### Business Metrics (Ultimate goal)
-- Website traffic from social
-- Lead generation
-- Sales attribution
-- Customer acquisition cost
-- Customer lifetime value
-
-### Content Calendar Planning
-
-#### Weekly Posting Schedule Template
-```
-Monday: Motivational (Quote/Inspiration)
-Tuesday: Educational (How-to/Tips)
-Wednesday: Promotional (Product/Service)
-Thursday: Engaging (Poll/Question)
-Friday: Fun (Behind-scenes/Casual)
-Saturday: User-Generated Content
-Sunday: Curated Content/Rest
-```
-
-#### Monthly Theme Structure
-- Week 1: Awareness content
-- Week 2: Consideration content
-- Week 3: Decision content
-- Week 4: Retention/Community
-
-### Crisis Management Protocol
-
-#### Response Timeline
-- **0-15 minutes**: Acknowledge awareness
-- **15-60 minutes**: Gather facts
-- **1-2 hours**: Official response
-- **24 hours**: Follow-up update
-- **48-72 hours**: Resolution summary
-
-#### Response Guidelines
-1. Acknowledge quickly
-2. Take responsibility if appropriate
-3. Show empathy
-4. Provide facts only
-5. Outline action steps
-6. Follow up publicly
-
-## Tool Stack Recommendations
-
-### Content Creation
-- **Design**: Canva, Adobe Creative Suite
-- **Video**: CapCut, InShot, Adobe Premiere
-- **Copy**: Grammarly, Hemingway Editor
-- **AI Assistance**: ChatGPT, Claude, Jasper
-
-### Scheduling & Management
-- **All-in-One**: Hootsuite, Buffer, Sprout Social
-- **Visual-First**: Later, Planoly
-- **Enterprise**: Sprinklr, Khoros
-- **Free Options**: Meta Business Suite, TweetDeck
-
-### Analytics & Monitoring
-- **Native**: Platform Insights/Analytics
-- **Third-Party**: Socialbakers, Brandwatch
-- **Listening**: Mention, Brand24
-- **Competitor Analysis**: Social Blade, Rival IQ
-
-### Influencer & UGC
-- **Discovery**: AspireIQ, GRIN
-- **Management**: CreatorIQ, Klear
-- **UGC Curation**: TINT, Stackla
-- **Rights Management**: Rights Manager
-
-## Compliance & Best Practices
-
-### Legal Considerations
-- Include #ad or #sponsored for paid partnerships
-- Respect copyright and attribution
-- Follow GDPR for data collection
-- Comply with platform terms of service
-- Get permission for UGC usage
-
-### Accessibility Guidelines
-- Add alt text to all images
-- Include captions on videos
-- Use CamelCase for hashtags (#LikeThis)
-- Avoid text-only images
-- Ensure color contrast compliance
-
-### Brand Safety
-- Moderate comments regularly
-- Set up keyword filters
-- Have crisis management plan
-- Monitor brand mentions
-- Establish posting permissions
+# Social media adaptation and verification
+
+Use the actual audience, approved claims, account capabilities and production budget.
+A platform name does not identify a demographic or guarantee engagement. Previous
+fixed posting times, hashtag quotas and reach multipliers were unsupported and have
+been retired from this guide.
+
+## Choose the channel by the task
+
+| Channel | Drafting focus | Check before handoff |
+| --- | --- | --- |
+| LinkedIn | Explain a professional problem with a specific example | Current post/document options, accessible preview, permitted mentions |
+| X | Put the useful fact first; split only when needed | Current account character/media limits and thread order |
+| Instagram | Ensure the visual communicates and the caption adds context | Current feed/Reel/Story composer, crop, captions, alt-text support |
+| Facebook | Give the relevant community context and practical next step | Page/group permissions, current composer, link preview |
+| TikTok | Demonstrate one clear idea with readable captions | Current duration/audio rights, safe crop and native preview |
+
+Check these details in the current native composer and the platform's official help.
+Do not bypass account restrictions, upload a test publicly, or acquire new paid tools
+just to complete a draft. Use existing tools and authorized read-only account data.
+
+## Adapt without changing the facts
+
+1. Identify one audience question and the approved source that answers it.
+2. Draft the shortest complete answer for that channel. Preserve qualifications,
+   prices, dates and limitations from the source.
+3. Preview text, links, crops, contrast and captions. Do not put essential information
+   only in an image. Use relevant tags and mentions; avoid engagement bait.
+4. Confirm rights for music, images and user content, and the required disclosures
+   with the campaign owner. This checklist is not a legal compliance determination.
+5. Return draft, assets, source links and a suggested slot with timezone. Sending or
+   scheduling needs the user's existing authorization; do not infer it from drafting.
+
+## Measure an actual question
+
+Start with one outcome such as qualified visits to a help article. Define denominator,
+window, timezone, source and missing-data handling before comparing posts. Separate
+reach, impressions, clicks, saves and conversions; platforms define them differently.
+An engagement rate can be interactions / reach when those counts cover the same
+population and window. If reach is zero or unavailable, report no rate, not zero.
+Attribution does not establish causality. A small successful post is not proof of an
+algorithm rule or a universally optimal time.
+
+Test a small number of timing/format hypotheses using account evidence and comparable
+content. Record audience, creative, paid support and seasonality as possible confounders.
+Use the content calendar's performance review to retain useful lessons, with no hidden
+analytics or automatic export of account data.
+
+## Worked adaptation
+
+For an approved help article about CSV export, prepare a product screenshot with
+captions and a short explanation of where export lives. Link to the source where the
+channel supports it. Verify the destination and crop in preview. Record the proposed
+publication time as a hypothesis, not an optimal slot. Expected handoff: a reviewable
+draft and preview checks; no post is sent and no engagement increase is claimed.
+
+## Community and incidents
+
+Respond within the team's agreed coverage, with verified facts and an owner. Do not
+invent an incident cause or promise a resolution deadline. Escalate sensitive cases
+through the existing process; a draft response is not authorization to send it.

package/bundled-skills/content-creator/scripts/brand_voice_analyzer.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-Brand Voice Analyzer - Analyzes content to establish and maintain brand voice consistency
+Brand Voice Analyzer - local English lexical heuristics, not brand certification
 """
 
 import re
@@ -44,6 +44,7 @@ class BrandVoiceAnalyzer:
         word_count = len(text.split())
         
         results = {
+            'method': 'English lexical heuristics; not a validated brand or reading assessment',
             'word_count': word_count,
             'readability_score': self._calculate_readability(text),
             'voice_profile': {},
@@ -55,12 +56,13 @@ class BrandVoiceAnalyzer:
         for dimension, categories in self.voice_dimensions.items():
             dim_scores = {}
             for category, keywords in categories.items():
-                score = sum(1 for keyword in keywords if keyword in text_lower)
+                score = sum(1 for keyword in keywords if re.search(r'(?<!\w)' + re.escape(keyword) + r'(?!\w)', text_lower))
                 dim_scores[category] = score
             
             # Determine dominant voice
             if sum(dim_scores.values()) > 0:
-                dominant = max(dim_scores, key=dim_scores.get)
+                leaders = [key for key, value in dim_scores.items() if value == max(dim_scores.values())]
+                dominant = leaders[0] if len(leaders) == 1 else 'mixed'
                 results['voice_profile'][dimension] = {
                     'dominant': dominant,
                     'scores': dim_scores
@@ -73,7 +75,7 @@ class BrandVoiceAnalyzer:
     
     def _calculate_readability(self, text: str) -> float:
         """Calculate Flesch Reading Ease score"""
-        sentences = re.split(r'[.!?]+', text)
+        sentences = [s.strip() for s in re.split(r'[.!?]+', text) if s.strip()]
         words = text.split()
         syllables = sum(self._count_syllables(word) for word in words)
         
@@ -89,7 +91,7 @@ class BrandVoiceAnalyzer:
     
     def _count_syllables(self, word: str) -> int:
         """Count syllables in a word (simplified)"""
-        word = word.lower()
+        word = re.sub(r"[^a-z]", "", word.lower())
         vowels = 'aeiou'
         syllable_count = 0
         previous_was_vowel = False
@@ -108,11 +110,11 @@ class BrandVoiceAnalyzer:
     
     def _analyze_sentences(self, text: str) -> Dict:
         """Analyze sentence structure"""
-        sentences = re.split(r'[.!?]+', text)
+        sentences = [s.strip() for s in re.split(r'[.!?]+', text) if s.strip()]
         sentences = [s.strip() for s in sentences if s.strip()]
         
         if not sentences:
-            return {'average_length': 0, 'variety': 'low'}
+            return {'average_length': 0, 'variety': 'low', 'count': 0}
         
         lengths = [len(s.split()) for s in sentences]
         avg_length = sum(lengths) / len(lengths) if lengths else 0
@@ -190,8 +192,11 @@ if __name__ == "__main__":
     import sys
     
     if len(sys.argv) > 1:
-        with safe_user_path(sys.argv[1]).open('r') as f:
-            content = f.read()
+        with safe_user_path(sys.argv[1]).open('rb') as f:
+            raw = f.read(1024 * 1024 + 1)
+        if len(raw) > 1024 * 1024:
+            raise SystemExit('Input exceeds 1 MiB')
+        content = raw.decode('utf-8')
         
         output_format = sys.argv[2] if len(sys.argv) > 2 else 'text'
         print(analyze_content(content, output_format))