agentleFS
stephenroganstephenrogan/csm-skills/skills/usage-pattern-interpreter/SKILL.md

usage-pattern-interpreter

Skill0 starsChanged 8 months agoMITView on GitHub

Takes raw usage data -- even a spreadsheet export or pasted metrics -- and identifies patterns, risks, and opportunities. Translates product analytics into account intelligence a CSM can act on. Use when asked to interpret usage data, analyse product metrics, make sense of a usage report, identify trends in customer behaviour, flag usage-based risks, or when a CSM has data but does not know what it means for the account. Also triggers for questions about usage analysis, product analytics interpretation, behavioural pattern detection, usage-based risk identification, or turning raw metrics into actionable insight.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Not every change is a signal.

    line 121

≈ “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

Usage Pattern Interpreter

Translates raw usage data into account intelligence. Most CSMs have access to product analytics dashboards but struggle to move from "what is the data showing" to "what should I do about it." This skill bridges that gap.

How to Use

Provide whatever usage data you have:

  • Dashboard exports (active users, sessions, feature usage, workflow completions)
  • Spreadsheet data (CSV or pasted tables)
  • Screenshots of analytics with numbers you can describe
  • Specific metrics you are trying to understand ("DAU dropped 30% this month -- what does it mean?")

Also provide:

  • Account context (segment, product tier, tenure, number of licensed seats)
  • Any known context for the data (did they just onboard a new team? Did they lose a key user? Is this a seasonal business?)
  • What you are worried about or trying to understand

Pattern Recognition Framework

Step 1: Classify the Data

Organise whatever data you have into these categories:

CategoryMetricsWhat They Measure
VolumeDAU, WAU, MAU, sessions, API callsHow much the product is being used overall
BreadthActive users / total seats, features used / features availableHow widely adoption has spread across the team and the product
DepthSessions per user, actions per session, workflow completionsHow deeply each user engages when they use the product
EngagementLogin frequency, return rate, time in productHow habitually the product is part of their workflow
TrendPeriod-over-period changes in any of the aboveDirection of travel -- more important than any single number

Step 2: Identify Patterns

PatternHow to DetectWhat It Usually MeansRisk or Opportunity
Steady growthVolume and breadth increasing 5-15% month-over-monthHealthy adoption. The product is spreading organicallyOpportunity: expansion (seats, tier). The team is outgrowing the current configuration
PlateauMetrics stable for 3+ months after initial growthAdoption has reached its natural ceiling for the current setupRisk if the ceiling is low (they are not using most of what they bought). Opportunity if the ceiling is high (time to deepen or expand)
Gradual declineVolume or breadth decreasing 5-10% month-over-month for 2+ monthsSomething is changing. Could be seasonal, could be a team change, could be a competitive evaluationRisk: investigate immediately. Gradual declines that go unaddressed become steep declines
Cliff dropVolume or engagement drops >30% in a single periodSomething happened. A key user left, a competing tool was adopted, an internal priority shifted, or there was a product issueRisk: high urgency. Contact the customer within 48 hours. This is a potential churn trigger
Feature abandonmentA feature that was actively used has zero usage for 30+ daysThe team found a better way, the feature broke, the person who used it left, or the use case disappearedRisk if the feature was core to their value proposition. Investigate root cause
Broadening without deepeningMore users logging in but each user does lessAdoption is spreading but without training or enablement. New users are exploring but not embedding the product in their workflowOpportunity: targeted enablement for new users. Depth follows breadth if supported
Deepening without broadeningFewer users but each user does morePower users are getting more value but the broader team is not adoptingRisk: concentration. If 3 power users do everything and 40 licensed users do nothing, the account is vulnerable to any of those 3 leaving
Seasonal patternUsage dips and peaks that repeat annually (e.g., lower in December, higher in Q1 and Q3)Normal business cycle. Not a risk signal unless the dip is deeper than prior yearsNo action needed -- but document the pattern so you do not misinterpret the next dip
Spike followed by return to baselineSudden increase (new feature launch, new team onboarding) that fades within 2-4 weeksThe initial interest did not convert to habitual usage. The feature or onboarding did not stickOpportunity: investigate why the spike did not sustain. The interest was real; the follow-through failed
Credential sharingTotal active users exceed licensed seats, or login patterns suggest shared credentialsDemand exceeds the current licence. Users need access but cannot get their own seatsOpportunity: expansion conversation. "Your team has outgrown the current licence -- let us make sure everyone has proper access"

