skills/usage-pattern-interpreter/SKILL.md
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.
npx skillsauth add stephenrogan/csm-skills usage-pattern-interpreterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
Provide whatever usage data you have:
Also provide:
Organise whatever data you have into these categories:
| Category | Metrics | What They Measure | |----------|---------|------------------| | Volume | DAU, WAU, MAU, sessions, API calls | How much the product is being used overall | | Breadth | Active users / total seats, features used / features available | How widely adoption has spread across the team and the product | | Depth | Sessions per user, actions per session, workflow completions | How deeply each user engages when they use the product | | Engagement | Login frequency, return rate, time in product | How habitually the product is part of their workflow | | Trend | Period-over-period changes in any of the above | Direction of travel -- more important than any single number |
| Pattern | How to Detect | What It Usually Means | Risk or Opportunity | |---------|-------------|---------------------|-------------------| | Steady growth | Volume and breadth increasing 5-15% month-over-month | Healthy adoption. The product is spreading organically | Opportunity: expansion (seats, tier). The team is outgrowing the current configuration | | Plateau | Metrics stable for 3+ months after initial growth | Adoption has reached its natural ceiling for the current setup | Risk 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 decline | Volume or breadth decreasing 5-10% month-over-month for 2+ months | Something is changing. Could be seasonal, could be a team change, could be a competitive evaluation | Risk: investigate immediately. Gradual declines that go unaddressed become steep declines | | Cliff drop | Volume or engagement drops >30% in a single period | Something happened. A key user left, a competing tool was adopted, an internal priority shifted, or there was a product issue | Risk: high urgency. Contact the customer within 48 hours. This is a potential churn trigger | | Feature abandonment | A feature that was actively used has zero usage for 30+ days | The team found a better way, the feature broke, the person who used it left, or the use case disappeared | Risk if the feature was core to their value proposition. Investigate root cause | | Broadening without deepening | More users logging in but each user does less | Adoption is spreading but without training or enablement. New users are exploring but not embedding the product in their workflow | Opportunity: targeted enablement for new users. Depth follows breadth if supported | | Deepening without broadening | Fewer users but each user does more | Power users are getting more value but the broader team is not adopting | Risk: concentration. If 3 power users do everything and 40 licensed users do nothing, the account is vulnerable to any of those 3 leaving | | Seasonal pattern | Usage 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 years | No action needed -- but document the pattern so you do not misinterpret the next dip | | Spike followed by return to baseline | Sudden increase (new feature launch, new team onboarding) that fades within 2-4 weeks | The initial interest did not convert to habitual usage. The feature or onboarding did not stick | Opportunity: investigate why the spike did not sustain. The interest was real; the follow-through failed | | Credential sharing | Total active users exceed licensed seats, or login patterns suggest shared credentials | Demand exceeds the current licence. Users need access but cannot get their own seats | Opportunity: expansion conversation. "Your team has outgrown the current licence -- let us make sure everyone has proper access" |
Raw patterns become actionable when matched to account context:
| Pattern | Account Context | Interpretation | |---------|----------------|---------------| | Usage declining 15% | Customer's fiscal year just ended | Likely seasonal. Monitor but do not alarm. Compare to same period last year if data exists | | Usage declining 15% | Champion left 3 weeks ago | Likely correlated to the departure. The champion may have been driving adoption personally. Urgent | | Usage declining 15% | Customer mentioned budget review last month | Potentially deliberate reduction. May be an early signal of downsell or non-renewal | | New user spike | Customer just hired 10 people | Expected. Provide onboarding resources for the new users | | New user spike | No known headcount change | Investigate. Organic spread is a positive signal. But could also be a trial by a team evaluating alternatives |
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]
| What the Data Shows | Common Misinterpretation | Better 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 |
development
Structures the CSM's week based on their portfolio status, upcoming events, overdue items, and strategic priorities. Produces a time-blocked plan that balances reactive demands with proactive account management. Use when asked to plan a week, structure daily priorities, build a weekly schedule, allocate time across accounts, manage a busy week, or when a CSM feels overwhelmed and needs to determine where to focus. Also triggers for questions about time management, weekly planning, account prioritisation for the week, daily priority setting, or how to balance competing demands across a portfolio.
development
Constructs a compelling value narrative for a customer account by connecting product usage to business outcomes in the customer's language. Produces different versions for different audiences -- the champion, the CFO, the board. Use when asked to build a value story, articulate ROI, create a business case for the customer, prepare value evidence for a renewal or QBR, or when a CSM needs to translate usage metrics into business impact the customer will recognise. Also triggers for questions about value articulation, ROI storytelling, customer business case, value evidence, or how to prove the product is worth the investment.
development
Builds a structured 30-60-90 day plan for a CSM taking over a new book of accounts or joining a new team. Prioritises accounts by risk and value, identifies immediate relationship actions, and structures the ramp to full productivity. Use when asked to plan a book transition, create a new CSM onboarding plan, structure a territory takeover, build a 30-60-90 plan for a new role, or when a CSM is inheriting accounts and needs a systematic approach to getting up to speed. Also triggers for questions about account transitions, new book ramp-up, CSM onboarding to a portfolio, territory planning, or how to take over accounts from another CSM.
development
Builds a mutual success plan with the customer that defines what success looks like, how it will be measured, who is responsible, and what the timeline is. Produces a shared document that both sides reference throughout the engagement. Use when asked to create a success plan, build a customer outcome framework, define success criteria with a customer, structure mutual goals, or when a CSM needs to align with a customer on what they are trying to achieve together. Also triggers for questions about success planning, outcome definition, customer goal alignment, mutual accountability frameworks, or how to ensure both sides know what success looks like.