indie-store-growth-ai-kit Markdown

README.md

# Indie Store Growth AI Kit

Independent-site marketing planner for Shopify, DTC landing pages and
cross-border product funnels.

The repo focuses on useful store growth work:

```text
page / offer / traffic source
  -> landing-page clarity audit
  -> event and UTM plan
  -> capture and retention plan
  -> experiment queue
  -> channel-specific content actions
```

It does not promise fake growth hacks. It creates a practical marketing operating
plan that can connect to tools such as PostHog, Plausible, Mautic, listmonk,
Chatwoot and Shopify.

## What It Does

- Scores hero clarity, offer quality, trust proof, CTA, FAQ and content proof.
- Generates tracking events for product pages, landing pages and lead capture.
- Creates a UTM plan for TikTok, Meta, Google, creator traffic and EDM.
- Builds a capture plan for email, WhatsApp and inquiry forms.
- Produces A/B test ideas tied to the page weakness.

## Quick Start

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .
store-growth audit examples/sample_store.json
```

Run tests:

```bash
python -m unittest discover -s tests
```

## Open Source Reference Map

This repository is original code. It references:

- [PostHog](https://github.com/PostHog/posthog): product analytics, funnels and
  experiment thinking.
- [Plausible](https://github.com/plausible/analytics): lightweight privacy-aware
  analytics inspiration.
- [Mautic](https://github.com/mautic/mautic): marketing automation workflow
  concepts.
- [listmonk](https://github.com/knadh/listmonk): newsletter and list operations.
- [Chatwoot](https://github.com/chatwoot/chatwoot): WhatsApp/live-chat lead routing.

## License

MIT.

skills/storefront-growth.skill.md

# storefront-growth.skill

Purpose: turn an independent site or Shopify landing page into a measurable
marketing workflow.

## Loop

```text
store page
  -> hero / offer / proof / CTA audit
  -> tracking and UTM plan
  -> email / WhatsApp capture plan
  -> experiment queue
  -> weekly content and conversion review
```

## Output

- Growth score.
- Missing commercial signals.
- Event tracking plan.
- Capture plan.
- A/B experiment queue.

## Rules

- Do not scale traffic before the first screen is clear.
- Do not add popups without a real offer.
- Connect every campaign to source, medium, market and product angle.
- For WhatsApp capture, keep the click source and buyer intent.

README.md and skill file.

README.md

skills/storefront-growth.skill.md