Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/ofershap/cursor-usage/cursor-usage-analysisnpx skills add ofershap/cursor-usage --skill cursor-usage-analysisgit clone --depth 1 https://github.com/ofershap/cursor-usageWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00051 | $0.01535 |
| Opus 5 | $0.00026 | $0.00767 |
| Sonnet 5 | $0.00010 | $0.00307 |
| Haiku 4.5 | $0.00005 | $0.00153 |
Grade A, and why
cursor-usage-analysis scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- cursor-usage-analysis — 100% identical, 0 lines differ
How it starts
The opening of the file, as written. The whole thing — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Cursor Usage Analysis
You have access to Cursor Enterprise API data through the cursor-usage MCP server. This skill teaches you how to interpret that data correctly — the API returns raw numbers, but understanding what they mean requires context that isn't in the docs.
Before You Start
- Use the
get_team_overviewtool first to orient yourself — it gives you the big picture in one call. - For user-specific questions, use
get_user_deep_divewith their email. - For time-range analysis, all analytics tools accept
startDateandendDate.
Critical Data Interpretation Rules
Spending
spendCentsis the total spend including the subscription-included amount. To get overage (extra cost beyond the plan), subtractincludedSpendCents.- A user with
spendCents: 5000andincludedSpendCents: 4000has $10 in overage, not $50 in total extra cost. fastPremiumRequestscounts requests to premium/expensive models (Opus, GPT-5, etc.) that consume the fast request quota faster.- Spend limits (
hardLimitOverrideDollars) only cap overage spend, not included spend. A limit of $0 means "no overage allowed," not "no usage allowed."
Lines of Code Metrics
totalLinesAddedincludes ALL lines: agent-suggested, tab-completed, and manually typed. It is NOT a measure of AI productivity.acceptedLinesAddedis the real AI productivity metric — lines the user explicitly accepted from AI suggestions.- The acceptance rate (
acceptedLinesAdded / totalLinesAdded) is misleading because the denominator includes manual edits. UsetotalAccepts / totalAppliesfor the true AI acceptance rate. - Agent mode lines are counted in
totalLinesAddedbut may not appear inacceptedLinesAddedbecause agent mode auto-applies changes.
Request Types
composerRequests: Inline edit requests (Cmd+K / Ctrl+K)chatRequests: Chat panel conversationsagentRequests: Agent mode (autonomous multi-step tasks)usageBasedReqs: Requests that count against the usage-based billing tier (overage)cmdkUsages: Legacy name for composer/inline edit usagebugbotUsages: Automated bug detection runs
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 120 lines · 51 tokens per session scan A 958b8a3f2034
cursor-usage-analysis is a skill published in the GitHub repository ofershap/cursor-usage (8 stars, last pushed 6mo ago), licensed MIT. It adds 51 tokens to every session and 1,535 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
21st-ui
Find, install, and generate UI with 21st.dev. Use when the user asks for a UI component (pricing table, hero, navbar, dashboard, form, etc.), wants design inspiration, needs a brand logo as an SVG component, or wants to generate new UI from a prompt.
release
Use when the user asks to release, publish, or version-bump harness-score — covers the npm package, the Cursor plugin, and the docs, in the right order.
deploy
Use when the user asks to deploy or release the sample app to production; covers the full checklist from tag to smoke test.
repo-context
Use repo-context-mcp tools to map, search, and pack repository context before large edits or PR review.
MCP Integration Assistant
Helps design and implement Model Context Protocol (MCP) server integrations for AI agents.
MCP Server Builder
Step-by-step guidance for creating a new MCP server with FastMCP or the TypeScript SDK — tool definitions, resource handlers, error responses, and usage examples.