firefrost-gaming/claude-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d740f77ef74494dea032333894e335f6332cb423
claude-skills-reference/marketing-skill/free-tool-strategy/references/launch-playbook.md
Alireza Rezvani 52321c86bc feat: Marketing Division expansion — 7 → 42 skills (#266) 
* feat: Skill Authoring Standard + Marketing Expansion plans

SKILL-AUTHORING-STANDARD.md — the DNA of every skill in this repo:
10 universal patterns codified from C-Suite innovations + Corey Haines' marketingskills patterns:

1. Context-First: check domain context, ask only for gaps
2. Practitioner Voice: expert persona, goal-oriented, not textbook
3. Multi-Mode Workflows: build from scratch / optimize existing / situation-specific
4. Related Skills Navigation: when to use, when NOT to, bidirectional
5. Reference Separation: SKILL.md lean (≤10KB), refs deep
6. Proactive Triggers: surface issues without being asked
7. Output Artifacts: request → specific deliverable mapping
8. Quality Loop: self-verify, confidence tagging
9. Communication Standard: bottom line first, structured output
10. Python Tools: stdlib-only, CLI-first, JSON output, sample data

Marketing expansion plans for 40-skill marketing division build.

* feat: marketing foundation — context + ops router + authoring standard

marketing-context/: Foundation skill every marketing skill reads first
  - SKILL.md: 3 modes (auto-draft, guided interview, update)
  - templates/marketing-context-template.md: 14 sections covering
    product, audience, personas, pain points, competitive landscape,
    differentiation, objections, switching dynamics, customer language
    (verbatim), brand voice, style guide, proof points, SEO context, goals
  - scripts/context_validator.py: Scores completeness 0-100, section-by-section

marketing-ops/: Central router for 40-skill marketing ecosystem
  - Full routing matrix: 7 pods + cross-domain routing to 6 skills in
    business-growth, product-team, engineering-team, c-level-advisor
  - Campaign orchestration sequences (launch, content, CRO sprint)
  - Quality gate matching C-Suite standard
  - scripts/campaign_tracker.py: Campaign status tracking with progress,
    overdue detection, pod coverage, blocker identification

SKILL-AUTHORING-STANDARD.md: Universal DNA for all skills
  - 10 patterns: context-first, practitioner voice, multi-mode workflows,
    related skills navigation, reference separation, proactive triggers,
    output artifacts, quality loop, communication standard, python tools
  - Quality checklist for skill completion verification
  - Domain context file mapping for all 5 domains

* feat: import 20 workspace marketing skills + standard sections

Imported 20 marketing skills from OpenClaw workspace into repo:

Content Pod (5):
  content-strategy, copywriting, copy-editing, social-content, marketing-ideas

SEO Pod (2):
  seo-audit (+ references enriched by subagent), programmatic-seo (+ refs)

CRO Pod (5):
  page-cro, form-cro, signup-flow-cro, onboarding-cro, popup-cro, paywall-upgrade-cro

Channels Pod (2):
  email-sequence, paid-ads

Growth + Intel + GTM (5):
  ab-test-setup, competitor-alternatives, marketing-psychology, launch-strategy, brand-guidelines

All 29 skills now have standard sections per SKILL-AUTHORING-STANDARD.md:
  ✅ Proactive Triggers (4-5 per skill)
  ✅ Output Artifacts table
  ✅ Communication standard reference
  ✅ Related Skills with WHEN/NOT disambiguation

Subagents enriched 8 skills with additional reference docs:
  seo-audit, programmatic-seo, page-cro, form-cro,
  onboarding-cro, popup-cro, paywall-upgrade-cro, email-sequence

43 files, 10,566 lines added.

* feat: build 13 new marketing skills + social-media-manager upgrade

All skills are 100% original work — inspired by industry best practices,
written from scratch in our own voice following SKILL-AUTHORING-STANDARD.md.

NEW Content Pod (2):
  content-production — full research→draft→optimize pipeline, content_scorer.py
  content-humanizer — AI pattern detection + voice injection, humanizer_scorer.py

NEW SEO Pod (3):
  ai-seo — AI search optimization (AEO/GEO/LLMO), entirely new category
  schema-markup — JSON-LD structured data, schema_validator.py
  site-architecture — URL structure + internal linking, sitemap_analyzer.py

NEW Channels Pod (2):
  cold-email — B2B outreach (distinct from email-sequence lifecycle)
  ad-creative — bulk ad generation + platform specs, ad_copy_validator.py

NEW Growth Pod (3):
  churn-prevention — cancel flows + save offers + dunning, churn_impact_calculator.py
  referral-program — referral + affiliate programs
  free-tool-strategy — engineering as marketing

NEW Intelligence Pod (1):
  analytics-tracking — GA4/GTM setup + event taxonomy, tracking_plan_generator.py

NEW Sales Pod (1):
  pricing-strategy — pricing, packaging, monetization

UPGRADED:
  social-media-analyzer → social-media-manager (strategy, calendar, community)

Totals: 42 skills, 27 Python scripts, 60 reference docs, 163 files, 43,265 lines

* feat: update index, marketplace, README for 42 marketing skills

- skills-index.json: 89 → 124 skills (42 marketing entries)
- marketplace.json: marketing-skills v2.0.0 (42 skills, 27 tools)
- README.md: badge 134 → 169, marketing row updated
- prompt-engineer-toolkit: added YAML frontmatter
- Removed build logs from repo
- Parity check: 42/42 passed (YAML + Related + Proactive + Output + Communication)

* fix: merge content-creator into content-production, split marketing-psychology

Quality audit fixes:

1. content-creator → DEPRECATED redirect
   - Scripts (brand_voice_analyzer.py, seo_optimizer.py) moved to content-production
   - SKILL.md replaced with redirect to content-production + content-strategy
   - Eliminates duplicate routing confusion

2. marketing-psychology → 24KB split to 6.8KB + reference
   - 70+ mental models moved to references/mental-models-catalog.md (397 lines)
   - SKILL.md now lean: categories overview, most-used models, quick reference
   - Saves ~4,300 tokens per invocation

* feat: add plugin configs, Codex/OpenClaw compatibility, ClawHub packaging

- marketing-skill/SKILL.md: ClawHub-compatible root with Quick Start for Claude Code, Codex CLI, OpenClaw
- marketing-skill/CLAUDE.md: Agent instructions (routing, context, anti-patterns)
- marketing-skill/.codex/instructions.md: Codex CLI skill routing
- .claude-plugin/marketplace.json: deduplicated, marketing-skills v2.0.0
- .codex/skills-index.json: content-creator marked deprecated, psychology updated
- Total: 42 skills, 27 Python tools, 60 references, 18 plugins

* feat: add 16 Python tools to knowledge-only skills

Enriched 12 previously tool-less skills with practical Python scripts:
- seo-audit/seo_checker.py — HTML on-page SEO analysis (0-100)
- copywriting/headline_scorer.py — headline quality scoring (0-100)
- copy-editing/readability_scorer.py — Flesch + passive + filler detection
- content-strategy/topic_cluster_mapper.py — keyword clustering
- page-cro/conversion_audit.py — HTML CRO signal analysis (0-100)
- paid-ads/roas_calculator.py — ROAS/CPA/CPL calculator
- email-sequence/sequence_analyzer.py — email sequence scoring (0-100)
- form-cro/form_field_analyzer.py — form field CRO audit (0-100)
- onboarding-cro/activation_funnel_analyzer.py — funnel drop-off analysis
- programmatic-seo/url_pattern_generator.py — URL pattern planning
- ab-test-setup/sample_size_calculator.py — statistical sample sizing
- signup-flow-cro/funnel_drop_analyzer.py — signup funnel analysis
- launch-strategy/launch_readiness_scorer.py — launch checklist scoring
- competitor-alternatives/comparison_matrix_builder.py — feature comparison
- social-media-manager/social_calendar_generator.py — content calendar
- readability_scorer.py — fixed demo mode for non-TTY execution

All 43/43 scripts pass execution. All stdlib-only, zero pip installs.
Total: 42 skills, 43 Python tools, 60+ reference docs.

* feat: add 3 more Python tools + improve 6 existing scripts

New tools from build agent:
- email-sequence/scripts/sequence_analyzer.py — email sequence scoring (91/100 demo)
- paid-ads/scripts/roas_calculator.py — ROAS/CPA/CPL/break-even calculator
- competitor-alternatives/scripts/comparison_matrix_builder.py — feature matrix

Improved scripts (better demo modes, fuller analysis):
- seo_checker.py, headline_scorer.py, readability_scorer.py,
  conversion_audit.py, topic_cluster_mapper.py, launch_readiness_scorer.py

Total: 42 skills, 47 Python tools, all passing.

* fix: remove duplicate scripts from deprecated content-creator

Scripts already live in content-production/scripts/. The content-creator
directory is now a pure redirect (SKILL.md only + legacy assets/refs).

* fix: scope VirusTotal scan to executable files only

Skip scanning .md, .py, .json, .yml — they're plain text files
that VirusTotal can't meaningfully analyze. This prevents 429 rate
limit errors on PRs with many text file changes (like 42 marketing skills).

Scan still covers: .js, .ts, .sh, .mjs, .cjs, .exe, .dll, .so, .bin, .wasm

---------

Co-authored-by: Leo <leo@openclaw.ai>
2026-03-06 03:56:16 +01:00

183 lines
8.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Launch Playbook — How to Launch a Free Tool for Maximum Impact
A free tool with no distribution is just code sitting on a server. This playbook gives you the launch sequence that turns a new tool into traffic, leads, and backlinks.
---
## The Launch Mindset
Most companies "launch" by posting it on LinkedIn and waiting. That gets you 200 visits from your existing followers and then nothing.
A real launch is a 4-week sustained distribution campaign. You're not announcing — you're seeding. Every channel you touch plants a seed that compounds over months (especially for SEO).
---
## Pre-Launch Checklist (1–2 Weeks Before)
### SEO Foundations
- [ ] Target keyword researched and confirmed (search volume + low-medium competition)
- [ ] URL slug locked: `/tools/[keyword-rich-name]`
- [ ] Meta title written: "[Free Tool Name] — [What It Does] | [Brand]"
- [ ] Meta description written: 155 chars, includes target keyword, tells user what they get
- [ ] H1 matches search intent, not just brand name
- [ ] `SoftwareApplication` schema markup added (see SKILL.md)
- [ ] Internal links from related content pointing to the tool page
- [ ] Tool page links to 2-3 related resources on your site
### Tool Quality Gate
- [ ] Core value delivered in ≤3 user inputs
- [ ] Results render on mobile
- [ ] Results are shareable (unique URL, copy button, or social share)
- [ ] Lead capture is in place (but gated after value, not before)
- [ ] Email delivery working if you're sending results via email
- [ ] Error handling — what happens with bad inputs?
- [ ] Load time <3 seconds (tools with slow loads have brutal bounce rates)
### Analytics Setup
- [ ] GA4 (or Plausible) tracking installed
- [ ] Key events tracked: tool_started, tool_completed, lead_captured, result_shared
- [ ] Google Search Console verified
- [ ] Heatmap tool installed (Hotjar or Microsoft Clarity) to watch real usage
### Outreach List Ready
- [ ] List of 20-50 sites that link to similar free tools (from Ahrefs / Google "site:domain resources")
- [ ] List of newsletters in your category that feature tools
- [ ] List of subreddits and communities where your audience hangs out
- [ ] Influencers or thought leaders who regularly share tools in your space
---
## Launch Week — The Sequence
### Day 1: SEO and Directories
- Submit tool to Google Search Console (Request Indexing)
- Submit to Bing Webmaster Tools
- Submit to relevant online directories (AlternativeTo, Product Hunt upcoming, SaaSHub, Capterra if applicable)
- Post in your company's blog (a 600-900 word post explaining the tool, linking to it)
### Day 2: Product Hunt
- Submit to Product Hunt at midnight PST (Thursday or Tuesday for best timing)
- Have your team and early fans upvote in the first 2 hours
- Respond to every comment personally — PH algorithm rewards engagement
- Ask your top customers to upvote (personalized message, not mass email)
- Product Hunt tip: the thumbnail image and tagline matter more than the description
### Day 3: Community Seeding (No Pitch)
- Post in relevant subreddits — share as a resource, not a promotion
- Frame: "I built this free [tool type] for [audience] because I couldn't find one — feedback welcome"
- No "check out our new tool" — that's spam and gets removed
- Share in Slack communities in your industry
- Share in relevant Facebook groups
- LinkedIn post — personal post from founder, not company page (personal posts get 10× the reach)
### Day 4: Email to Your List
- Dedicated email to your subscriber list introducing the tool
- Subject line: "Free [Tool Name] — [benefit in 5 words]"
- Keep it short: what it is, why you built it, one sentence result, link
- Ask them to share with one person who'd benefit
### Day 5: Hacker News
- Post to HN with a "Show HN:" prefix: `Show HN: [Tool Name] — [what it does in one line]`
- HN community responds well to honest builder posts with a unique angle
- Must be technically interesting or niche — generic marketing tools don't land
- Be available to answer technical questions in the thread all day
### Day 6-7: Social Amplification
- Twitter/X thread: "I built a free [tool] for [audience]. Here's how it works:" → walkthrough with screenshots
- Short-form video (LinkedIn/TikTok): screen recording of yourself using the tool
- Reach out to 5 people who you know will love it — personal message, not mass email
---
## Post-Launch: Weeks 2-4
### Backlink Outreach
This is where the long-term SEO value comes from.
**Identify targets:**
1. Search Google: `"best free tools for [your category]"` — email everyone on that list
2. Use Ahrefs: find pages linking to similar tools → those same pages may link to yours
3. Search: `"[competitor tool name]" site:[niche blog]` — those bloggers are interested in tools like yours
**Outreach template:**
```
Subject: Free [Tool Name] that might fit your "[Resource List Title]" post
Hi [Name],
I noticed your post on the best free tools for [category]. I recently built [Tool Name]
— it helps [audience] [specific outcome] without [common pain point].
[Direct link to tool]
Would it fit your list? Happy to give you early access or a custom embed if that's useful.
[Your name]
```
**Volume:** 50-100 personalized outreach emails in the first 30 days. Expect 5-15% positive response. One good resource page link is worth 50 generic directory submissions.
### Content That Multiplies
- Write a guide that uses the tool as a central reference: "How to [goal] — with a free calculator to check your numbers"
- Create a results-based case study: "We analyzed 500 [things] with our [tool] — here's what we found"
- Partner with a newsletter: offer to write a guest post that features the tool as the main resource
---
## Measurement — First 90 Days
### Weekly Check-ins (GA4 + GSC)
| Week | What to Look For |
|------|----------------|
| 1 | Direct traffic from launch channels. Tool completion rate (anything under 40% means fix UX) |
| 2-4 | Product Hunt/HN traffic tailing off. Backlinks starting to trickle in. |
| 5-8 | First organic impressions in GSC. Check what queries are sending traffic. |
| 9-12 | Organic traffic should be visible. Lead capture rate should be stable. |
### The "Is It Working?" Test at 90 Days
| Metric | Needs Work | Good | Great |
|--------|-----------|------|-------|
| Organic sessions/month | <200 | 500–2,000 | >5,000 |
| Tool completion rate | <30% | 40–60% | >70% |
| Lead conversion rate (completions → email) | <3% | 5–15% | >20% |
| Referring domains (backlinks) | <5 | 10–30 | >50 |
---
## When a Launch Flops
A tool can fail to gain traction for 4 reasons:
1. **Wrong keyword** — nobody searches for this. Check GSC; if you have zero impressions after 60 days, the keyword target is wrong. Pivot the page copy to a related term with volume.
2. **Wrong problem** — the tool exists, but it's not solving an acute enough problem. Talk to 5 people who used it and didn't return. What were they hoping for?
3. **Gated too early** — traffic is high but completion is low. You're asking for email before delivering value. Remove or move the gate.
4. **Distribution failure** — the tool is fine, but you only posted it once. Run the backlink outreach again with a fresh list. Submit to 10 new directories. Write the guide post.
Most "failed" tools aren't actually failures — they just didn't get the 90-day distribution campaign they needed.
---
## Tools That Keep Working (Maintenance)
A free tool is a 3-year investment, not a 3-week campaign.
**Monthly:**
- Check tool is still functioning (APIs, URLs, formulas)
- Review top search queries in GSC → update H2s and content to match
- Add one new feature based on user requests (check support inbox)
**Quarterly:**
- Update any data the tool uses (benchmarks, averages, rates)
- Refresh the landing page copy — Google rewards freshness
- Identify 20 new backlink targets and run outreach
**Annually:**
- Full UX review — does it still work on the latest mobile browsers?
- Competitive audit — are better free alternatives emerging?
- Decide: invest more, maintain as-is, or retire and redirect
Reference in New Issue View Git Blame Copy Permalink