@jairodri/huckleberry-cli 1.0.2 → 1.1.0

package/skills/positioning-angles/references/angle-frameworks.md

@@ -0,0 +1,187 @@
+# Classic Angle-Finding Frameworks
+
+The methodologies legendary copywriters used to discover angles that convert.
+
+---
+
+## Gary Halbert: Fact Sheet to Big Idea
+
+### The process
+
+1. **Create a Fact Sheet** — Document EVERYTHING about the product. 15+ pages. Hundreds of facts. Positive and negative. Features, history, manufacturing, ingredients, creator background, customer results, competitive comparisons.
+
+2. **Translate facts to benefits** — Every fact becomes a benefit. "Car weighs 4,000 lbs" becomes "Safer in collisions" AND "Smoother ride." One fact, multiple benefits.
+
+3. **Find the preexisting interest** — What do prospects already care about that connects to this product? Halbert's "Coat of Arms" letter worked because people already cared about their family name. The letter channeled that existing interest.
+
+4. **Craft the offer** — What would make this irresistible? Free trial? Guarantee? Bonuses? Easy payments? The offer often matters more than the copy.
+
+### The insight
+
+> "The actual writing of the sales letter is the easiest part of the whole process. The hardest and most important part is researching and ferreting out the facts."
+
+Angles emerge from deep immersion in facts, not from creative brainstorming.
+
+---
+
+## Eugene Schwartz: Channel Existing Desire
+
+### The process
+
+1. **Identify the mass desire** — What do prospects already desperately want? You cannot create desire; you can only channel it.
+
+2. **Assess market sophistication** — What stage is the market at? (See schwartz-sophistication.md)
+
+3. **Match the headline to the stage:**
+   - Stage 1: State the promise directly
+   - Stage 2: Enlarge and quantify the promise
+   - Stage 3: Introduce a unique mechanism
+   - Stage 4: Prove and enlarge the mechanism
+   - Stage 5: Appeal to identity
+
+4. **Intensify the desire** — Show the prospect what life looks like with the desire fulfilled. Make it vivid. Make it urgent.
+
+### The insight
+
+> "Copy cannot create desire for a product. It can only take the hopes, dreams, fears, and desires that already exist in the hearts of millions of people, and focus those already existing desires onto a particular product."
+
+The angle is always about connecting to what they already want.
+
+---
+
+## David Ogilvy: Research-Driven Positioning
+
+### The process
+
+1. **Study the product obsessively** — "The more you know about a product, the more likely you are to come up with a good idea for advertising it." Ogilvy spent weeks researching before writing.
+
+2. **Find the unique selling proposition** — What single thing can you say that competitors can't? Ogilvy wrote up to 20 headlines testing different angles.
+
+3. **Use specifics** — "At 60 miles an hour, the loudest noise in this new Rolls-Royce comes from the electric clock." Specifics beat generalities.
+
+4. **Research competitive advertising** — Study every ad that's run in the category for the past 20 years. Know what's been tried.
+
+5. **Lead with the benefit** — The headline should include the benefit. Five times as many people read headlines as body copy.
+
+### The insight
+
+> "Advertising people who ignore research are as dangerous as generals who ignore decodes of enemy signals."
+
+Angles come from research, not creativity.
+
+---
+
+## Claude Hopkins: Scientific Advertising
+
+### The process
+
+1. **Test everything** — Use keyed coupons or tracking to measure what works. "Almost any question can be answered cheaply, quickly, and finally by a test campaign."
+
+2. **Find the reason why** — Don't just claim. Explain WHY the claim is true. "The weight of an argument may often be multiplied by making it specific."
+
+3. **Discover the overlooked fact** — Products have ordinary facts that seem unremarkable to the maker but fascinating to customers. Hopkins made Schlitz famous by explaining the steam sterilization process that ALL breweries used—but no one had explained.
+
+4. **Offer samples** — Let prospects try before buying. This reduces risk and proves confidence.
+
+5. **Target the individual** — "The advertising man studies the consumer. He tries to place himself in the position of the buyer."
+
+### The insight
+
+> "The maker is too close to his product. He sees in his methods only the ordinary. He does not realize that the world at large might marvel at those methods."
+
+Angles often hide in plain sight—ordinary facts that haven't been highlighted.
+
+---
+
+## Gary Bencivenga: The Persuasion Equation
+
+### The formula
+
+**Problem + Promise + Proof + Proposition = Sale**
+
+Each element must be addressed:
+
+1. **Problem** — Identify an urgent problem or deep desire. The bigger the problem, the bigger the market.
+
+2. **Promise** — Describe how your product solves the problem in a way that's unique. What makes your solution different?
+
+3. **Proof** — Back up the promise with credibility: testimonials, case studies, statistics, demonstrations, credentials.
+
+4. **Proposition** — Make an irresistible offer. Remove risk. Make action easy.
+
+### The 80% hit rate approach
+
+Bencivenga achieved over 80% success rate on promotions. His method:
+- Ask "why" relentlessly. Why did this work? Why did that fail?
+- Combine benefit with curiosity: "Interest = Benefit + Curiosity"
+- Be specific. Specifics are more believable than generalities.
+
+### The insight
+
+> "The best copywriters are the ones who are the most curious... They are always asking why."
+
+Angles emerge from relentless investigation, not inspiration.
+
+---
+
+## Dan Kennedy: Message-to-Market Match
+
+### The 10 diagnostic questions
+
+Before writing, answer these about your target market:
+
+1. What keeps them awake at night, indigestion boiling, eyes staring at the ceiling?
+2. What are they afraid of?
+3. What are they angry about? Who are they angry at?
+4. What are their top 3 daily frustrations?
+5. What trends are occurring (or will occur) in their business or lives?
+6. What do they secretly, ardently desire most?
+7. Is there a built-in bias to how they make decisions?
+8. Do they have their own language?
+9. Who else is selling something similar, and how?
+10. Who has tried selling them something similar, and failed?
+
+### The matching principle
+
+> "If you have the right message matched to the right market, your sales message doesn't have to be particularly good to work. But if message-to-market match is wrong, even the best sales letter in the world will fail."
+
+The angle must match what the market actually cares about. No amount of clever copy saves a mismatched angle.
+
+### The insight
+
+Don't sell what YOU think is important. Sell what THEY lie awake thinking about.
+
+---
+
+## Synthesis: The Angle Discovery Process
+
+Combining all frameworks:
+
+1. **Research exhaustively** (Halbert, Ogilvy)
+   - Document every fact
+   - Study competitive advertising
+   - Understand the product deeply
+
+2. **Understand the prospect** (Kennedy, Schwartz)
+   - What do they already want?
+   - What keeps them awake at night?
+   - What have they tried before?
+
+3. **Assess market sophistication** (Schwartz)
+   - What stage is this market at?
+   - What type of angle will work here?
+
+4. **Find the differentiation** (Ogilvy, Hopkins)
+   - What's unique about this product?
+   - What ordinary facts haven't been explained?
+   - What can you claim that competitors can't?
+
+5. **Structure for persuasion** (Bencivenga)
+   - Problem → Promise → Proof → Proposition
+   - Each element must be strong
+
+6. **Test and measure** (Hopkins)
+   - Don't guess. Test.
+   - Let results guide refinement
+
+The angle isn't "found" through creativity. It's discovered through research and understanding—then validated through testing.

