@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/link-building-seo/SKILL.md

@@ -0,0 +1,210 @@
+---
+name: link-building-seo
+description: >
+  SEO link building framework for new websites based on Jesper Nissen's 7-step method.
+  Covers GBP setup, social profiles, citations, press releases, donation links, cloud links,
+  manual profile links, and guest posts. Use when asked about link building strategy,
+  backlink plans, SEO for new domains, authority building, or how to rank a new website.
+  Triggers: "link building", "backlinks", "SEO strategy", "rank new site", "domain authority",
+  "citation building", "cloud links", "press release SEO", "GBP optimization".
+---
+
+# Link Building for New Websites
+
+A complete, ordered framework for building authority and backlinks on a brand new domain. Based on Jesper Nissen's proven method. Follow these steps **in order** — each step builds on the previous one.
+
+**Target audience:** Local businesses, SaaS, blogs, low-to-medium competition keywords. NOT for high-competition niches like iGaming.
+
+**Timeline:** All 7 steps can be completed in ~2 weeks. Doing all of them puts you ahead of 95% of competitors.
+
+---
+
+## Step 0: Google Business Profile (GBP)
+
+**Do this first.** The GBP is the authority hub Google trusts most.
+
+1. Create or claim the GBP
+2. Fill in ALL business info — name, address, phone, website, hours, categories
+3. Add ALL social media profile URLs (steps 1-7 profiles go here)
+4. Create GBP posts with outgoing links to website content and videos
+
+**Why:** Google uses GBP as a trust signal. Posts with links pass authority. GBP links appear in knowledge panels and AI overviews.
+
+---
+
+## Step 1: Core Social Profiles
+
+Build these 7 profiles (the ones GBP recommends). Each should link back to the website AND cross-link to other social profiles.
+
+| # | Platform | Link to Website | Link in Posts |
+|---|----------|:-:|:-:|
+| 1 | YouTube | Y | Y |
+| 2 | Facebook | Y | Y |
+| 3 | LinkedIn | Y | Y |
+| 4 | Pinterest | Y | Y |
+| 5 | X (Twitter) | Y | Y |
+| 6 | Instagram | Y (bio) | N |
+| 7 | TikTok | Y (bio) | N |
+
+**Additional profiles to build:** Threads, Bluesky
+
+**Rules:**
+- Use consistent brand name, logo, bio across all
+- Add website URL in every profile's "link" field
+- Cross-link between profiles where possible
+- Add all profile URLs back into GBP
+
+---
+
+## Step 2: Citations (NAP Consistency)
+
+Citations are directory listings with consistent Name-Address-Phone info. Low individual power but critical for local SEO and increasingly important for AI overviews (Gemini, ChatGPT cite directories).
+
+**How to build:**
+- Order citation packages on Fiverr or Legiit (search "citations")
+- Pick the cheapest options — quality is similar across providers
+- Ensure NAP is **identical** across every citation
+- Include short business description + link to socials in each
+
+**Why it matters now:** LLMs use citation mentions as authority signals. More mentions = more important in AI overviews.
+
+---
+
+## Step 3: Press Release Distribution
+
+Press releases are the fastest way to build a large number of referring domains quickly.
+
+**What to do:**
+1. Write a newsworthy release about the brand launch, product, or milestone
+2. Include links to homepage + key internal pages
+3. Distribute via a press release service
+
+**Budget options:**
+- Fiverr or Legiit — as low as $5 per release
+- ABNewswire
+
+**Premium option:**
+- Randy the News Guy (thenewsguy.com) — AP News, Yahoo News placement, high-quality domains
+
+**Three strategic advantages:**
+1. **Spike of referring domains** — Google expects this from press releases, so it won't flag as spam. This creates cover to build other links simultaneously.
+2. **Page one rankings** — Press releases themselves can rank for low-competition and local keywords (parasite SEO).
+3. **AI Overview training** — Press releases are frequently cited as sources in Google AI overviews. Possible to dominate AI overviews with just press releases.
+
+---
+
+## Step 4: Donation Links
+
+Sponsor a website in exchange for a dofollow backlink. Overlooked and powerful.
+
+**Types:**
+- **Local:** Sports clubs, churches, community organizations
+- **Public donor pages:** OSS projects, software foundations
+  - Example: linuxmint.com/donors.php — donate, get a powerful dofollow link
+
+**Pros:** High authority, dofollow, few competitors have them
+**Cons:** Some require ongoing monthly payments
+
+**Strategy:** Find 5-10 donation pages in relevant niches. Budget $50-200/month total.
+
+---
+
+## Step 5: Cloud Links
+
+Static HTML pages uploaded to subdomains of major cloud platforms. These inherit massive domain authority from the root domain (DA 90+).
+
+**Platforms (23+ via YACSS):**
+- Google Cloud, AWS, Azure, Digital Ocean, Backblaze, Wasabi, Linode, Vultr, Oracle, GitHub Pages, Netlify, Cloudflare R2, Bunny CDN, OVH, Contabo, and more
+
+**How to build:**
+1. Create a simple HTML page with relevant content about your business/niche
+2. Upload to multiple cloud platform subdomains
+3. Interlink the cloud pages with each other
+4. Point links from cloud pages to your main category/landing pages
+
+**Tool:** YACSS (yacss.site) — automates creation and deployment across all 23+ cloud platforms
+
+**Strategy:** Build 10-20 cloud links. Point them at category pages, not just homepage. Interlink them for compounding authority.
+
+---
+
+## Step 6: Manual Profile Links
+
+Free profile pages on platforms like about.me, linktr.ee, and similar services. Mix of dofollow and nofollow.
+
+**How to find opportunities:**
+- Ask ChatGPT: "Give me a list of 30 links that are similar to about.me"
+- Build a spreadsheet of working platforms
+- Aim for 2-3 new profile links per day
+
+**Rules:**
+- Interlink profiles with each other
+- Use relevant entities/keywords in profile content
+- Keep descriptions varied — don't copy-paste the same bio everywhere
+- Track which ones are indexed in Google
+
+**Paid shortcut:** Jesper Nissen sells a vetted list of 103 link opportunities for $99 (jespernissen.com/product/103-links-list/)
+
+---
+
+## Step 7: Guest Posts / Paid Placements
+
+Do this LAST — after the base is built. Scale link building with paid placements on authoritative sites.
+
+**Marketplaces:**
+- Bazoom.com — user-friendly, good competitor analysis
+- Presswhiz
+- Fiverr / Legiit (search "guest post")
+
+**How it works:**
+1. Choose a site with relevant audience and good domain authority
+2. Write (or commission) an article with a contextual link to your site
+3. Article gets published on the target site with your backlink
+
+**Budget warning:** Gets expensive fast. Reserve for high-value pages that need extra push.
+
+---
+
+## Execution Priority
+
+```
+Week 1:
+  Day 1-2:  GBP setup + social profiles (Steps 0-1)
+  Day 3-4:  Citations (Step 2) — order on Fiverr/Legiit
+  Day 5:    Press release draft + distribution (Step 3)
+
+Week 2:
+  Day 1-2:  Donation links research + placement (Step 4)
+  Day 3-4:  Cloud links build (Step 5)
+  Day 5:    Manual profile links start (Step 6)
+
+Ongoing:
+  2-3 manual profile links per day (Step 6)
+  Guest posts as budget allows (Step 7)
+```
+
+## Quick Reference Checklist
+
+When starting link building for a new website, verify:
+
+- [ ] GBP created with full info + all social URLs
+- [ ] 7 core social profiles built + cross-linked
+- [ ] Citations ordered (Fiverr/Legiit)
+- [ ] Press release written and distributed
+- [ ] 5-10 donation links secured
+- [ ] 10-20 cloud links deployed
+- [ ] Manual profile links — building 2-3/day
+- [ ] Guest posts — scaling as budget allows
+
+## Key Principles
+
+1. **Order matters.** Social profiles and citations establish legitimacy before heavier link building.
+2. **Press releases create cover.** The referral domain spike from a press release masks other link building activity.
+3. **Consistency beats intensity.** 2-3 manual links/day over months > 100 links in one day.
+4. **Interlink everything.** Cloud links link to each other. Profile links link to each other. The network compounds authority.
+5. **AI overviews are the new frontier.** Citations and press releases train LLMs to recognize your brand as authoritative.
+
+## Source
+
+Jesper Nissen (@JespernissenSEO) — SEO practitioner and creator of YACSS.
+Full guide: https://yacss.site/linkbuilding-for-a-new-website-what-links-to-build-and-when-to-build-them/

