@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/marketing-demo/references/remotion-examples.md

@@ -0,0 +1,281 @@
+# Remotion Component Examples for Marketing Demos
+
+Reference patterns for Mode B (Polished Demo). Copy and adapt these components.
+
+## Root Composition (index.tsx)
+
+```tsx
+import { Composition } from "remotion";
+import { DemoVideo } from "./DemoVideo";
+
+export const RemotionRoot: React.FC = () => {
+  return (
+    <Composition
+      id="DemoVideo"
+      component={DemoVideo}
+      durationInFrames={300} // 10s at 30fps
+      fps={30}
+      width={1280}
+      height={720}
+    />
+  );
+};
+```
+
+## Main Demo Video (DemoVideo.tsx)
+
+```tsx
+import { AbsoluteFill, Sequence } from "remotion";
+import { Intro } from "./Intro";
+import { DemoScene } from "./DemoScene";
+import { Outro } from "./Outro";
+
+// Define shots — update paths and captions per project
+const SHOTS = [
+  { src: "/shots/shot-01.png", caption: "Create in seconds" },
+  { src: "/shots/shot-02.png", caption: "Organize everything" },
+  { src: "/shots/shot-03.png", caption: "Share with your team" },
+];
+
+export const DemoVideo: React.FC = () => {
+  const introDuration = 60; // 2s
+  const sceneDuration = 60; // 2s per shot
+  const outroDuration = 90; // 3s
+
+  return (
+    <AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>
+      <Sequence from={0} durationInFrames={introDuration}>
+        <Intro />
+      </Sequence>
+
+      {SHOTS.map((shot, i) => (
+        <Sequence
+          key={i}
+          from={introDuration + i * sceneDuration}
+          durationInFrames={sceneDuration}
+        >
+          <DemoScene src={shot.src} caption={shot.caption} />
+        </Sequence>
+      ))}
+
+      <Sequence
+        from={introDuration + SHOTS.length * sceneDuration}
+        durationInFrames={outroDuration}
+      >
+        <Outro />
+      </Sequence>
+    </AbsoluteFill>
+  );
+};
+```
+
+## Intro Scene (Intro.tsx)
+
+```tsx
+import { AbsoluteFill, Img, useCurrentFrame, interpolate } from "remotion";
+
+export const Intro: React.FC = () => {
+  const frame = useCurrentFrame();
+
+  const logoOpacity = interpolate(frame, [0, 20], [0, 1], {
+    extrapolateRight: "clamp",
+  });
+  const taglineOpacity = interpolate(frame, [15, 35], [0, 1], {
+    extrapolateRight: "clamp",
+  });
+
+  return (
+    <AbsoluteFill
+      style={{
+        background: "linear-gradient(135deg, #1a1a2e 0%, #16213e 100%)",
+        justifyContent: "center",
+        alignItems: "center",
+      }}
+    >
+      <div style={{ textAlign: "center" }}>
+        <Img
+          src="/logo.png"
+          style={{
+            width: 120,
+            height: 120,
+            opacity: logoOpacity,
+            marginBottom: 24,
+          }}
+        />
+        <p
+          style={{
+            color: "#ffffff",
+            fontSize: 28,
+            fontFamily: "Inter, sans-serif",
+            opacity: taglineOpacity,
+            fontWeight: 500,
+          }}
+        >
+          Your tagline here
+        </p>
+      </div>
+    </AbsoluteFill>
+  );
+};
+```
+
+## Demo Scene (DemoScene.tsx)
+
+```tsx
+import { AbsoluteFill, Img, useCurrentFrame, interpolate } from "remotion";
+
+interface DemoSceneProps {
+  src: string;
+  caption: string;
+}
+
+export const DemoScene: React.FC<DemoSceneProps> = ({ src, caption }) => {
+  const frame = useCurrentFrame();
+
+  // Subtle zoom-in adds life to static screenshots
+  const scale = interpolate(frame, [0, 60], [1.0, 1.05], {
+    extrapolateRight: "clamp",
+  });
+
+  // Caption fades in slightly after screenshot
+  const captionOpacity = interpolate(frame, [5, 20], [0, 1], {
+    extrapolateRight: "clamp",
+  });
+  const captionY = interpolate(frame, [5, 20], [10, 0], {
+    extrapolateRight: "clamp",
+  });
+
+  return (
+    <AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>
+      {/* Screenshot — fills 80% of frame */}
+      <div
+        style={{
+          position: "absolute",
+          top: "10%",
+          left: "10%",
+          width: "80%",
+          height: "75%",
+          overflow: "hidden",
+          borderRadius: 12,
+          boxShadow: "0 20px 60px rgba(0,0,0,0.5)",
+        }}
+      >
+        <Img
+          src={src}
+          style={{
+            width: "100%",
+            height: "100%",
+            objectFit: "cover",
+            transform: `scale(${scale})`,
+          }}
+        />
+      </div>
+
+      {/* Caption overlay at bottom */}
+      <div
+        style={{
+          position: "absolute",
+          bottom: "4%",
+          left: 0,
+          right: 0,
+          textAlign: "center",
+          opacity: captionOpacity,
+          transform: `translateY(${captionY}px)`,
+        }}
+      >
+        <span
+          style={{
+            color: "#ffffff",
+            fontSize: 32,
+            fontFamily: "Inter, sans-serif",
+            fontWeight: 600,
+            background: "rgba(0,0,0,0.6)",
+            padding: "8px 24px",
+            borderRadius: 8,
+          }}
+        >
+          {caption}
+        </span>
+      </div>
+    </AbsoluteFill>
+  );
+};
+```
+
+## Outro Scene (Outro.tsx)
+
+```tsx
+import { AbsoluteFill, Img, useCurrentFrame, interpolate } from "remotion";
+
+export const Outro: React.FC = () => {
+  const frame = useCurrentFrame();
+
+  const ctaOpacity = interpolate(frame, [0, 25], [0, 1], {
+    extrapolateRight: "clamp",
+  });
+  const ctaScale = interpolate(frame, [0, 25], [0.95, 1], {
+    extrapolateRight: "clamp",
+  });
+
+  return (
+    <AbsoluteFill
+      style={{
+        background: "linear-gradient(135deg, #1a1a2e 0%, #16213e 100%)",
+        justifyContent: "center",
+        alignItems: "center",
+      }}
+    >
+      <div
+        style={{
+          textAlign: "center",
+          opacity: ctaOpacity,
+          transform: `scale(${ctaScale})`,
+        }}
+      >
+        <Img
+          src="/logo.png"
+          style={{ width: 80, height: 80, marginBottom: 24 }}
+        />
+        <h2
+          style={{
+            color: "#ffffff",
+            fontSize: 42,
+            fontFamily: "Inter, sans-serif",
+            fontWeight: 700,
+            marginBottom: 16,
+          }}
+        >
+          Try it free
+        </h2>
+        <p
+          style={{
+            color: "#9ca3af",
+            fontSize: 22,
+            fontFamily: "Inter, sans-serif",
+          }}
+        >
+          yourproduct.com
+        </p>
+      </div>
+    </AbsoluteFill>
+  );
+};
+```
+
+## Adapting to Your Brand
+
+1. Replace `#1a1a2e` / `#16213e` gradients with colors from `brand/creative-kit.md`
+2. Replace `Inter` with your brand font
+3. Replace `/logo.png` with your logo path
+4. Adjust `durationInFrames` per scene based on shot duration rules in SKILL.md
+5. For social (1080x1080), change the Composition dimensions and adjust layout accordingly
+
+## Common Adjustments
+
+| Need | Change |
+|------|--------|
+| Longer per scene | Increase `sceneDuration` (30fps × seconds) |
+| More scenes | Add entries to `SHOTS` array |
+| Different resolution | Change Composition `width`/`height` |
+| Background music | Add `<Audio src="/music.mp3" />` to DemoVideo |
+| Fade transitions | Add opacity interpolation at scene start/end frames |

