agentleFS
Docat0209Docat0209/SoloForge/skills/data-decide/SKILL.md

data-decide

Skill1 starsChanged 7 months agoMITView on GitHub

Data analyst: HOW to interpret data and make decisions (event taxonomy, cohort analysis, A/B test statistical rigor, vanity vs actionable metrics, decision frameworks). Triggers ONLY when: user asks to set up analytics, interpret metrics, design an A/B test, or make a data-driven decision. Do NOT trigger during development or casual metric discussion.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Always object_action, never action_object — keeps autocomplete useful

    line 26
  2. Distinctive:

    Never put PII (email, name) in event properties — use anonymous user IDs

    line 29
  3. Distinctive:

    Document every event in a tracking plan (living doc, reviewed monthly)

    line 30
  4. Distinctive:

    The test: if the metric doesn't change your next action, stop tracking it.

    line 36
  5. Distinctive:

    All cohorts dropping to zero = you have a leaky bucket (fix retention before growth)

    line 59

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Data-Decide SOP

Boundary

This skill (data-decide) = HOW to interpret data. The data analyst: event taxonomy design, cohort analysis methodology, A/B test statistical rigor, vanity vs actionable metric evaluation, and decision frameworks for acting on data.

Not this skill — use growth-track instead for WHAT to track: AARRR funnel metrics, North Star metric definition, budget management, experiment design templates, and weekly growth reports.

1. Event Taxonomy

Design events before writing code. Use object_action naming convention consistently.

Core events to track (minimum viable analytics):

  • Authentication: user_signed_up, user_logged_in, user_logged_out
  • Activation: onboarding_started, onboarding_completed, feature_first_used
  • Engagement: project_created, item_edited, search_performed
  • Monetization: plan_selected, payment_completed, subscription_cancelled
  • Retention: session_started, user_returned (after 7+ day absence)

Naming rules (Amplitude taxonomy best practices):

  • Always object_action, never action_object — keeps autocomplete useful
  • Past tense for completed events (payment_completed), not gerunds
  • Properties use snake_case: plan_name, referral_source, time_to_activate_seconds
  • Never put PII (email, name) in event properties — use anonymous user IDs
  • Document every event in a tracking plan (living doc, reviewed monthly)

Source: Amplitude — Plan Your Taxonomy, PostHog SaaS Guide

2. Vanity vs Actionable Metrics (Eric Ries, Lean Startup)

The test: if the metric doesn't change your next action, stop tracking it.

Vanity (feels good)Actionable (drives decisions)
Total registered usersActivation rate (% completing onboarding)
Page viewsConversion rate (visitor → signup)
Total revenue (cumulative)MRR growth rate (week over week)
App downloadsDay-7 retention rate

Three A's of actionable metrics (Ries):

  1. Actionable — clear cause and effect; you know what lever moved it
  2. Accessible — simple enough that the whole team understands it
  3. Auditable — you can trace the number back to raw data

Source: Eric Ries on Tim Ferriss blog, Lean Startup Co.

3. Cohort Analysis

Group users by signup week. Track retention at day 1, day 7, day 30.

How to read cohort curves:

  • Flattening curve = users who stay are sticky (good)
  • Newer cohorts retaining better than older = product is improving (great)
  • All cohorts dropping to zero = you have a leaky bucket (fix retention before growth)

Implementation (minimal):

  1. Store signup_date with every user
  2. Query: for each signup week, count active users at +1d, +7d, +30d
  3. Plot as a retention table or curve chart
  4. Compare curves across cohorts — the shape matters more than absolute numbers

4. A/B Test Design

Before running any test:

  1. Write the hypothesis: "If [change], then [metric] will [direction] by [amount]"
    • Bad: "The new button will be better"
    • Good: "If we change CTA from 'Start Free' to 'Try It Now', signup rate will increase by 10%"
  2. Calculate sample size BEFORE running — use Evan Miller's calculator
    • Inputs: baseline conversion rate, minimum detectable effect (MDE), power (0.80), significance (0.05)
  3. Run for full weeks — minimum 14 days to avoid day-of-week bias
  4. Do not peek — checking results early inflates false positive rate
  5. Statistical significance: p < 0.05 minimum (95% confidence)
  6. Practical significance matters too — a statistically significant 0.1% improvement may not be worth implementing

Source: Statsig — Determine Sample Size, GuessTheTest — Sample Size Guide

5. Decision Framework

Data informs, doesn't decide. Use this ladder:

Data clarityAction
High confidence (>95%, large effect)Follow the data
Moderate (80-95%, small effect)Data + qualitative signals (user interviews, support tickets)
Ambiguous (<80% or conflicting)Use judgment, acknowledge uncertainty
No data at allRun the smallest possible experiment first

When data and intuition conflict: favor data for incremental decisions, favor vision for strategic bets. Document why you overrode data when you do.

6. Tools (Solo/Small Team)

NeedRecommendationWhy
Product analyticsPostHog (self-hosted, free)Full-featured, privacy-friendly, no data caps
Web analyticsPlausiblePrivacy-focused, lightweight, GDPR-compliant
A/B testingGrowthBook (free tier) or PostHog feature flagsProper statistical engine, integrates with your data
Error trackingSentry (free tier)Stack traces + user context
Avoid unless necessaryGoogle AnalyticsPrivacy tradeoff, complex, overkill for early stage

Next Steps

Report to user: "Analysis complete. Key finding: [one line]. Recommendation: [action]"

Suggested next steps (user decides):

  • Product issue found → "Run product-eval"
  • Acquisition issue → "Run growth-track"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.