package/skills/lint-report.txt

@@ -0,0 +1 @@
+

package/skills/manifest.json

@@ -0,0 +1,129 @@
+{
+  "version": "1.1.0",
+  "note": "Skill packs for Huckleberry. 'all' = union of every pack. Synced from the master library via scripts/sync-skills.mjs. typefully and muse are intentionally EXCLUDED (banned / operator-branded).",
+  "packs": {
+    "core": [
+      "claw-compactor",
+      "context-recovery",
+      "humanizer",
+      "guardrail-framework",
+      "platform-formatting",
+      "summarize",
+      "inkstone-admin",
+      "project-rag",
+      "notebooklm"
+    ],
+    "doctor": [
+      "jev-hook-gate"
+    ],
+    "research": [
+      "agent-reach",
+      "smart-search",
+      "firecrawl",
+      "competitive-intel",
+      "keyword-research",
+      "seo-audit",
+      "original-research",
+      "x-research",
+      "youtube-summarize",
+      "podcast-transcription"
+    ],
+    "content": [
+      "copywriting",
+      "copy-editing",
+      "concreteness-fixer",
+      "article-generator",
+      "seo-content",
+      "narrative-research-article",
+      "hook-generator",
+      "brand-voice",
+      "voice-extraction",
+      "voice-brand-alignment",
+      "positioning-angles",
+      "quality-gate",
+      "sharp-thesis-validator",
+      "deep-serp-article",
+      "weekly-newsletter-digest",
+      "content-atomizer",
+      "content-repost-manager"
+    ],
+    "cro": [
+      "page-cro",
+      "form-cro",
+      "popup-cro",
+      "signup-flow-cro",
+      "onboarding-cro",
+      "paywall-upgrade-cro",
+      "conversion-flow-cro",
+      "ab-test-setup",
+      "analytics-tracking",
+      "churn-prevention",
+      "referral-program",
+      "pricing-strategy",
+      "launch-strategy",
+      "free-tool-strategy"
+    ],
+    "web-design": [
+      "impeccable",
+      "landing-page-architect",
+      "visual-style",
+      "brand-kit-playground",
+      "paper-marketing",
+      "slideshow-script",
+      "frontend-slides",
+      "programmatic-seo",
+      "site-architecture",
+      "schema-markup",
+      "ai-seo",
+      "seo-machine",
+      "topical-authority",
+      "off-page-seo",
+      "link-building-seo",
+      "auto-indexing",
+      "competitor-alternatives",
+      "saas-product-seo",
+      "earned-media",
+      "review-sites",
+      "ai-visibility-audit",
+      "ai-consensus-builder",
+      "ai-agent-seo"
+    ],
+    "outreach-sales": [
+      "cold-email",
+      "ai-cold-email-intelligence",
+      "lead-email-craft",
+      "warm-outbound",
+      "b2b-cold-outreach",
+      "email-sequences",
+      "lead-magnets",
+      "sales-enablement",
+      "revops",
+      "startup-launcher",
+      "send-email",
+      "business-advisory-council"
+    ],
+    "social": [
+      "social-campaign",
+      "social-content",
+      "social-worker",
+      "x-post-generator-openclaw",
+      "x-posting-playwriter",
+      "x-playwriter",
+      "birdclaw",
+      "marketing-ideas",
+      "marketing-psychology",
+      "brainstorm",
+      "cmo",
+      "image-gen",
+      "creative",
+      "marketing-demo"
+    ],
+    "self-improvement": [
+      "self-improve",
+      "skill-self-improvement",
+      "auto-skill",
+      "autoresearch",
+      "self-improving-agent"
+    ]
+  }
+}

