cursor-usage-analytics — Claude Code skill: analytics
cursor-usage-analytics analyzes aggregated Cursor usage across requests, models, spend, and team adoption. Use it to prepare reports and review quota signals.
MIT 1 installs ★ 2,935 updated 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a claude-codeWhat cursor-usage-analytics does
This skill structures analysis of Cursor metrics such as request volume, model mix, active users, spend, and adoption. It takes the user from defining the decision behind a metric to producing an aggregate report with an owner, time range, access boundary, and follow-up actions.
The workflow covers adoption, spending, model use, policy signals, fast-request quota review, BYOK usage, and recurring stakeholder reports. The Usage dashboard is available for Business and Enterprise plans, and the analytics purpose, access role, retention rule, and privacy or HR review must be agreed before use.
It keeps the analysis away from individual prompt inspection. Incomplete metrics are treated as directional, while spend anomalies are checked against authorized usage before limits are changed. Request counts alone should not be used to infer productivity.
What it helps with
- prepare an aggregate Cursor usage report
- compare model spend with an approved budget
- track team adoption and unused seats
- review fast-request quota anomalies
Example prompts for the agent
- Analyze Cursor usage by team and prepare an aggregate report with owners.
- Compare model spending with the approved budget and list follow-up actions.
- Review a quota anomaly without inspecting individual chat content.
How to install cursor-usage-analytics
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a claude-code2Manually: put the files in place
~/.claude/skills/cursor-usage-analytics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cursor-usage-analytics/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a codex2Manually: put the files in place
.agents/skills/cursor-usage-analytics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a cursor2Manually: put the files in place
.cursor/skills/cursor-usage-analytics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/cursor-usage-analytics2Manually: put the files in place
.github/skills/cursor-usage-analytics/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/cursor-usage-analyticsManually: put the files in place
.devin/skills/cursor-usage-analytics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cursor-usage-analytics
How do I install cursor-usage-analytics in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill cursor-usage-analytics -a claude-code, then check ~/.claude/skills/cursor-usage-analytics/SKILL.md.
What does cursor-usage-analytics do?
It organizes analysis of aggregated Cursor metrics, including requests, model usage, spend, adoption, and quota signals. The output is a report with an owner and action items.
Which Cursor plans provide the Usage dashboard?
The Usage dashboard is available on Business and Enterprise plans. The analytics purpose, access, retention, and privacy or HR review should be approved before use.
Source text
SKILL.md · MIT
--- name: cursor-usage-analytics description: 'Track and analyze Cursor usage metrics via admin dashboard: requests, model usage, team productivity, and cost optimization. Triggers on "cursor analytics", "cursor usage", "cursor metrics", "cursor reporting", "cursor dashboard", "cursor ROI". ' allowed-tools: Read, Write, Edit, Bash(cmd:*) version: 1.19.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - cursor - analytics - dashboard compatibility: Designed for Claude Code --- # Cursor Usage Analytics ## Overview Use tenant analytics to improve enablement, capacity, and policy compliance with aggregated, purpose-limited data—not to inspect individual prompts or create unapproved employee surveillance. ## Prerequisites - An approved analytics purpose, access role, retention rule, and privacy/HR review where applicable. - Aggregated reports and a named owner for any action taken from the data. ## Instructions 1. Define the decision the metric supports and collect the minimum aggregation needed. 2. Review adoption, spend, model use, and policy signals against an agreed baseline. 3. Share only authorized aggregate findings and document remediation/enablement actions. 4. Reassess access and retention regularly; do not repurpose analytics without approval. ## Output - A purpose-bound aggregate report with owner, time range, access boundary, and action items. ## Error Handling | Condition | Safe response | |---|---| | Report exposes individual sensitive behavior | Restrict access, aggregate/redact further, and consult privacy/HR owners. | | Metric is incomplete | Mark it as directional; do not make performance or spending decisions as if it were complete. | | Spend anomaly appears | Verify authorized usage and tighten approved limits rather than inspecting prompt content. | ## Examples Review monthly aggregate model spend by team against budget, publish the variance and owner, and adjust approved caps after review. Do not export individual chat content or infer productivity from request counts. Track and analyze Cursor usage metrics for Business and Enterprise plans. Covers dashboard metrics, cost optimization, adoption tracking, and ROI measurement. ## Admin Dashboard Overview Access: [cursor.com/settings](https://cursor.com/settings) > Team > Usage (Business/Enterprise only) ``` ┌─ Dashboard ────────────────────────────────────────────┐ │ │ │ Total Requests This Month: 12,847 │ │ Fast Requests Remaining: 2,153 / 15,000 │ │ Active Users: 28 / 30 seats │ │ Most Used Model: Claude Sonnet (62%) │ │ │ │ ┌─ Usage Trend ─────────────────────────────────┐ │ │ │ ▆▆▇▇██▇▆▇█▇▇▆▅ │ │ │ │ Mon Tue Wed Thu Fri Sat Sun │ │ │ └───────────────────────────────────────────────┘ │ │ │ │ ┌─ Top Users ───────────────────────────────────┐ │ │ │ [email protected] 847 requests (Sonnet) │ │ │ │ [email protected] 623 requests (GPT-4o) │ │ │ │ [email protected] 591 requests (Auto) │ │ │ └───────────────────────────────────────────────┘ │ │ │ └────────────────────────────────────────────────────────┘ ``` ## Key Metrics ### Request Metrics | Metric | What It Measures | Target | |--------|-----------------|--------| | Total requests | All AI interactions (Chat, Composer, Inline Edit) | Growing month-over-month | | Fast requests | Premium model uses (count against quota) | Stay under monthly limit | | Slow requests | Queued requests after quota exceeded | Minimize (upgrade if high) | | Tab acceptances | How often Tab suggestions are accepted | 30-50% acceptance rate is healthy | ### User Adoption Metrics | Metric | Healthy | Needs Attention | |--------|---------|-----------------| | Weekly active users | 80%+ of seats | Below 50% of seats | | Requests per user/day | 5-20 | Below 3 (underutilization) | | Users with 0 requests (30d) | 0-10% of seats | Above 20% (wasted seats) | | Model diversity | 2-3 models used | Single model only | ### Cost Metrics | Metric | Calculation | |--------|-------------| | Cost per seat | Plan price / active users | | Cost per request | Total spend / total requests | | BYOK costs | Sum of API provider invoices | | Total AI spend | Cursor subscription + BYOK costs | ## Quota Management ### Fast Request Quota Each team member gets ~500 fast requests per month (varies by plan). Fast requests are consumed when using premium models (Claude Sonnet/Opus, GPT-4o, o1, etc.). When quota is exceeded: - Requests are queued as "slow" (may take 30-60 seconds instead of 5-10) - Tab completion is unaffected - cursor-small model remains fast ### Strategies to Stay Under Quota ``` 1. Default to Auto mode - Cursor routes simple queries to cheaper models - Only uses premium models when complexity warrants it 2. Educate team on model selection - Simple questions → cursor-small or GPT-4o-mini - Standard coding → GPT-4o or Claude Sonnet - Hard problems only → Claude Opus, o1 (these burn quota fast) 3. Reduce round-trips - Write detailed prompts (fewer back-and-forth turns) - Use @Files instead of @Codebase (less context = faster) - Start new chats instead of continuing stale ones 4. BYOK for power users - Heavy users can use their own API keys - Their requests don't count against team quota ``` ## Reporting for Stakeholders ### Monthly Report Template ```markdown # Cursor Usage Report - [Month Year] ## Summary - Active users: X / Y seats (X% utilization) - Total AI requests: X,XXX - Fast request quota usage: XX% - Monthly cost: $X,XXX ## Adoption Trends - New users onboarded: X - Users showing increased usage: X - Inactive users (0 requests): X ## Model Usage Distribution - Claude Sonnet: XX% - GPT-4o: XX% - Auto: XX% - Other: XX% ## Recommendations - [Scale / optimize / train based on data] ``` ### ROI Calculation ``` Time saved per developer per day: ~1 hour (conservative estimate) Working days per month: 22 Developer hourly cost (fully loaded): $75 Monthly time savings per developer: 22 hours × $75 = $1,650 Cursor cost per developer: $40/month (Business) ROI per developer: $1,650 - $40 = $1,610/month ROI multiple: 41x Break-even: developer saves >32 minutes/month ``` **Note:** Actual time savings vary. Track team velocity (story points, PRs merged, cycle time) before and after Cursor adoption for data-driven ROI. ## Usage Optimization Playbook ### For Underutilized Teams (< 5 requests/user/day) ``` 1. Run team training session (30 min demo of Chat + Composer) 2. Share the cursor-hello-world skill for hands-on practice 3. Create project rules (.cursor/rules/) so AI gives better results 4. Assign "AI Champion" per team to share tips and answer questions 5. Set a 30-day adoption goal and review progress ``` ### For Overutilized Teams (quota consistently exceeded) ``` 1. Review model usage -- are users defaulting to expensive models? 2. Enable Auto mode as team default 3. Train on efficient prompting (fewer turns = fewer requests) 4. Consider BYOK for top 5 users (offloads their usage from team quota) 5. Evaluate upgrading to more seats or Enterprise plan ``` ### For Inconsistent Usage ``` 1. Check if project rules are configured (AI is less useful without them) 2. Verify indexing works (poor @Codebase = poor experience) 3. Look for extension conflicts (GitHub Copilot still enabled?) 4. Survey team for friction points and address them ``` ## Enterprise Considerations - **Advanced analytics**: Enterprise plans include detailed per-user, per-model, per-project breakdowns - **API access**: Programmatic access to usage data for integration with internal dashboards (Enterprise) - **Compliance reporting**: Usage logs can support audit requirements (who used AI, when, which model) - **Cost allocation**: Tag usage by team/project for internal chargeback accounting ## Resources - [Cursor Admin Dashboard](https://cursor.com/settings) - [Cursor Pricing](https://cursor.com/pricing) - [Cursor Enterprise](https://cursor.com/enterprise)
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace