agent-instructions
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when analyzing a product's performance or deciding what to build. Covers metric selection, funnel and retention analysis, distinguishing signal from noise, and prioritizing on evidence.
$ npx -y skills add nimadorostkar/Claude-Skills-collection --skill product-analysis --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/product-analysisContext preview
The summary Claude sees to decide when to auto-load this skill.
Use when analyzing a product's performance or deciding what to build. Covers metric selection, funnel and retention analysis, distinguishing signal from noise, and prioritizing on evidence.
name: product-analysis description: Use when analyzing a product's performance or deciding what to build. Covers metric selection, funnel and retention analysis, distinguishing signal from noise, and prioritizing on evidence. metadata: category: business version: 1.0.0 tags: [product, metrics, retention, funnel, prioritization]
Understand how a product is actually used and decide what to do about it. The failure mode is a dashboard full of numbers that go up, none of which are connected to whether the product is working.
1. **Choose the metric that reflects value received** — Not signups, not page views, not "engagement". What is the action that means the user got what they came for? That is the metric. 2. **Look at retention before acquisition** — A product with a leaking bucket does not need more water. If week-4 retention is 8%, acquisition spend is being poured into a hole. 3. **Segment before concluding** — An aggregate number hides everything. A flat retention curve can be two cohorts: one that retains at 60% and one at 2%. Those require completely different responses. 4. **Find the drop-off, then find out why** — The funnel tells you *where* users leave. It never tells you *why*. That requires session recordings, support tickets, or asking them. 5. **Distinguish a movement from noise** — A 6% week-on-week change on a small base is noise. Before declaring a trend, check whether the change exceeds the normal variance. 6. **Recommend something specific** — With the expected impact and how you will know if it worked.
**Segmentation revealing the actual product:**
Aggregate week-4 retention: 22%. Flat for six months. Universally described in
the company as "our retention problem".
Segmented by the first action taken in the first session:
Created a project + invited a teammate (11% of signups) : 71% retained at wk 4
Created a project alone (34% of signups) : 24%
Browsed, created nothing (55% of signups) : 3%
There is no retention problem. There is an activation problem, and a specific one:
users who invite a teammate in the first session retain at 71%, which is an
excellent number for this category.
The aggregate of 22% is a weighted average of one product that works extremely
well and one that does not exist — because 55% of signups never create anything.
What this changes:
- The roadmap item "improve retention with weekly digest emails" is targeting
the wrong thing. It emails people who never activated.
- The correct target is the 55% who create nothing, and the specific question
is why they leave without acting. That is a session-recording and
user-interview question, not a data question.
- The second target is moving single-user projects toward invites, which the
data suggests triples retention.
Neither of these was visible in the aggregate.**Checking that a movement is real before acting on it:**
def is_signal(series: pd.Series, window: int = 12) -> Signal:
"""Most 'the metric moved!' investigations are investigations of noise."""
recent = series.iloc[-1]
baseline = series.iloc[-window - 1 : -1]
mean, std = baseline.mean(), baseline.std()
z = (recent - mean) / std if std > 0 else 0
return Signal(
value=recent,
baseline_mean=mean,
z_score=z,
# Within 2 standard deviations of the trailing mean is normal variation.
verdict=(
"signal" if abs(z) > 2 else
"noise — this is within normal week-to-week variance"
),
)
# Signups fell 9% this week. Panic in the standup.
# trailing 12-week std: 7.4%
# z-score: -1.2
# Verdict: noise. This week is not unusual. Do not investigate; do not
# change anything. It will "recover" next week and someone will take credit.A curated library of 137 production-grade skills for Claude and other AI coding agents. Every skill follows one structure, speaks with one voice, and earns its place by changing what the agent does.
Repo: nimadorostkar/Claude-Skills-collection
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when an agent needs state that survives a session or a context compaction. Covers what to persist, file-based memory, structuring notes for retrieval, and…
Use when automating agent behavior with lifecycle hooks. Covers hook events, deterministic enforcement of rules the model should not be trusted to remember,…
Use when packaging skills, commands, hooks, and MCP servers into a distributable plugin. Covers manifest structure, bundling, versioning, testing, and…
Use when writing a new skill for an AI agent. Covers scoping, description writing for reliable triggering, progressive disclosure, and the difference between a…
Use when reviewing or improving an existing agent skill. Covers triggering accuracy, content quality, redundancy with the base model, and measuring whether the…