package/skills/marketing-demo/SKILL.md

@@ -0,0 +1,249 @@
+---
+name: marketing-demo
+description: "Record product demos and walkthroughs for marketing assets. Two modes: quick screenshot-stitch demos via ply + ffmpeg, or polished Remotion..."
+category: creative
+layer: creative
+tier: nice-to-have
+reads:
+  - brand/creative-kit.md
+  - brand/voice-profile.md
+  - brand/stack.md
+writes:
+  - marketing/demos/
+depends-on:
+  - visual-style
+triggers:
+  - product demo
+  - demo video
+  - walkthrough video
+  - screen recording
+  - GIF demo
+  - product tour
+  - onboarding video
+  - feature showcase
+  - hero video
+allowed-tools:
+  - Bash(ply *)
+  - Bash(ffmpeg *)
+  - Bash(npx remotion *)
+---
+
+# /marketing-demo — Product Demo Recorder
+
+Record product demos for marketing. Two production paths: quick (ply + ffmpeg) for rough demos, polished (Remotion) for branded marketing videos.
+
+## Reads
+
+- `brand/creative-kit.md` — Colors, fonts, logo paths for branded overlays
+- `brand/voice-profile.md` — Tone guidance for text overlays
+- `brand/stack.md` — Available tools (ply, ffmpeg, remotion)
+
+## On Activation
+
+1. Read `brand/creative-kit.md` for colors, fonts, logo paths. If missing, ask for brand colors and logo.
+2. Read `brand/voice-profile.md` for tone guidance on text overlays. If missing, use clear/neutral tone.
+3. Read `brand/stack.md` to confirm available tools. If missing, detect tools directly.
+4. Check tool availability:
+   ```bash
+   command -v ply && echo "ply: ready" || echo "ply: missing"
+   command -v ffmpeg && echo "ffmpeg: ready" || echo "ffmpeg: missing"
+   command -v npx && echo "remotion: available" || echo "remotion: unavailable"
+   ```
+5. If `ply` or `ffmpeg` missing, warn and suggest install.
+
+## Shot Duration Rules
+
+| Demo Type | Duration per Shot | Notes |
+|-----------|------------------|-------|
+| Quick overview | 0.5-1s | Fast cuts, build excitement |
+| Feature demo | 2-3s | Time to read + comprehend |
+| Walkthrough | 4-5s | Instructional pacing |
+| Social clip | 1-2s | Attention-grabbing, fast |
+
+## Demo Storytelling Principles
+
+Demos fail when they show the product mechanically instead of telling a story. The viewer needs a reason to keep watching. These principles come from what actually gets engagement on landing pages and social:
+
+1. **Open with the outcome, not the setup.** The first 2 seconds decide if someone watches the rest. Show the "after" state — the dashboard with data, the completed design, the result. Setup (login, loading, navigation) earns zero attention.
+2. **One feature = one demo.** Trying to cram 5 features into 30 seconds makes all of them forgettable. A focused demo of one feature is worth more than a rushed tour.
+3. **Show the magic moment.** Every product has one interaction where users go "oh wow." Find that moment and build the demo around it — it's why people click "try it."
+4. **Add context with text overlays.** Social videos autoplay muted. Without text callouts, viewers see UI changing with no idea what's happening or why it matters. Every shot needs a 3-6 word overlay explaining the value.
+5. **Pacing: 2-3 seconds per concept.** This feels fast, but viewer attention is brutal. If a shot doesn't earn its screen time with new information, cut it.
+
+## Step 1: Determine Demo Type
+
+| Type | Duration | Resolution | Format | Use Case |
+|------|----------|-----------|--------|----------|
+| Hero demo | 15-30s | 1280x800 | MP4 | Landing page above-fold |
+| Feature highlight | 5-15s | 1280x800 | GIF/MP4 | Feature section, docs |
+| Full walkthrough | 60-180s | 1280x800 | MP4 | YouTube, sales deck |
+| Social clip | 5-15s | 1080x1080 | MP4 | Instagram, Twitter/X |
+| Email GIF | 3-8s | 600x400 | GIF | Email campaigns |
+| How-to | 30-90s | 1280x800 | MP4 | Help docs, onboarding |
+
+Ask the user which type, or infer from context.
+
+## Step 2: Plan Shot List
+
+Before recording, plan each shot:
+
+```markdown
+## Shot List
+
+1. [Action: Navigate to landing page]
+   - URL: https://example.com
+   - Wait: 1s for load
+   - Highlight: Hero section
+
+2. [Action: Click "Get Started" button]
+   - Wait: transition animation
+   - Highlight: Signup form
+
+3. [Action: Fill demo data]
+   - Type: demo@example.com
+   - Highlight: Success state
+```
+
+Each shot = one `ply` screenshot or interaction sequence.
+
+## Step 3: Choose Production Mode
+
+### Mode A: Quick Demo (ply + ffmpeg)
+
+Fast, rough demos from screenshots stitched into video.
+
+**Capture screenshots:**
+```bash
+# Navigate and screenshot each shot
+ply navigate "https://example.com"
+ply screenshot --output marketing/demos/shot-01.png
+ply click "Get Started"
+ply screenshot --output marketing/demos/shot-02.png
+```
+
+**Stitch with ffmpeg:**
+```bash
+# MP4 from screenshots (2 seconds per frame)
+ffmpeg -framerate 0.5 -i marketing/demos/shot-%02d.png \
+  -c:v libx264 -pix_fmt yuv420p \
+  -vf "scale=1280:800:force_original_aspect_ratio=decrease,pad=1280:800:(ow-iw)/2:(oh-ih)/2" \
+  marketing/demos/demo.mp4
+
+# Preview GIF (lower quality, smaller file)
+ffmpeg -i marketing/demos/demo.mp4 \
+  -vf "fps=10,scale=640:-1:flags=lanczos" \
+  -c:v gif marketing/demos/demo-preview.gif
+
+# Email GIF (600px wide, optimized)
+ffmpeg -i marketing/demos/demo.mp4 \
+  -vf "fps=8,scale=600:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
+  marketing/demos/demo-email.gif
+
+# Square crop for social (1080x1080)
+ffmpeg -i marketing/demos/demo.mp4 \
+  -vf "crop=min(iw\,ih):min(iw\,ih),scale=1080:1080" \
+  marketing/demos/demo-square.mp4
+```
+
+### Mode B: Polished Demo (Remotion)
+
+For marketing-grade output with transitions, text overlays, branded intros.
+
+**Generate Remotion composition:**
+```bash
+# Initialize if needed
+npx remotion init marketing/demos/remotion-demo
+
+# Render final video
+npx remotion render marketing/demos/remotion-demo/src/index.tsx \
+  --output marketing/demos/demo-polished.mp4
+```
+
+**Composition structure:**
+```
+src/
+├── index.tsx          # Root composition
+├── Intro.tsx          # Branded intro (logo, tagline)
+├── DemoScene.tsx      # Screenshot with text overlay
+├── Transition.tsx     # Fade/slide between scenes
+└── Outro.tsx          # CTA + URL
+```
+
+**Key Remotion patterns** (see [references/remotion-examples.md](references/remotion-examples.md) for complete component code):
+- Use `<Img>` for screenshots, `<AbsoluteFill>` for layout
+- `useCurrentFrame()` + `interpolate()` for animations
+- Pull brand colors from `brand/creative-kit.md`
+- 30fps for smooth playback, 1280x720 or 1920x1080
+- Add text overlays calling out features with `<Sequence>`
+
+**Intro scene (2-3s):** Logo centered, tagline fades in. Brand colors as background gradient. Keep it short — the product is the star.
+
+**Demo scene (per shot):** Screenshot fills 80% of frame. Text overlay at top or bottom with 1-line feature callout. Use `interpolate()` for a subtle zoom-in (1.0 → 1.05 over the scene duration) to add life.
+
+**Transition between scenes:** Fade + slight slide (200ms). Never use fancy wipes — they distract from the product.
+
+**Outro scene (3-4s):** CTA text ("Try it free at [url]"), logo, and optional social proof line. This is the only slide that sells — keep all other slides focused on showing.
+
+### Error Recovery
+
+**ply failures** (page doesn't load, element not found, timeout): Skip to shot N+1 and document the failure in the shot list. After all shots complete, review skipped shots and retry once. If still failing, use manual screenshots as fallback.
+
+**ffmpeg failures** (codec not found, format error): Check `ffmpeg -codecs` for available codecs. If libx264 is missing, try `-c:v h264` or install via `brew install ffmpeg`. For GIF palette issues, simplify the filter chain — drop `split/palettegen/paletteuse` and use basic `-vf "fps=10,scale=640:-1"`.
+
+**Remotion failures** (render crashes, composition errors): Check node version (`node -v`, needs 18+). If `npx remotion render` fails, try `npx remotion render --gl=angle` or `--gl=swangle` for GPU issues. For composition errors, verify all `<Img>` src paths are correct and images exist.
+
+## Step 4: Convert & Output
+
+All outputs go to `marketing/demos/`. Name by type:
+
+| Output | Filename | Notes |
+|--------|----------|-------|
+| MP4 (desktop) | `demo-hero.mp4` | H.264, 1280x800 |
+| MP4 (social) | `demo-social-1080.mp4` | Square, 1080x1080 |
+| GIF (preview) | `demo-preview.gif` | 640px wide, <5MB |
+| GIF (email) | `demo-email.gif` | 600px wide, <2MB |
+| MP4 (polished) | `demo-polished.mp4` | Remotion output |
+
+## Step 5: Completion Summary
+
+```markdown
+## Demo Assets Created
+
+| Asset | Size | Format | Suggested Use |
+|-------|------|--------|--------------|
+| demo-hero.mp4 | 1.2MB | MP4 1280x800 | Landing page hero |
+| demo-preview.gif | 3.4MB | GIF 640px | README, docs |
+| demo-email.gif | 1.1MB | GIF 600px | Email campaigns |
+| demo-social-1080.mp4 | 800KB | MP4 1080x1080 | Instagram, X |
+
+All assets saved to `marketing/demos/`.
+```
+
+## Viewport Configs
+
+| Platform | Width | Height | Scale |
+|----------|-------|--------|-------|
+| Desktop | 1280 | 800 | 1x |
+| Desktop HD | 1920 | 1080 | 1x |
+| Mobile | 390 | 844 | 2x |
+| Instagram | 1080 | 1080 | 1x |
+| Twitter/X | 1200 | 675 | 1x |
+| Email | 600 | 400 | 1x |
+
+## Anti-Patterns
+
+| Mistake | Why It Fails |
+|---------|-------------|
+| Recording login/signup flows | Nobody cares about your auth screen. Start after login. |
+| Showing loading spinners | Edit them out or skip to the loaded state. Spinners kill momentum. |
+| No text overlays on silent autoplay | Social videos autoplay muted. Without text, viewers have no idea what they're watching. |
+| Demo longer than 60s without chapter breaks | Attention drops after 15s. If it's long, add clear section titles. |
+| Recording at inconsistent viewport sizes | Shots that jump between sizes look amateur. Lock viewport before recording. |
+| Showing every feature | Pick 3-5 features max. Demos that show everything sell nothing. |
+| Mouse cursor wandering aimlessly | Plan each click. Cursor should move with purpose — straight lines to targets. |
+
+## Related Skills
+
+- `/creative` — Ad visuals, product photos (static assets, not demos)
+- `/content-atomizer` — Turn demo into platform-specific posts
+- `/page-cro` — Audit the page the demo showcases