package/skills/positioning-angles/references/dunford-positioning.md

@@ -0,0 +1,135 @@
+# April Dunford's Positioning Methodology
+
+From "Obviously Awesome" — the most practical framework for product positioning.
+
+---
+
+## The core insight
+
+Positioning is context-setting. It's the opening scene of a movie that tells viewers: where are we, when is this happening, what's going on, and how should I feel about it?
+
+Products don't have inherent positioning. Positioning is a choice about how to frame the product in the customer's mind.
+
+---
+
+## The 5 components
+
+Each component connects to the others. Change one, and you affect all.
+
+### 1. Competitive Alternatives
+
+**Question:** What would customers do if your solution didn't exist?
+
+This is NOT "who are your competitors." It's broader:
+- Do nothing (live with the problem)
+- Use a spreadsheet / manual process
+- Hire someone (agency, freelancer, consultant)
+- Build it themselves
+- Use a completely different type of solution
+- Use a direct competitor
+
+**Why it matters:** Your differentiation only exists relative to alternatives. If you don't know what you're being compared against, you can't know what's actually different.
+
+**Exercise:** List every possible alternative, then rank by how often customers actually consider each one.
+
+---
+
+### 2. Unique Attributes
+
+**Question:** What do you have that alternatives don't?
+
+Features, capabilities, approaches, business model elements, IP, partnerships, processes—anything that genuinely differentiates.
+
+At this stage, don't judge whether attributes are "important." Just list what's different:
+- Features no one else has
+- Approach or methodology that's unique
+- Business model innovation
+- Team expertise or background
+- Technology or patents
+- Partnerships or integrations
+
+**Why it matters:** These are the raw materials for differentiation. Without unique attributes, you're a commodity.
+
+---
+
+### 3. Value (So what?)
+
+**Question:** What value do those unique attributes enable for customers?
+
+This is where most positioning fails. Features aren't value. You have to translate.
+
+**The translation:** "[Unique attribute] enables [customer value]"
+
+Examples:
+- "Fast query processing" → "Answer customer questions while they're still on the phone instead of calling back tomorrow"
+- "AI-powered analysis" → "Spot patterns in your data that humans would miss"
+- "Done-for-you implementation" → "Launch in 2 days instead of 2 months"
+
+**The So What Chain:** Keep asking "so what?" until you hit something emotional or financial.
+
+Feature → Functional benefit → Business impact → Emotional payoff
+
+---
+
+### 4. Target Customer Segments
+
+**Question:** Who cares a LOT about the value you deliver?
+
+Not everyone in your addressable market values your differentiation equally. Some care a lot. Some don't care at all.
+
+**Characteristics of best-fit customers:**
+- They have the problem you solve acutely
+- They value your specific differentiation
+- They have budget and authority to buy
+- They can be reached through accessible channels
+
+**The narrower, the better.** A product positioned for "small businesses" competes with everyone. A product positioned for "Shopify store owners doing $1M-$10M who struggle with inventory forecasting" competes with almost no one.
+
+---
+
+### 5. Market Category
+
+**Question:** What market frame makes your value obvious?
+
+The market category is the context that sets expectations. Calling yourself a "CRM" triggers different assumptions than calling yourself a "Sales Intelligence Platform."
+
+**Category options:**
+- Existing category (compete within established space)
+- Adjacent category (borrow from related space)
+- New category (create your own space)
+
+**The right category:**
+- Makes your unique value obvious
+- Puts you in favorable competitive context
+- Aligns with how customers think about the problem
+
+**Example:** A database company couldn't compete with Oracle as a "database." Repositioned as "Business Intelligence for Investment Banks," their fast query speed (previously just a feature) became the defining value prop. Grew from $2M to $80M in 18 months.
+
+---
+
+## The positioning statement template
+
+**For [target customers] who [situation/need], [product name] is a [market category] that [key benefit/differentiation]. Unlike [primary alternative], we [unique differentiator].**
+
+Example:
+"For investment banks analyzing real-time market data who need instant answers to complex queries, DataCo is a Business Intelligence platform that delivers sub-second query response on massive datasets. Unlike traditional databases that require overnight batch processing, we enable real-time analysis so you can answer client questions while they're still on the phone."
+
+---
+
+## When to revisit positioning
+
+- Product capabilities have significantly changed
+- Target customer has evolved
+- Competitive landscape has shifted
+- You've learned something new about how customers think
+- Current positioning isn't resonating (pipeline problems, win rate issues)
+
+---
+
+## Common positioning mistakes
+
+1. **Positioning to everyone** — If everyone is your customer, no one is
+2. **Leading with features** — Features aren't value; translate them
+3. **Copying competitors** — You can't out-position someone in their own positioning
+4. **Ignoring alternatives** — If you don't know what you're compared against, you can't differentiate
+5. **Picking the wrong category** — A category that makes your differentiation invisible kills you