Step 3: Contextualise

Raw patterns become actionable when matched to account context:

PatternAccount ContextInterpretation
Usage declining 15%Customer's fiscal year just endedLikely seasonal. Monitor but do not alarm. Compare to same period last year if data exists
Usage declining 15%Champion left 3 weeks agoLikely correlated to the departure. The champion may have been driving adoption personally. Urgent
Usage declining 15%Customer mentioned budget review last monthPotentially deliberate reduction. May be an early signal of downsell or non-renewal
New user spikeCustomer just hired 10 peopleExpected. Provide onboarding resources for the new users
New user spikeNo known headcount changeInvestigate. Organic spread is a positive signal. But could also be a trial by a team evaluating alternatives

Step 4: Generate Insights and Recommendations

For each significant pattern detected:

## Usage Pattern Interpretation: [Account Name]
**Data period:** [date range]
**Prepared by:** [CSM name]

### Headline
[One sentence: the most important thing the data is telling you]

### Patterns Detected
| Pattern | Metric | Detail | Confidence | Urgency |
|---------|--------|--------|-----------|---------|
| [pattern] | [metric and values] | [what you observed] | [H/M/L] | [Immediate/This week/This month/Monitor] |

### Context Assessment
[How the account context (seasonal, personnel, strategic) affects the interpretation]

### Recommended Actions
1. [Action tied to a specific pattern]
2. [Action tied to a specific pattern]

### Questions for the Customer
[Specific questions to ask that would confirm or refute your interpretation]

### Watch Signals
[What to monitor in the next 2-4 weeks to see if the pattern continues, reverses, or accelerates]

Common Misinterpretations to Avoid

What the Data ShowsCommon MisinterpretationBetter Interpretation
DAU/MAU ratio declining"They are losing interest"Could be that MAU grew (new users logged in once) while DAU stayed stable. The daily habit is fine; the new users need activation
Feature usage is zero"They do not need that feature"Could be they do not know it exists, cannot figure it out, or the feature requires configuration they have not done
Session duration declining"They are less engaged"Could mean they are more efficient. If they accomplish the same outcomes in less time, shorter sessions are a positive signal
API call volume declining"They are using the product less"Could be they optimised their integration to make fewer, more efficient calls. Check if outcomes are stable
Login frequency dropping but workflow completions stable"They are disengaging"They may be completing workflows via API or automation instead of the UI. The product is more embedded, not less

Quality Gates

  • Are you interpreting patterns, not individual data points? A single day's DAU drop is noise. A 3-week declining trend is a signal. The distinction is critical
  • Have you considered at least two explanations for each pattern? The first explanation is not always correct. Usage declining could be seasonal, personnel-related, competitive, or product-related. List the possibilities before concluding
  • Are your recommendations specific to the pattern? "Schedule a check-in" is not a recommendation for a cliff drop. "Call the customer today to ask about the 40% usage decline and whether it correlates with the champion's departure last month" is
  • Have you accounted for known context? A usage decline during December at a retail customer is expected. The same decline in March is not

Principles

  • Data tells you what happened. It does not tell you why. Your job as a CSM is to find the why. The data narrows the search space; the conversation with the customer provides the answer
  • Trends matter more than snapshots. A health score of 65 is concerning. A health score of 65 that was 78 three months ago is alarming. A health score of 65 that was 52 three months ago is encouraging. The direction is more important than the position
  • Not every change is a signal. Usage data is noisy. Holidays, vacations, product releases, and random variation all create fluctuations that look like trends but are not. Apply the "2+ consecutive periods" rule before classifying a change as a trend
  • The most dangerous data pattern is the absence of data. An account with no usage data is not healthy by default -- it is invisible. The accounts you cannot see are the accounts you cannot save

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.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.