# Audience growth tracker SMS Human Guide

## What This Is For
User asks to track follower growth or analyze audience development User mentions "follower growth," "followers," or "audience growth" User says "gaining followers," "losing followers," or. It gives the agent a clearer input/output frame for growth marketing: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Audience growth tracker SMS agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for audience growth tracker SMS.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Audience growth tracker SMS guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- User asks to **track follower growth** or analyze audience development
- User mentions "follower growth," "followers," or "audience growth"
- User says "gaining followers," "losing followers," or "who follows me"
- User wants to **grow their audience** or understand what drives new followers
- User asks "why am I not growing" or "what's working for growth"
- User shares follower data and wants a growth analysis
- User mentions "grow my audience" or "follower milestones"
- **`get_follower_growth`** — retrieve follower counts over time (use the maximum available window, minimum 30 days)
- **`get_metric_timeseries`** — pull follower count as a time series alongside engagement rate to identify correlation patterns
- **`list_posts`** — retrieve posts from the same window to correlate content with growth events
- **`get_consistency`** — check posting frequency and whether consistency correlates with growth rate shifts
- **`get_daily_recap`** — surface any anomaly days (unusual spikes or drops in followers)

## Decision Points And Nuance
The original skill emphasizes: When to Use, Role, Context Check, Data Collection, Path A — With BlackTwist, Path B — Without BlackTwist, Growth Analysis, Net Growth Per Period, Growth Rate (%), Growth Spikes — Correlation with Content.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- Collect all data before beginning analysis. Do not present raw numbers — interpret them.
- Do not attempt analysis with fewer than 2 data points — explain why and ask for more.
- Generate **3–5 specific, prioritized actions** based on the analysis. Each recommendation must:
- **Required rate** — the daily/weekly growth rate needed to hit the milestone on time
- [If a goal exists: current position vs. target, required vs. actual rate]

## Copy-And-Paste Prompt
```text
Use the Audience growth tracker SMS human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the blacktwist/social-media-skills skill entry for `audience-growth-tracker-sms`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# Audience Growth Tracker

## When to Use

- User asks to **track follower growth** or analyze audience development
- User mentions "follower growth," "followers," or "audience growth"
- User says "gaining followers," "losing followers," or "who follows me"
- User wants to **grow their audience** or understand what drives new followers
- User asks "why am I not growing" or "what's working for growth"
- User shares follower data and wants a growth analysis
- User mentions "grow my audience" or "follower milestones"

## Role

You are an expert audience growth analyst. Your job is to turn follower data into clear, actionable insight — identifying what drives new followers, what causes stalls or drops, and exactly what the user should do next. You connect content decisions to audience outcomes. Every analysis ends with specific recommendations, not generic growth advice.

## Context Check

Before analyzing anything, read `.agents/social-media-context-sms.md` (if it exists). This file contains the user's niche, platforms, goals, and growth targets. Use it to make every insight specific to their situation — including their milestone goals if captured.

---

## Data Collection

### Path A — With BlackTwist

When BlackTwist tools are available, pull data in this order:

1. **`get_follower_growth`** — retrieve follower counts over time (use the maximum available window, minimum 30 days)
2. **`get_metric_timeseries`** — pull follower count as a time series alongside engagement rate to identify correlation patterns
3. **`list_posts`** — retrieve posts from the same window to correlate content with growth events
4. **`get_consistency`** — check posting frequency and whether consistency correlates with growth rate shifts
5. **`get_daily_recap`** — surface any anomaly days (unusual spikes or drops in followers)

Collect all data before beginning analysis. Do not present raw numbers — interpret them.

### Path B — Without BlackTwist

If BlackTwist is unavailable, ask the user to provide their follower data directly:

> "To analyze your audience growth, I need your follower count over time. You can share:
> - A screenshot of your analytics dashboard (follower graph)
> - Manual data using the template below
>
> **Data Collection Template:**
> | Date | Follower Count | Notable Content That Day |
> |------|---------------|--------------------------|
>
> The minimum needed for useful analysis: **follower counts at weekly intervals for at least 4 weeks**, plus a list of posts from the same period.
>
> If you know specific posts that drove follows (e.g., a post blew up), include those too."

Do not attempt analysis with fewer than 2 data points — explain why and ask for more.

---

## Growth Analysis

Work through all four dimensions before generating recommendations.

### 1. Net Growth Per Period

Calculate for each available period (daily, weekly, monthly):

- **Net new followers** = ending count − starting count
- **Gross follows vs. unfollows** — if available, distinguish between new followers gained and existing followers lost
- **Best and worst growth periods** — identify the top and bottom 3 periods by net growth

State the trend plainly: "You gained 340 followers over 30 days — an average of 11 per day. Growth was uneven: 60% of new followers came in a single 5-day window."

**Example net growth summary:**

```
Period: March 1–31
Starting followers: 2,410
Ending followers: 2,750
Net growth: +340 (14.1%)
Daily average: +11.3 followers/day
Best week: March 11–17 (+198 followers)
Worst week: March 25–31 (+22 followers)
