@jairodri/huckleberry-cli 1.0.2 → 1.1.0

package/skills/voice-brand-alignment/references/ai-slop-patterns.md

@@ -0,0 +1,405 @@
+# AI Slop Detection Patterns
+
+Comprehensive list of artificial-sounding patterns that indicate content generated by AI without proper human refinement. These patterns make content feel generic, corporate, and inauthentic.
+
+---
+
+## Category 1: Corporate Buzzwords
+
+### High-Severity (Always Flag)
+- **"leverage"** - Use "use" instead
+- **"synergy"** - Be specific about what works together
+- **"ecosystem"** - Say "system", "network", or be specific
+- **"paradigm shift"** - Describe the actual change
+- **"game-changer"** - Explain why it matters specifically
+- **"circle back"** - Say "follow up" or "discuss later"
+- **"touch base"** - Say "connect", "talk", or "check in"
+- **"deep dive"** - Say "detailed look" or "analyze"
+- **"drill down"** - Say "examine" or "look closely at"
+- **"unpack"** - Say "explain" or "break down"
+- **"robust"** - Be specific about capabilities
+- **"scalable"** - Explain how it scales
+- **"best practices"** - Show the actual practices
+- **"thought leadership"** - Demonstrate expertise instead
+- **"end-to-end"** - Describe the complete process
+- **"holistic"** - Say "complete" or "comprehensive"
+- **"streamline"** - Explain how it's simplified
+- **"optimize"** - Show specific improvements
+- **"bandwidth"** - Say "time" or "capacity"
+- **"ping"** - Say "message" or "contact"
+
+### Medium-Severity (Warn)
+- **"solution"** (overused) - Be specific about what it solves
+- **"platform"** (generic) - Describe what it actually is
+- **"framework"** (vague) - Show the structure
+- **"approach"** (overused) - Describe the method
+- **"strategy"** (generic) - Detail the plan
+- **"innovative"** - Show what's new
+- **"cutting-edge"** - Prove it's advanced
+- **"state-of-the-art"** - Demonstrate superiority
+- **"next-generation"** - Explain the improvement
+- **"world-class"** - Provide evidence
+
+---
+
+## Category 2: Excessive Politeness
+
+### Email/DM Patterns
+- **"I'd love to hear your thoughts"** → "What do you think?"
+- **"I'd be happy to..."** → "I can..." or "Let me..."
+- **"Please let me know"** → "Let me know" or "Tell me"
+- **"If you could..."** → "Can you..."
+- **"Would you mind..."** → "Could you..."
+- **"I hope this helps"** → Remove (implicit)
+- **"Feel free to..."** → "You can..." or direct instruction
+- **"Don't hesitate to..."** → "Just..." or direct instruction
+
+### Social Media Patterns
+- **"I'd love to hear from you in the comments"** → "Drop your experience below"
+- **"Please share your thoughts"** → "What's your take?"
+- **"I'd be curious to know"** → "Which one works for you?"
+- **"Let me know what you think"** → "Think I'm wrong? Prove it."
+
+---
+
+## Category 3: Formal Transitions
+
+### Addition Transitions
+- **"Furthermore"** → "Also", "Plus", or new sentence
+- **"Additionally"** → "And", "Also", or remove
+- **"Moreover"** → Remove or start new paragraph
+- **"In addition"** → "Also" or restructure
+- **"What's more"** → Remove or use "And"
+
+### Conclusion Transitions
+- **"In conclusion"** → Remove (structure shows conclusion)
+- **"To summarize"** → Remove or "Here's what matters:"
+- **"In essence"** → Remove or "Simply:"
+- **"Ultimately"** → "The result:" or remove
+- **"At the end of the day"** → Remove or specific outcome
+
+### Contrast Transitions
+- **"However"** → "But", or new sentence with contrast
+- **"Nevertheless"** → "But still" or "Even so"
+- **"Nonetheless"** → "Still" or remove
+- **"On the contrary"** → "Actually" or remove
+- **"Conversely"** → "Instead" or restructure
+
+### Example Transitions
+- **"For instance"** → "Like:" or just show example
+- **"For example"** → Remove and show example
+- **"Such as"** → "like" or list examples
+- **"Namely"** → ":" or restructure
+
+---
+
+## Category 4: Generic Enthusiasm
+
+### Excitement Markers
+- **"Amazing!"** → Describe why it's good specifically
+- **"Incredible!"** → Show the impressive part
+- **"Awesome!"** → Be specific about value
+- **"Fantastic!"** → Detail what's good
+- **"Wonderful!"** → Explain the benefit
+- **"Excellent!"** → Show excellence
+
+### Announcement Patterns
+- **"Excited to share!"** → Remove, just share
+- **"Thrilled to announce..."** → Remove, just announce
+- **"Happy to present..."** → Remove, just present
+- **"Delighted to introduce..."** → Remove, just introduce
+- **"Proud to showcase..."** → Remove, just showcase
+- **"Can't wait to..."** → Remove or "Coming:" with date
+- **"Stay tuned!"** → Specific date/time or remove
+- **"Coming soon!"** → Give actual date or remove
+- **"More to come!"** → Be specific about what and when
+
+### Gratitude Overuse
+- **"Thank you so much for..."** (in content) → One "thanks" is enough
+- **"I really appreciate..."** (in content) → Show appreciation through value
+- **"Huge thanks to..."** (every post) → Occasional only
+
+---
+
+## Category 5: Hedge Language
+
+### Uncertainty Markers
+- **"I think"** → State directly or remove
+- **"Perhaps"** → Be definitive or explain uncertainty
+- **"Maybe"** → Choose or explain options
+- **"Possibly"** → Commit or explain variables
+- **"Probably"** → Be specific about likelihood
+- **"Potentially"** → Show potential or remove
+- **"It seems"** → Verify or state clearly
+- **"Appears to be"** → Confirm or specify
+- **"Could be"** → Investigate or state
+- **"Might"** → Be more certain or explain conditions
+- **"May"** → Be specific about conditions
+- **"Somewhat"** → Quantify or remove
+- **"Rather"** → Be definitive
+- **"Fairly"** → Quantify specifically
+- **"Quite"** → Remove or be specific
+
+### Qualification Softeners
+- **"In my opinion"** → Implied, remove
+- **"I believe"** → State directly
+- **"It's my understanding that"** → "It is" or verify
+- **"From my perspective"** → Implied, remove
+- **"As far as I know"** → Verify or state clearly
+- **"To be honest"** → Implies dishonesty otherwise, remove
+- **"To be frank"** → Just be frank
+- **"Generally speaking"** → Be specific or remove
+- **"For the most part"** → Quantify or remove
+
+---
+
+## Category 6: Passive Voice Overuse
+
+### Passive Construction Patterns
+- **"It can be seen that..."** → "You'll see..."
+- **"It should be noted that..."** → Remove, just note it
+- **"It is believed that..."** → "We believe" or "X believes"
+- **"It has been found that..."** → "Studies found" or "X found"
+- **"It is recommended that..."** → "I recommend" or "Do X"
+- **"It is important to..."** → "You should..." or "Do..."
+- **"It is suggested that..."** → "Try..." or "Do..."
+- **"It is worth noting that..."** → Remove and note it
+
+### Agency Removal
+- **"Mistakes were made"** → "I/We made mistakes"
+- **"The decision was made"** → "X decided"
+- **"Results were achieved"** → "We achieved results"
+- **"Progress has been made"** → "We've made progress"
+
+---
+
+## Category 7: Vague Quantifiers
+
+### Imprecise Numbers
+- **"Many"** → Give exact number or range
+- **"Several"** → Specify how many
+- **"Various"** → List them
+- **"Numerous"** → Count them
+- **"Countless"** → Estimate or acknowledge limitation
+- **"Significant"** → Quantify the significance
+- **"Substantial"** → Show the size
+- **"Considerable"** → Measure it
+- **"A lot of"** → Count or estimate
+
+### Vague Time References
+- **"Soon"** → Give date/timeframe
+- **"Later"** → When specifically?
+- **"Recently"** → When exactly?
+- **"In the near future"** → Specify timeline
+- **"Shortly"** → Give timeframe
+- **"Eventually"** → When?
+- **"Ongoing"** → Since when? Until when?
+
+### Vague Quality Descriptors
+- **"Good"** → Define criteria
+- **"Better"** → Better how? By what measure?
+- **"Improved"** → Improved in what way? By how much?
+- **"Enhanced"** → What enhancement?
+- **"Optimized"** → Optimized how?
+- **"Efficient"** → Efficient compared to what?
+- **"Effective"** → Define effectiveness metric
+
+---
+
+## Category 8: Cliché Phrases
+
+### Business Clichés
+- **"Think outside the box"** → Describe creative approach
+- **"Move the needle"** → Show specific impact
+- **"Low-hanging fruit"** → "Easy wins" or be specific
+- **"Win-win situation"** → Explain benefits to each party
+- **"At the end of the day"** → Remove or "Ultimately"
+- **"Take it to the next level"** → Describe improvement
+- **"Hit the ground running"** → "Start immediately with X"
+- **"Get the ball rolling"** → "Start by..."
+- **"Keep your eye on the ball"** → "Focus on X"
+- **"Step up to the plate"** → "Take responsibility for X"
+
+### Achievement Clichés
+- **"Going above and beyond"** → Show what extra was done
+- **"Pushing the envelope"** → Explain innovation
+- **"Breaking new ground"** → Detail the breakthrough
+- **"Paving the way"** → Show leadership
+- **"Raising the bar"** → Quantify improvement
+
+### Tech/AI Clichés (2024-2025)
+- **"Unlock the power of..."** → "Use X to do Y"
+- **"Harness the potential of..."** → "X enables you to..."
+- **"Transform your..."** → Show specific changes
+- **"Revolutionize..."** → Explain actual change
+- **"Supercharge your..."** → Quantify improvement
+- **"Take control of..."** → "Manage X by..."
+- **"Master the art of..."** → "Get good at X by..."
+
+---
+
+## Category 9: Filler Words & Phrases
+
+### Content Padding
+- **"It goes without saying"** → Then don't say it
+- **"Needless to say"** → Don't say it
+- **"It is worth mentioning"** → Just mention it
+- **"As you may know"** → Assume they don't, explain
+- **"As previously mentioned"** → Reference or remove
+- **"In other words"** → Pick better words first time
+- **"That being said"** → Restructure without
+- **"Having said that"** → Remove and make point
+- **"All things considered"** → Consider them, don't announce it
+- **"When all is said and done"** → Skip to conclusion
+
+### Redundant Pairs
+- **"Each and every"** → "Each" or "every"
+- **"First and foremost"** → "First" or "most important"
+- **"Any and all"** → "All"
+- **"Hopes and dreams"** → "Goals"
+- **"Tips and tricks"** → "Tips" or "tactics"
+- **"Ways and means"** → "Methods"
+- **"Pick and choose"** → "Choose"
+
+---
+
+## Category 10: Question Patterns
+
+### Rhetorical Questions (Overused)
+- **"So what does this mean?"** → Just explain it
+- **"What's the takeaway?"** → Just give takeaway
+- **"Why does this matter?"** → Just show why
+- **"How can you apply this?"** → Just show application
+- **"What can we learn from this?"** → Just share lesson
+
+### Good Question Patterns (Keep These)
+- Direct engagement: "Which one worked for you?"
+- Specific debate: "Think AI will replace X? Why?"
+- Experience sharing: "Ever tried this?"
+- Tactical choice: "Option A or B for your use case?"
+
+---
+
+## Category 11: Listicle Intro Phrases
+
+### Generic List Intros (Overused)
+- **"Here are X ways to..."** → Just list them
+- **"In this post, I'll share..."** → Just share it
+- **"Today, we're going to explore..."** → Just explore
+- **"Let's dive into..."** → Just dive in
+- **"Without further ado..."** → Remove completely
+- **"So let's get started..."** → Already started
+
+### Better Alternatives
+- Hook with outcome: "5 mistakes costing you $50K+"
+- Lead with problem: "Your automation fails because..."
+- Start with claim: "Product-ified services beat agencies. Here's why:"
+- Open with question: "Why do 80% of AI agencies fail?"
+
+---
+
+## Category 12: Call-to-Action Patterns
+
+### Weak CTAs (Generic)
+- **"Let me know your thoughts in the comments"** → Specific question
+- **"Share this if you found it helpful"** → Reason to share
+- **"Follow for more content like this"** → Value promise
+- **"Hit the like button"** → Remove (begging)
+- **"Subscribe to my newsletter"** → What they'll get
+- **"Check out the link in bio"** → What's at link?
+
+### Strong CTAs (Specific)
+- **"Drop your stack below"** - Action + topic
+- **"Which model fits your niche? Reply."** - Specific question
+- **"RT if FIXED > CUSTOM resonates"** - Tie to content
+- **"Grab the playbook → [link]"** - Clear offer
+- **"Try this today and tell me what breaks"** - Action + engagement
+
+---
+
+## Detection Strategy
+
+### Automated Scanning
+1. **Word frequency analysis** - Flag words appearing >2x in same piece
+2. **Phrase matching** - Check against pattern library
+3. **Passive voice ratio** - Flag if >20% of sentences
+4. **Question frequency** - Flag if >3 rhetorical questions
+5. **Transition density** - Flag excessive formal transitions
+
+### Manual Review
+1. **Read aloud test** - Does it sound like a human talking?
+2. **Specificity check** - Can vague terms be replaced with specifics?
+3. **Voice match** - Does it match brand voice profile?
+4. **Engagement test** - Would you stop scrolling for this?
+
+### Severity Scoring
+- **High (3 points)**: Corporate buzzwords, generic enthusiasm
+- **Medium (2 points)**: Excessive politeness, formal transitions
+- **Low (1 point)**: Minor hedge language, filler words
+
+**Total Score Interpretation**:
+- 0-3 points: Clean, authentic voice
+- 4-7 points: Needs polish
+- 8-12 points: Significant AI slop, major revision
+- 13+ points: Start over, too generic
+
+---
+
+## Brand-Specific Exceptions
+
+### withjai-weekly (Farm-to-Founder Voice)
+**Allowed "AI slop" in context**:
+- "Amazing" - Only when describing genuinely surprising results
+- "Excited" - Only in product announcements
+- "Game-changer" - Only with proof (revenue impact, time savings)
+
+**Encouraged patterns**:
+- Conversational asides: "Sounds wild—until..."
+- Direct commands: "Drop yours below"
+- Bold claims: "FIXED > CUSTOM"
+- No em-dashes (strict rule)
+
+### enchantents (Luxury Hospitality Voice)
+**Allowed formal language**:
+- "Exceptional" - Appropriate for luxury positioning
+- "Transform" - Guest experience transformation is key messaging
+- "Elevated" - Premium positioning word
+
+**Avoid casualizing**:
+- Keep professional tone (not too casual)
+- "Amazing" is okay for guest experiences
+- More formal than withjai-weekly (intentional)
+
+### xelite-one (Premium Coaching Voice)
+**Allowed authority language**:
+- "Transform" - Core messaging for coaching
+- "Leverage" - In context of assets/advantages
+- "Framework" - When describing methodology
+
+**Avoid softening**:
+- No hedge language (undermines authority)
+- Bold claims supported by proof
+- Direct, confident statements
+
+---
+
+## Replacement Suggestions by Context
+
+### Technical Content
+- ❌ "Leverage the API" → ✅ "Use the API"
+- ❌ "Optimize your workflow" → ✅ "Cut your workflow from 40 to 4 hours"
+- ❌ "Robust solution" → ✅ "Handles 10K requests/second"
+
+### Business Content
+- ❌ "Game-changing approach" → ✅ "Increased revenue 4x in 6 months"
+- ❌ "Streamline operations" → ✅ "Reduced costs by 30%"
+- ❌ "Paradigm shift" → ✅ "From custom → fixed deliverables"
+
+### Social Content
+- ❌ "Amazing insights!" → ✅ "These 5 models generate $40K+ monthly"
+- ❌ "Excited to share" → ✅ [Just share it]
+- ❌ "Let me know your thoughts" → ✅ "Which one fits your niche?"
+
+---
+
+This reference helps identify and eliminate AI-generated patterns that make content feel inauthentic, generic, or overly polished. Use it during voice validation to maintain human, engaging content across all platforms.