package/skills/positioning-angles/references/hormozi-offer.md

@@ -0,0 +1,247 @@
+# Hormozi's Offer Framework
+
+From "$100M Offers" — the system for creating offers so good people feel stupid saying no.
+
+---
+
+## The Grand Slam Offer
+
+An offer that:
+- Cannot be compared to any other product or service
+- Combines attractive promotion with unmatchable value
+- Commands premium pricing
+- Includes an unbeatable guarantee
+- Allows you to get paid to acquire customers
+
+The goal: Make the offer so asymmetrically valuable that saying "no" feels irrational.
+
+---
+
+## The Value Equation
+
+**Value = (Dream Outcome × Perceived Likelihood of Achievement) / (Time Delay × Effort & Sacrifice)**
+
+### The numerator (maximize these):
+
+**Dream Outcome:** The transformation. Not the process—the end state. What does their life look like AFTER?
+- Not "fitness coaching" but "lose 20 lbs and keep it off"
+- Not "marketing help" but "$100K in new revenue"
+- Not "course access" but "launch your business in 30 days"
+
+**Perceived Likelihood:** Their belief that they will actually achieve the outcome.
+- Testimonials and case studies increase this
+- Guarantees increase this
+- Credibility and track record increase this
+- Specificity increases this
+
+### The denominator (minimize these):
+
+**Time Delay:** How long until they see results?
+- Quick wins early build momentum
+- Faster time-to-value = higher perceived value
+- Liposuction vs. gym membership example: same outcome, wildly different time
+
+**Effort & Sacrifice:** How much work do they have to do?
+- Done-for-you beats done-with-you beats do-it-yourself
+- Templates and systems reduce effort
+- Support reduces perceived difficulty
+- Every friction point you remove increases value
+
+### The math
+
+If time delay or effort approaches zero, value approaches infinity.
+
+This is why "instant" and "effortless" solutions command premium prices—even when the outcome is the same as slower, harder alternatives.
+
+---
+
+## The Starving Crowd
+
+Before crafting the offer, select the right market.
+
+**Market > Offer > Persuasion**
+
+A mediocre offer to a starving crowd beats a great offer to an indifferent market.
+
+### The three criteria:
+
+1. **Massive Pain** — Not a mild inconvenience. Genuine suffering, financial loss, urgent problem.
+
+2. **Purchasing Power** — They have money and willingness to spend it on solutions.
+
+3. **Easy to Target** — You can reach them through identifiable channels.
+
+### Evergreen markets:
+
+- Health (physical, mental, longevity)
+- Wealth (income, savings, business growth)
+- Relationships (romantic, family, professional)
+
+Within these, niche down. "Time management for outbound B2B sales reps" beats "productivity for professionals."
+
+---
+
+## Building the Offer
+
+### Step 1: Define the Dream Outcome
+
+What transformation are they buying? Be specific:
+- "Lose 20 lbs in 6 weeks"
+- "Generate 50 qualified leads per month"
+- "Launch your course in 30 days"
+
+### Step 2: List All Problems
+
+Exhaustively list every obstacle between their current state and the dream outcome:
+
+**External problems:**
+- "I don't know how"
+- "I don't have time"
+- "I don't have resources"
+- "I've tried before and failed"
+
+**Internal problems:**
+- "I'm afraid this won't work for me"
+- "I doubt I have what it takes"
+- "I'm worried about judgment"
+- "I don't believe I deserve success"
+
+The more problems you identify, the more comprehensive your offer can be.
+
+### Step 3: Transform Problems into Solutions
+
+For each problem, create a solution:
+- "I don't know how" → "Step-by-step system that shows you exactly what to do"
+- "I don't have time" → "Done-for-you implementation" or "2-hour-per-week system"
+- "I've tried before and failed" → "Personalized approach based on why previous attempts failed"
+
+### Step 4: Choose Delivery Vehicles
+
+Each solution can be delivered multiple ways:
+
+**By attention level:**
+- Done-for-you (highest price)
+- Done-with-you (mid price)
+- Do-it-yourself (lowest price)
+
+**By format:**
+- 1-on-1, small group, or 1-to-many
+- Live or recorded
+- Synchronous or asynchronous
+- Fast response or standard response
+
+Mix and match to create different price tiers.
+
+### Step 5: Trim and Stack
+
+Evaluate each solution on:
+- Value to customer (high or low)
+- Cost to deliver (high or low)
+
+**High value, low cost** = Maximum leverage. Include these.
+**High value, high cost** = Include but deliver efficiently.
+**Low value, any cost** = Cut these.
+
+Stack the high-value elements into a comprehensive bundle.
+
+---
+
+## Premium Pricing
+
+### Why higher prices work:
+
+1. **Price signals quality** — People infer that expensive = better
+2. **Higher investment = higher commitment** — $5,000 customers implement more than $500 customers
+3. **Forces you to over-deliver** — You can't charge premium and under-deliver
+4. **Attracts better customers** — Premium buyers complain less, implement more, get better results
+
+### The pricing test:
+
+Charge "as much as you can say out loud without cracking a smile."
+
+If the price feels comfortable, it's probably too low.
+
+### Price-to-value discrepancy:
+
+People buy when perceived value dramatically exceeds price.
+
+If they perceive $50,000 of value and you charge $5,000, the decision is easy.
+
+Increase perceived value (through the equation) rather than decreasing price.
+
+---
+
+## The MAGIC Naming Formula
+
+**M** - Magnet (reason to act now: "Free," "Limited," "New")
+**A** - Avatar (who it's for: "Busy Moms," "SaaS Founders")
+**G** - Goal (the outcome: "Six-Figure," "Pain-Free")
+**I** - Interval (timeframe: "30-Day," "6-Week")
+**C** - Container (format: "Blueprint," "Bootcamp," "System")
+
+### Examples:
+- "The 6-Week Fit Mom Transformation Blueprint"
+- "Free 21-Day Lead Generation Bootcamp for Coaches"
+- "The 90-Day Six-Figure Agency System"
+
+Use alliteration and rhyme for memorability.
+
+---
+
+## Guarantees
+
+Guarantees reverse risk from buyer to seller.
+
+### Types:
+
+**Unconditional:** Full refund, no questions asked, any reason.
+
+**Conditional:** Refund if specific conditions met (completed program, implemented steps, etc.).
+
+**Outcome-based:** Payment tied to results. You only earn if they succeed.
+
+### Stacking guarantees:
+
+Combine multiple guarantees for overwhelming risk reversal:
+- 30-day unconditional refund
+- 90-day conditional results guarantee
+- Continued work until outcome achieved
+
+### The psychology:
+
+Strong guarantees demonstrate confidence. If you won't guarantee results, why should they believe you can deliver?
+
+---
+
+## Bonus Stacking
+
+Bonuses increase perceived value without discounting.
+
+### Rules:
+
+1. **Each bonus solves a specific objection** — "What if I don't have time?" → Bonus: Quick-Start Templates
+2. **Name bonuses specifically** — Not "Bonus: Templates" but "The $2,000 Copy Swipe File"
+3. **Assign value to each** — State what it would cost separately
+4. **Stack until bonus value exceeds offer price** — If offer is $2,000, bonuses should total $5,000+
+
+### Bonuses vs. Discounts:
+
+Never discount. Add bonuses instead.
+
+Discounting says "my price is negotiable."
+Bonuses say "the price is fixed, but I'll add more value."
+
+---
+
+## The Grand Slam Test
+
+Before launching, verify:
+
+1. **Is it in a starving crowd market?**
+2. **Is the dream outcome crystal clear and specific?**
+3. **Does every major obstacle have a solution?**
+4. **Is price-to-value discrepancy at least 10:1?**
+5. **Does the guarantee reverse all risk?**
+6. **Would YOU feel stupid saying no?**
+
+If you hesitate on any answer, strengthen that element before launching.