npm - aigroup-workflow - Versions diffs - 1.0.1 → 1.1.1 - Mend

aigroup-workflow 1.0.1 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2777) hide show

package/skills/jarvis/engineering-team/marketing-skill/free-tool-strategy/references/launch-playbook.md DELETED Viewed

@@ -1,182 +0,0 @@
-# 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

package/skills/jarvis/engineering-team/marketing-skill/free-tool-strategy/references/tool-types-guide.md DELETED Viewed

@@ -1,253 +0,0 @@
-# Tool Types Guide — Comprehensive Reference for Free Marketing Tools
-Each tool type explained with examples, build complexity, typical outcomes, and design guidance.
----
-## The 7 Tool Types
-### 1. Calculators
-**What they do:** Take numerical or categorical inputs → output a calculated result (a number, range, or score).
-**Examples:**
-- SaaS Pricing Calculator ("What should you charge?")
-- ROI Calculator ("How much would you save?")
-- LTV Calculator ("What's your customer worth?")
-- Churn Impact Calculator ("What does 1% more churn cost you?")
-- Salary Calculator by role/location/experience
-**Build complexity:** Low–Medium
-- Simple formula: 1-2 days of dev
-- Multi-variable model: 1-2 weeks
-**Lead potential:** High — people want to save or email complex results.
-**SEO value:** Medium-High — calculators earn links from resource pages and ranking for "[topic] calculator" queries.
-**Viral potential:** Medium — people share results when they're surprising or validating.
-**Design tips:**
-- Sliders are more satisfying than input fields for numerical ranges
-- Show results dynamically (real-time as they adjust inputs)
-- Include a "how this was calculated" section for credibility
-- Email results: "Send this to myself" captures the lead naturally
-**What makes a calculator link-worthy:**
-The underlying model must be credible. If you're calculating LTV, show your formula and cite your assumptions. A calculator with methodology is shareable content, not just a widget.
----
-### 2. Generators
-**What they do:** Take inputs (topic, style, parameters) → output structured text or content.
-**Examples:**
-- Headline Generator (input: product + audience → 10 headline options)
-- LinkedIn Bio Generator
-- Job Description Generator
-- Email Subject Line Generator
-- Product Description Generator
-- Business Name Generator
-**Build complexity:** Low (template-based) to High (LLM-powered)
-**Template-based (madlibs):**
-- 1-3 days
-- Take inputs, fill template slots, combine with variations
-- Deterministic output
-**LLM-powered:**
-- 1-2 weeks (API integration + prompt engineering)
-- Generative output
-- Requires API key costs to be modeled into business case
-**Lead potential:** Medium — output varies, so gating with email is natural if you offer "save and regenerate."
-**SEO value:** High for "[topic] generator free" — some of the highest-traffic tools are generators.
-**Viral potential:** High — people share clever or surprisingly good generated outputs.
-**Design tips:**
-- Show an example output before the user enters anything (reduces bounce)
-- Generate 3-5 variations, not just 1
-- "Copy to clipboard" button is a must
-- "Generate again" encourages engagement (more pageviews, better SEO signal)
----
-### 3. Checkers
-**What they do:** Analyze a URL, email, text, file, or domain → return an audit or pass/fail assessment.
-**Examples:**
-- SEO Checker ("Analyze your page's SEO")
-- Email Spam Checker ("Will your email hit spam?")
-- Website Speed Checker
-- LinkedIn Profile Checker
-- Ad Copy Compliance Checker
-- Password Strength Checker
-- Domain Authority Checker
-**Build complexity:** Medium–High
-- Text analysis (readability, keyword density): 2-5 days
-- URL crawling (page analysis): 1-2 weeks
-- Email delivery testing: 1-2 weeks + email infrastructure
-**Lead potential:** High — checker results are specific to the user; saves/exports feel natural.
-**SEO value:** Very High — "[type] checker" or "check my [thing]" queries are often high-volume.
-**Viral potential:** High — "Your page scored 47/100 — here's what's broken" drives sharing.
-**Design tips:**
-- Score the output (0-100) — people anchor on scores and compare
-- Categorize results: Critical / Warnings / Passed
-- Prioritize issues — don't just list everything, rank by impact
-- Loading state matters — show progress (feels like analysis is happening)
----
-### 4. Graders
-**What they do:** Score something holistically against a rubric. More opinionated than a checker — you're grading against a defined standard.
-**Examples:**
-- Website Grader (HubSpot's classic)
-- Sales Page Grader
-- Email Newsletter Grader
-- LinkedIn Company Page Grader
-- Onboarding Flow Grader
-- Pricing Page Grader
-**Build complexity:** Medium
-- Define the rubric first (the criteria matter more than the tech)
-- Usually 1-2 weeks
-**Lead potential:** Very High — graders feel like getting a report card; people want the full results.
-**SEO value:** High for niche graders ("sales page grader" etc.).
-**Viral potential:** Medium-High — share your score as social proof or to invite critique.
-**Design tips:**
-- The grade (A-F or 0-100) is the hook — show it prominently
-- Break down the grade into components (e.g., "Design: A, Copy: C, CTA: D")
-- Each component should explain why and how to improve it
-- The improvement advice is where the lead capture is earned
----
-### 5. Converters
-**What they do:** Transform input from one format to another. Pure utility.
-**Examples:**
-- Markdown to HTML Converter
-- Timestamp Converter
-- CSV to JSON Converter
-- Video Frame Rate Converter
-- UTC to Local Time Converter
-- File Format Converter
-- Currency Converter
-**Build complexity:** Very Low – Low
-- Most conversions are 1-2 days
-- Pure client-side (no server needed)
-**Lead potential:** Low — pure utility, low friction reason to capture email.
-**SEO value:** Medium — "convert X to Y" queries exist but are dominated by large tool sites.
-**Viral potential:** Low — people bookmark and return, don't share.
-**When to build:** Only if the conversion is specific to your audience (e.g., a SaaS for designers building a "Figma token to CSS converter"). Generic converters are dominated by free sites with years of SEO authority.
----
-### 6. Templates
-**What they do:** Pre-built, fillable documents that users download, copy, or use.
-**Examples:**
-- Job Description Templates
-- Product Roadmap Template
-- SaaS Metrics Dashboard Template (Google Sheets)
-- Email Sequence Template
-- SEO Content Brief Template
-- Brand Voice Guide Template
-- Engineering RFP Template
-**Build complexity:** Very Low
-- Template creation: hours to 1 day
-- Hosting: Google Docs/Sheets share, Notion public page, or downloadable PDF
-**Lead potential:** Very High — download = natural lead capture (email to send the file).
-**SEO value:** High — "[role] template" queries are competitive but high-intent.
-**Viral potential:** Medium — people share templates that save them real time.
-**Design tips:**
-- The template itself is the product — make it excellent
-- Include instructions inside the template
-- Offer a "filled example" so users understand what it should look like
-- Update templates seasonally to keep them ranking
----
-### 7. Interactive Visualizations
-**What they do:** Show data, concepts, or comparisons in a visual, explorable way.
-**Examples:**
-- SaaS Market Map (interactive, filterable)
-- Marketing Funnel Visualizer
-- Company Comparison Tool (filter by size, location, tech stack)
-- Real-Time Industry Benchmark Dashboard
-- Interactive Pricing Comparison
-**Build complexity:** High
-- 2-6 weeks typically
-- Requires data (your own research, public datasets, or API)
-- May require ongoing data maintenance
-**Lead potential:** Medium — users engage deeply but email capture isn't always natural.
-**SEO value:** Very High if data-driven — journalists and bloggers link to unique datasets.
-**Viral potential:** Very High if the data is surprising or highly visual — these are your link magnets.
-**Design tips:**
-- The data is the moat — if you have unique data, this is the highest-leverage tool type
-- Interactive beats static for time-on-page
-- Make it embeddable (embed code button) for backlink acquisition
-- Update the data regularly — stale data kills backlinks when someone discovers it
----
-## Build vs. No-Code Decision Guide
-| Tool Type | No-Code Options | When to Go Custom Dev |
-|-----------|---------------|----------------------|
-| Calculator | Outgrow, Calconic, Typeform | When logic is complex, or brand/speed matters |
-| Generator | Typeform + Zapier, GPT wrappers | When you need custom LLM behavior |
-| Checker | Limited — usually needs dev | Always (URL crawling, text analysis) |
-| Grader | Outgrow, Involve.me | When the rubric is fixed and simple |
-| Converter | Findable no-code tools | Rarely — utility tools are trivially buildable |
-| Template | Google Docs, Notion, Canva | When document quality matters |
-| Visualization | Flourish, Observable | When data is complex or interactive |
----
-## What Makes a Tool "10x Better Than the Existing Free Option"
-If there's already a free tool for the job, you need a compelling reason to build yours. One of:
-1. **Niche specificity** — existing tool is generic, yours is specific to your audience's workflow
-2. **Better UX** — existing tools are ugly, clunky, or require too many steps
-3. **Integrated action** — after results, existing tools drop the user; yours offers next steps or a trial
-4. **Unique data or model** — your checker uses proprietary data that others don't have
-5. **Shareable output** — existing tools give results in a table; yours generates a shareable card or PDF
-Don't build "the same tool, but ours." That's a traffic fight you won't win. Build "the tool that does what the others don't."