package/skills/marketing-ideas/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: marketing-ideas
+description: Brainstorm marketing ideas, strategies, and growth tactics.
+metadata:
+  version: 1.1.0
+---
+
+# Marketing Ideas for SaaS
+
+You are a marketing strategist with a library of 139 proven marketing ideas. Your goal is to help users find the right marketing strategies for their specific situation, stage, and resources.
+
+## How to Use This Skill
+
+**Check for brand-specific assets in businesses/{business}/brand/ first:**
+If `businesses/{business}/brand/` exists (or `businesses/{business}/brand/` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
+
+When asked for marketing ideas:
+1. Ask about their product, audience, and current stage if not clear
+2. Suggest 3-5 most relevant ideas based on their context
+3. Provide details on implementation for chosen ideas
+4. Consider their resources (time, budget, team size)
+
+---
+
+## Ideas by Category (Quick Reference)
+
+| Category | Ideas | Examples |
+|----------|-------|----------|
+| Content & SEO | 1-10 | Programmatic SEO, Glossary marketing, Content repurposing |
+| Competitor | 11-13 | Comparison pages, Marketing jiu-jitsu |
+| Free Tools | 14-22 | Calculators, Generators, Chrome extensions |
+| Paid Ads | 23-34 | LinkedIn, Google, Retargeting, Podcast ads |
+| Social & Community | 35-44 | LinkedIn audience, Reddit marketing, Short-form video |
+| Email | 45-53 | Founder emails, Onboarding sequences, Win-back |
+| Partnerships | 54-64 | Affiliate programs, Integration marketing, Newsletter swaps |
+| Events | 65-72 | Webinars, Conference speaking, Virtual summits |
+| PR & Media | 73-76 | Press coverage, Documentaries |
+| Launches | 77-86 | Product Hunt, Lifetime deals, Giveaways |
+| Product-Led | 87-96 | Viral loops, Powered-by marketing, Free migrations |
+| Content Formats | 97-109 | Podcasts, Courses, Annual reports, Year wraps |
+| Unconventional | 110-122 | Awards, Challenges, Guerrilla marketing |
+| Platforms | 123-130 | App marketplaces, Review sites, YouTube |
+| International | 131-132 | Expansion, Price localization |
+| Developer | 133-136 | DevRel, Certifications |
+| Audience-Specific | 137-139 | Referrals, Podcast tours, Customer language |
+
+**For the complete list with descriptions**: See [references/ideas-by-category.md](references/ideas-by-category.md)
+
+---
+
+## Implementation Tips
+
+### By Stage
+
+**Pre-launch:**
+- Waitlist referrals (#79)
+- Early access pricing (#81)
+- Product Hunt prep (#78)
+
+**Early stage:**
+- Content & SEO (#1-10)
+- Community (#35)
+- Founder-led sales (#47)
+
+**Growth stage:**
+- Paid acquisition (#23-34)
+- Partnerships (#54-64)
+- Events (#65-72)
+
+**Scale:**
+- Brand campaigns
+- International (#131-132)
+- Media acquisitions (#73)
+
+### By Budget
+
+**Free:**
+- Content & SEO
+- Community building
+- Social media
+- Comment marketing
+
+**Low budget:**
+- Targeted ads
+- Sponsorships
+- Free tools
+
+**Medium budget:**
+- Events
+- Partnerships
+- PR
+
+**High budget:**
+- Acquisitions
+- Conferences
+- Brand campaigns
+
+### By Timeline
+
+**Quick wins:**
+- Ads, email, social posts
+
+**Medium-term:**
+- Content, SEO, community
+
+**Long-term:**
+- Brand, thought leadership, platform effects
+
+---
+
+## Top Ideas by Use Case
+
+### Need Leads Fast
+- Google Ads (#31) - High-intent search
+- LinkedIn Ads (#28) - B2B targeting
+- Engineering as Marketing (#15) - Free tool lead gen
+
+### Building Authority
+- Conference Speaking (#70)
+- Book Marketing (#104)
+- Podcasts (#107)
+
+### Low Budget Growth
+- Easy Keyword Ranking (#1)
+- Reddit Marketing (#38)
+- Comment Marketing (#44)
+
+### Product-Led Growth
+- Viral Loops (#93)
+- Powered By Marketing (#87)
+- In-App Upsells (#91)
+
+### Enterprise Sales
+- Investor Marketing (#133)
+- Expert Networks (#57)
+- Conference Sponsorship (#72)
+
+---
+
+## Output Format
+
+When recommending ideas, provide for each:
+
+- **Idea name**: One-line description
+- **Why it fits**: Connection to their situation
+- **How to start**: First 2-3 implementation steps
+- **Expected outcome**: What success looks like
+- **Resources needed**: Time, budget, skills required
+
+---
+
+## Task-Specific Questions
+
+1. What's your current stage and main growth goal?
+2. What's your marketing budget and team size?
+3. What have you already tried that worked or didn't?
+4. What competitor tactics do you admire?
+
+---
+
+## Related Skills
+
+- **programmatic-seo**: For scaling SEO content (#4)
+- **competitor-alternatives**: For comparison pages (#11)
+- **email-sequence**: For email marketing tactics
+- **free-tool-strategy**: For engineering as marketing (#15)
+- **referral-program**: For viral growth (#93)

package/skills/marketing-ideas/evals/evals.json

@@ -0,0 +1,90 @@
+{
+  "skill_name": "marketing-ideas",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "I need marketing ideas for my SaaS product. We're a bootstrapped team of 3, sell a $49/month analytics tool for e-commerce, and have about 200 customers. Budget is tight — maybe $500/month for marketing.",
+      "expected_output": "Should check for product-marketing-context.md first. Should filter ideas by low budget and early-stage constraints. Should pull relevant ideas from the 139 marketing ideas organized by category. Should provide ideas appropriate for bootstrapped SaaS: content marketing, community building, SEO, partnerships, referral programs, social media, Product Hunt, and others that don't require large budgets. Output should follow the format: idea name, why it fits, how to start, expected outcome, resources needed. Should prioritize by likely impact given their stage.",
+      "assertions": [
+        "Checks for product-marketing-context.md",
+        "Filters ideas by low budget constraint",
+        "Provides ideas from the 139 marketing ideas catalog",
+        "Ideas are appropriate for bootstrapped SaaS stage",
+        "Output follows structured format per idea",
+        "Includes why it fits, how to start, expected outcome",
+        "Prioritizes by likely impact",
+        "Includes resources needed per idea"
+      ],
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "What's the fastest way to get more leads? We sell enterprise security software and have a $10k/month marketing budget.",
+      "expected_output": "Should apply the 'top ideas by use case' — specifically 'leads fast' recommendations. Should recommend paid channels (Google Ads, LinkedIn Ads for enterprise), outbound (cold email, LinkedIn outreach), and content-based lead magnets. Should filter for enterprise-appropriate tactics. Should provide the structured output with why each idea fits, how to start, expected timeline, and resources needed. Should note that 'fast leads' typically means paid or outbound channels.",
+      "assertions": [
+        "Applies 'leads fast' use case filter",
+        "Recommends paid channels appropriate for enterprise",
+        "Recommends outbound tactics",
+        "Filters for enterprise-appropriate tactics",
+        "Provides structured output per idea",
+        "Notes that fast leads means paid or outbound",
+        "Includes timeline expectations"
+      ],
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "how do we grow without spending money on ads? we're a PLG (product-led growth) company with a freemium model",
+      "expected_output": "Should trigger on casual phrasing. Should apply the 'PLG' use case filter from top ideas. Should recommend PLG-specific tactics: product virality features, referral programs, community building, content marketing, SEO, free tools/calculators, open-source contributions, social proof loops. Should avoid ad-dependent ideas given the constraint. Should provide structured output with implementation guidance.",
+      "assertions": [
+        "Triggers on casual phrasing",
+        "Applies PLG use case filter",
+        "Recommends PLG-specific tactics",
+        "Avoids ad-dependent ideas",
+        "Includes virality and referral tactics",
+        "Provides structured output with implementation guidance"
+      ],
+      "files": []
+    },
+    {
+      "id": 4,
+      "prompt": "We want to build authority and thought leadership in the HR tech space. We're a newer company and nobody knows who we are yet.",
+      "expected_output": "Should apply the 'authority building' use case filter. Should recommend thought leadership tactics: original research/surveys, guest posting, podcast appearances, speaking engagements, LinkedIn content, industry report publishing, expert roundups. Should note that authority building is a longer-term play. Should provide structured output with how to start each idea, expected outcomes, and timeline.",
+      "assertions": [
+        "Applies 'authority building' use case filter",
+        "Recommends thought leadership tactics",
+        "Includes original research and content",
+        "Includes community and media appearances",
+        "Notes authority building is longer-term",
+        "Provides structured output with timelines"
+      ],
+      "files": []
+    },
+    {
+      "id": 5,
+      "prompt": "Give me 20 marketing ideas. We sell project management software.",
+      "expected_output": "Should provide a curated list of ~20 ideas from the catalog. Should organize them by category or by effort/impact. Should provide brief implementation context for each. Should vary the ideas across categories (content, community, partnerships, product, paid, etc.) for a well-rounded set. Output should follow the structured format with at least idea name and brief description for each.",
+      "assertions": [
+        "Provides approximately 20 ideas",
+        "Ideas span multiple categories",
+        "Organizes by category or effort/impact",
+        "Provides brief implementation context per idea",
+        "Output follows structured format",
+        "Ideas are relevant to project management software"
+      ],
+      "files": []
+    },
+    {
+      "id": 6,
+      "prompt": "We want to set up a referral program. How should we structure it?",
+      "expected_output": "Should recognize this is specifically a referral program design request. Should defer to or cross-reference the referral-program skill, which provides detailed guidance on referral loop design, incentive structures, implementation, and optimization. May briefly mention referral programs as a marketing idea but should make clear that referral-program is the right skill for detailed program design.",
+      "assertions": [
+        "Recognizes this as a referral program design request",
+        "References or defers to referral-program skill",
+        "Does not attempt detailed referral program design",
+        "May briefly mention as a marketing idea"
+      ],
+      "files": []
+    }
+  ]
+}