package/skills/voice-brand-alignment/scripts/validation/gemini-voice-validator.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const contentPath = args[0];
+const brand = args[1] || 'ai.withjai';
+const checks = args[2] || 'ai-slop,voice-patterns,icp-alignment';
+
+if (!contentPath || !fs.existsSync(contentPath)) {
+  console.error('Usage: node scripts/validation/gemini-voice-validator.js <contentPath> <brand> [checks]');
+  process.exit(1);
+}
+
+const content = fs.readFileSync(contentPath, 'utf-8');
+const checkList = checks.split(',');
+
+const issues = [];
+
+if (checkList.includes('ai-slop')) {
+  const slopPatterns = [
+    { pattern: /\bI'd love to\b/i, severity: 'warning', label: 'excessive-politeness' },
+    { pattern: /\bIn today's digital\s+(age|world|landscape)\b/i, severity: 'critical', label: 'cliche-opening' },
+    { pattern: /\bit is important to note\b/i, severity: 'warning', label: 'hedging' },
+    { pattern: /\bthis is why\b/i, severity: 'info', label: 'weak-transition' },
+    { pattern: /\bwhen it comes to\b/i, severity: 'warning', label: 'wordy-intro' },
+    { pattern: /\bin the world of\b/i, severity: 'critical', label: 'cliche-phrase' },
+    { pattern: /\bthe key to\b/i, severity: 'info', label: 'weak-opener' },
+    { pattern: /\bultimately\b/i, severity: 'info', label: 'filler-word' },
+    { pattern: /\bessentially\b/i, severity: 'info', label: 'filler-word' },
+    { pattern: /\bbasically\b/i, severity: 'info', label: 'filler-word' },
+    { pattern: /\bunlock\s+(your\s+)?(potential|success|growth)\b/i, severity: 'critical', label: 'buzzword' },
+    { pattern: /\bgame[-\s]changer\b/i, severity: 'critical', label: 'overused-term' },
+    { pattern: /\brevolutioniz(?:e|ing)\b/i, severity: 'critical', label: 'hyperbole' },
+    { pattern: /\btransformative\b/i, severity: 'warning', label: 'vague-claim' },
+    { pattern: /\bin this article, we will\b/i, severity: 'warning', label: 'robust-intro' },
+    { pattern: /\bdive (?:into|deep)\b/i, severity: 'warning', label: 'cliche-phrase' },
+    { pattern: /\blet's (?:dive|explore|take a look)\b/i, severity: 'warning', label: 'robust-transition' },
+    { pattern: /\bin order to\b/i, severity: 'info', label: 'wordy-phrase' },
+    { pattern: /\blook no further\b/i, severity: 'critical', label: 'cliche-cta' },
+    { pattern: /\bIf you're (?:looking|searching)\b/i, severity: 'warning', label: 'generic-opener' },
+  ];
+
+  const lines = content.split('\n');
+  for (let i = 0; i < lines.length; i++) {
+    for (const sp of slopPatterns) {
+      if (sp.pattern.test(lines[i])) {
+        const match = lines[i].match(sp.pattern);
+        issues.push({
+          severity: sp.severity,
+          category: 'ai-slop',
+          pattern: sp.label,
+          issue: `Found '${match[0]}' in paragraph ${i + 1}`,
+          line: i + 1,
+        });
+      }
+    }
+  }
+}
+
+if (checkList.includes('voice-patterns')) {
+  const voiceIssues = [
+    { pattern: /\bwe believe\b/i, severity: 'info', label: 'generic-opinion' },
+    { pattern: /\bI think\b/i, severity: 'warning', label: 'weak-stance' },
+  ];
+  const lines = content.split('\n');
+  for (let i = 0; i < lines.length; i++) {
+    for (const vp of voiceIssues) {
+      if (vp.pattern.test(lines[i])) {
+        const match = lines[i].match(vp.pattern);
+        issues.push({
+          severity: vp.severity,
+          category: 'voice-patterns',
+          pattern: vp.label,
+          issue: `Found '${match[0]}' in paragraph ${i + 1}`,
+          line: i + 1,
+        });
+      }
+    }
+  }
+}
+
+const criticalCount = issues.filter(i => i.severity === 'critical').length;
+const warningCount = issues.filter(i => i.severity === 'warning').length;
+
+const score = Math.max(0, Math.min(10, 10 - (criticalCount * 1.5) - (warningCount * 0.3)));
+
+const result = {
+  score,
+  issues,
+  summary: `${issues.length} issues found: ${criticalCount} critical, ${warningCount} warnings, ${issues.length - criticalCount - warningCount} info`,
+};
+
+console.log(JSON.stringify(result, null, 2));
+
+if (criticalCount > 0) process.exitCode = 1;