Agent skill

Cv Usage

by tombelieber in tombelieber/claude-view

A skill your agent uses when the user asks about usage analytics, statistics, token usage, or cost summary — e.g.

MITAuto-check passedData & Analytics

Install Cv Usage

skills CLI
$ npx skills add tombelieber/claude-view --skill cv-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tombelieber/claude-view cv-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tombelieber/claude-view.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/plugin/skills/cv-usage .claude/skills/cv-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cv-usage
GitHub stars
111
Token cost
~3.1k tokens
SKILL.md length
1,134 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks about usage analytics, statistics, token usage, or cost summary — e.g.

  • Works in 4 steps: Get dashboard stats. Call… → Get token stats. Call… → Get trends. Call… → …
  • The user asks about usage analytics
  • SKILL.md covers Steps, Usage Report — [date range or… and Available Tools
  • Calls npx

What it does

Cv Usage is an agent skill from tombelieber/claude-view. Use when the user asks about usage analytics, statistics, token usage, or cost summary — e.g. 'usage stats', 'token usage', 'how many sessions this week', 'show me my numbers', 'cost summary', 'usage report'

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Data & Analytics, covering Product analytics, Statistics and LLM cost and token optimization. It works with Model Context Protocol. The repository describes itself as: 10 Claude sessions running. What are they doing? Live dashboard — monitor, cost tracking, search, sub-agent visibility. The licence is MIT.

When your agent uses it

  • The user asks about usage analytics
  • Cost summary — e.g

Example prompts

  • “usage stats”
  • “token usage”
  • “how many sessions this week”
  • “/cv-usage”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): mcp__claude-view__get_stats, mcp__claude-view__get_token_stats, mcp__claude-view__stats_ai_generation_stats, mcp__claude-view__stats_overview, mcp__claude-view__stats_storage_stats, mcp__claude-view__stats_get_trends

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Get dashboard stats. Call mcpclaude-viewget_stats to get session counts, top projects, and current week metrics. If the user specifies a…
  2. Get token stats. Call mcpclaude-viewget_token_stats to get input/output/cache token totals and cache hit ratio.
  3. Get trends. Call mcpclaude-viewstats_get_trends to get week-over-week comparison.
  4. Present the report

What it can do on your machine

Read from SKILL.md and the folder at commit ff3cdd1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__claude-view__get_stats
    • mcp__claude-view__get_token_stats
    • mcp__claude-view__stats_ai_generation_stats
    • mcp__claude-view__stats_overview
    • mcp__claude-view__stats_storage_stats
    • mcp__claude-view__stats_get_trends

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cv Usage loads about 3.1k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 1,134 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tombelieber/claude-view at commit ff3cdd1, republished under its MIT licence (© tombelieber). 1,134 words, ~3,110 tokens.

Download SKILL.mdSave it as .claude/skills/cv-usage/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
cv-usage
description
Use when the user asks about usage analytics, statistics, token usage, or cost summary — e.g. 'usage stats', 'token usage', 'how many sessions this week', 'show me my numbers', 'cost summary', 'usage report'
allowed-tools
mcp__claude-view__get_stats, mcp__claude-view__get_token_stats, mcp__claude-view__stats_ai_generation_stats, mcp__claude-view__stats_overview, mcp__claude-view__stats_storage_stats, mcp__claude-view__stats_get_trends

You have access to the claude-view MCP server which provides tools for monitoring, analyzing, and managing Claude Code sessions. The claude-view server must be running on localhost (it auto-starts via the plugin hook).

Important: All tool names are prefixed with mcp__claude-view__. When calling a tool, always use the full prefixed name.

Error handling: If a tool returns an error about the server not being detected, tell the user to start it with npx claude-view.

Usage Report

Show usage statistics, token consumption, storage, and trends. This skill focuses on quantitative usage data. For behavioral patterns and insights, use the /insights skill instead.

Steps

  1. Get dashboard stats. Call mcp__claude-view__get_stats to get session counts, top projects, and current week metrics. If the user specifies a time range, pass from and to parameters.

  2. Get token stats. Call mcp__claude-view__get_token_stats to get input/output/cache token totals and cache hit ratio.

  3. Get trends. Call mcp__claude-view__stats_get_trends to get week-over-week comparison.

  4. Present the report:

Usage Report — [date range or "All Time"]

Overview
  • Sessions: N total | This week: M
  • Projects: P | Top: [project name] (X sessions)
Tokens
  • Input: X | Output: Y | Cache read: Z
  • Cache hit ratio: X%
  • Sessions: +X% | Tokens: +Y%
  • [any notable trend direction]
  1. If the user asks about a specific time range (e.g. "this week", "last month"), pass from and to parameters to get_stats.

  2. If no sessions found, say "No Claude Code sessions found for this time range."

  3. Do NOT show Fluency Score in this report. It requires behavioral context that the /insights skill provides. Showing a bare number without context violates the trust-over-accuracy principle.

Available Tools

ToolDescription
Session Tools
list_sessionsList sessions with filters
get_sessionGet session details
search_sessionsGrep search across sessions
Stats Tools
get_statsDashboard statistics
get_fluency_scoreAI Fluency Score (0-100)
get_token_statsToken usage statistics
Live Tools
list_live_sessionsCurrently running sessions
get_live_summaryAggregate live session summary
Auth Tools
auth_post_sessionauth session
auth_delete_sessionauth session
auth_get_statusauth status
Classify Tools
classify_start_classificationTrigger a classification job.
classify_cancel_classificationCancel a running classification job.
classify_single_sessionClassify a single session synchronously.
classify_get_classification_statusGet classification status.
Claude Home Tools
claude_home_list_claude_homehome
Cli Tools
cli_create_session- Create a new tmux-backed CLI session.
Coaching Tools
coaching_list_rules- List all coaching rules from the rules directory.
coaching_apply_rule- Create a new coaching rule file.
coaching_remove_rule- Remove a coaching rule file.
Contributions Tools
contributions_get_contributionsMain contributions page data.
contributions_get_branch_sessionsSessions for a branch.
contributions_get_session_contributionSession contribution detail.
Devices Tools
devices_list_devices_handlerdevices
devices_terminate_others_handlerothers
devices_delete_device_handlerdevices {device_id}
Export Tools
export_sessionsExport all sessions.
Facets Tools
facets_facet_badgesQuality badges (outcome + satisfaction) for the requested session IDs
facets_trigger_facet_ingestStart facet ingest from the Claude Code insights cache
facets_pattern_alertCheck the most recent sessions for a negative satisfaction pattern
facets_facet_statsAggregate statistics across all session facets.
Health Tools
health_configconfig
health_checkHealth check endpoint.
health_get_statusGet index metadata and data freshness info.
Ide Tools
ide_get_detectGET /api/ide/detect — return cached list of installed IDEs.
ide_post_openPOST /api/ide/open — open a file in the requested IDE.
Insights Tools
insights_get_insightsCompute and return behavioral insights.
insights_get_benchmarksCompute personal progress benchmarks.
insights_get_categoriesReturns hierarchical category data.
insights_get_insights_modelsper-model usage aggregated from rollup tables.
insights_get_insights_projectsper-project usage aggregated from rollup tables.
insights_get_insights_trendsGet time-series trend data for charts.
insights_list_invocablesList all invocables with their usage counts.
Jobs Tools
jobs_list_jobsList all active jobs.
Live Tools
live_get_pricing- Return the model pricing table.
live_dismiss_all_closed- Dismiss all recently closed (in-memory only).
live_get_live_session- Get a single live session by ID.
live_dismiss_session- Dismiss from recently closed (in-memory only).
live_get_live_session_messages- Get the most recent messages for a live session.
Mcp Tools
mcp_get_mcp_serversreturns all deduplicated MCP server configurations.
Memory Tools
memory_get_all_memoriesreturns all memory entries grouped by scope.
memory_get_memory_fileread a single memory file.
memory_get_project_memoriesreturns memories for a specific project.
Monitor Tools
monitor_snapshot- One-shot JSON snapshot of current resources.
Oauth Tools
oauth_get_auth_identityGET /api/oauth/identity
oauth_get_oauth_usageGET /api/oauth/usage
oauth_post_oauth_usage_refreshPOST /api/oauth/usage/refresh
Pairing Tools
pairing_generate_qrGenerate a QR payload via Supabase pair-offer.
Plans Tools
plans_get_session_plans- returns plan documents for the session's slug.
Plugins Tools
plugins_list_plugins- Unified view of installed + available plugins.
plugins_list_marketplacesplugins marketplaces
plugins_marketplace_actionplugins marketplaces action
plugins_refresh_allall
plugins_refresh_statusstatus
plugins_list_ops_handlerList all queued/running/completed ops.
plugins_enqueue_opEnqueue a plugin mutation, return immediately.
Processes Tools
processes_cleanup_processesprocesses cleanup
processes_kill_processprocesses {pid} kill
Projects Tools
projects_list_projectslist all projects backed by the in-memory catalog.
projects_list_project_branchesList distinct branches with session counts.
projects_list_project_sessionspaginated sessions for one project.
Prompts Tools
prompts_list_promptsList prompt history with optional search/filter.
prompts_get_prompt_statsAggregate prompt statistics.
prompts_get_prompt_templatesDetected prompt templates.
Providers Tools
providers_list_providersproviders with session counts (count > 0 only, Claude Code always first).
providers_usagetoken/cost aggregates per foreign provider within a trailing window
Reports Tools
reports_list_reportsList all saved reports.
reports_get_previewAggregate preview stats for a date range.
reports_get_reportGet a single report.
reports_delete_reportDelete a report.
Sessions Tools
sessions_get_active_sessionsreturns all active session files from ~/.claude/sessions/.
sessions_list_branchesGet distinct list of branch names across all sessions.
sessions_estimate_costcost estimation (Rust-only, no sidecar).
sessions_session_activityActivity histogram for sparkline chart.
sessions_session_activity_richFull server-side activity aggregation.
sessions_bulk_archive_handlersessions archive
sessions_bulk_unarchive_handlersessions unarchive
sessions_archive_session_handlersessions {id} archive
sessions_get_file_historyList all file changes for a session.
sessions_get_file_diffhistory/:file_hash/diff?from=N&to=M
sessions_get_session_hook_eventsFetch hook events for a session.
sessions_get_session_messages_by_idGet paginated messages by session ID.
sessions_get_subagent_messagesPaginated blocks for a sub-agent.
sessions_unarchive_session_handlersessions {id} unarchive
sessions_interact_handlerResolve a pending interaction (permission, question, plan, elicitation).
sessions_get_interaction_handlerFetch the full interaction data for a session's pending interaction.
Settings Tools
settings_get_claude_code_settingsreturns merged, redacted Claude Code settings.
settings_get_settingsRead current app settings.
settings_update_settingsUpdate app settings (partial).
settings_update_git_sync_intervalUpdate the git sync interval.
Share Tools
share_create_sharesessions {session_id} share
share_revoke_sharesessions {session_id} share
share_list_sharesshares
Stats Tools
stats_ai_generation_statsAI generation statistics with time range filtering.
stats_overviewAggregate usage statistics.
stats_storage_statsStorage statistics for the settings page.
stats_get_trendsGet week-over-week trend metrics.
Sync Tools
sync_indexing_status- lightweight JSON snapshot of indexing progress.
sync_trigger_deep_indexTrigger a full deep index rebuild.
sync_trigger_git_syncTrigger git commit scanning (A8.5).
System Tools
system_check_pathCheck whether a filesystem path still exists.
system_get_system_statusGet comprehensive system status.
system_clear_cacheClear obsolete search cache.
system_trigger_git_resyncTrigger full git re-sync.
system_trigger_reindexTrigger a full re-index.
system_reset_allFactory reset all data.
Teams Tools
teams_list_teamsList all teams.
teams_get_teamGet team detail.
teams_get_team_costGet team cost breakdown.
teams_get_team_inboxGet team inbox messages.
teams_get_team_sidechainsGet team member sidechains.
Telemetry Tools
telemetry_set_consentSet telemetry consent preference.
telemetry_ingest_eventingress for web journey events.
Turns Tools
turns_get_session_turns- Per-turn breakdown for a historical session.
Webhooks Tools
webhooks_list_webhookslist all webhooks (secrets excluded).
webhooks_create_webhookcreate a new webhook (returns signing secret once).
webhooks_get_webhookget a single webhook by ID.
webhooks_update_webhookupdate an existing webhook (partial update).
webhooks_delete_webhookremove a webhook from config and secrets.
webhooks_test_sendsend a synthetic test payload.
Workflows Tools
workflows_list_workflowsworkflows
workflows_create_workflowworkflows
workflows_control_runworkflows run {run_id} control
workflows_list_workflow_runsworkflows runs
workflows_get_workflow_run_detailworkflows runs {session_id} {run_id}
workflows_get_workflow_agent_detailworkflows runs {session_id} {run_id} agents {agent_id}
workflows_get_workflowworkflows {id}
workflows_delete_workflowworkflows {id}

© tombelieber, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/plugin/skills/cv-usage of tombelieber/claude-view.

  • SKILL.md
  • SKILL.md.tmpl

Open the folder on GitHubat commit ff3cdd1

Compare with similar skills

Cv Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cv Usage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cv Usage this skilltombelieber/claude-view111—~3.1kAutomated safety check: PassMIT
Find Hypertable Candidatestimescale/pg-aiguide1.9k1 repos~2.6kAutomated safety check: PassApache-2.0
Retentioneering Contributingretentioneering/retentioneering-tools927—~1.8kAutomated safety check: PassApache-2.0
Retentioneering Product Analyticsretentioneering/retentioneering-tools927—~1.6kAutomated safety check: PassApache-2.0
Querying Indonesian Gov Datasuryast/indonesia-gov-apis172—~997Automated safety check: PassMIT
A/B Test Analysisphuryn/pm-skills27k—~893Automated safety check: PassMIT

Similar skills

  • Find Hypertable Candidates

    timescale/pg-aiguide

    A skill your agent uses to analyze an existing PostgreSQL database and identify which tables should be converted to Timescale/TimescaleDB hypertables.

    1.9k GitHub starsUsed in 1 repo~2.6k tokens
    Data & AnalyticsAuto-check passed
  • Retentioneering Contributing

    retentioneering/retentioneering-tools

    Help the user turn their Retentioneering ideas, friction reports, bug findings, or feature needs into high-quality upstream contributions: from capturing and validating the idea, through minimal…

    927 GitHub stars~1.8k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • Retentioneering Product Analytics

    retentioneering/retentioneering-tools

    Analyze event logs, clickstreams, user paths, product funnels, retention, behavioral segments, transition graphs, step matrices, sequence patterns, and customer journeys using Retentioneering.

    927 GitHub stars~1.6k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • Querying Indonesian Gov Data

    suryast/indonesia-gov-apis

    Query 57 Indonesian government APIs and data sources — BPJPH halal certification, BPOM food safety, OJK financial legality, BPS statistics, BMKG weather/earthquakes, Bank Indonesia exchange rates…

    172 GitHub stars~997 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • A/B Test Analysis

    phuryn/pm-skills

    Validates an experiment's setup, works out lift, p-value and confidence interval from A/B test data, and recommends whether to ship, extend or stop.

    27k GitHub stars~893 tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Prod Telemetry

    UsefulSoftwareCo/executor

    Query Executor's production telemetry — Axiom traces (executor-cloud dataset), prod Postgres via PlanetScale, PostHog product analytics — through the Executor MCP.

    4.1k GitHub stars~1.9k tokensUpdated today
    Data & AnalyticsAuto-check passed

More from tombelieber/claude-view

All 13 skills in this repo
  • Claude View Coaching

    tombelieber/claude-view

    Reviews your Claude Code habits through the claude-view server, showing an AI Fluency Score and insights and letting you add or remove personal coaching rules.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Code Daily Cost Report

    tombelieber/claude-view

    Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request.

    111 GitHub stars~3k tokensUpdated 9 days ago
    Auto-check passed
  • Export Claude Sessions

    tombelieber/claude-view

    Exports Claude Code session history from the claude-view server as JSON, filtered by date range or project, for backup or analysis elsewhere.

    111 GitHub stars~2.9k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Code Behavioral Insights

    tombelieber/claude-view

    Pulls pattern, trend and benchmark data from the claude-view MCP server to present a behavioral analysis of your Claude Code usage, grouped by category.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • claude-view Project Overview

    tombelieber/claude-view

    Shows a dashboard for one project, or a table of all projects, from the claude-view MCP server: sessions, branches and contribution data.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Session Search

    tombelieber/claude-view

    Search your Claude Code session history through the claude-view MCP server, matching summaries, commit messages and project or branch names, and present the most relevant sessions.

    111 GitHub stars~3k tokensUpdated 9 days ago
    Auto-check passed

Questions about Cv Usage

What does Cv Usage do?

A skill your agent uses when the user asks about usage analytics, statistics, token usage, or cost summary — e.g. Cv Usage is an agent skill from tombelieber/claude-view.g.

When should I use Cv Usage?

Cv Usage fits situations like: the user asks about usage analytics; cost summary — e.g.

How do I install Cv Usage in Claude Code?

Run `npx skills add tombelieber/claude-view --skill cv-usage -a claude-code`. Or copy the skill folder (packages/plugin/skills/cv-usage in tombelieber/claude-view) into .claude/skills/cv-usage in your project. Claude Code loads it when a task matches its description.

How do I install Cv Usage in Codex?

Run `npx skills add tombelieber/claude-view --skill cv-usage -a codex`. Or copy the skill folder (packages/plugin/skills/cv-usage in tombelieber/claude-view) into .agents/skills/cv-usage in your project. Codex loads it when a task matches its description.

Can I use Cv Usage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tombelieber/claude-view --skill cv-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cv-usage, .gemini/skills/cv-usage, .github/skills/cv-usage and .opencode/skills/cv-usage in your project.

What does Cv Usage need to run?

Going by SKILL.md and its folder, Cv Usage needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: mcp__claude-view__get_stats, mcp__claude-view__get_token_stats, mcp__claude-view__stats_ai_generation_stats, mcp__claude-view__stats_overview, mcp__claude-view__stats_storage_stats, mcp__claude-view__stats_get_trends.

Does Cv Usage access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cv Usage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cv Usage use?

Cv Usage is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cv Usage use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cv Usage?

Skills that share tags, products or a category with Cv Usage: Find Hypertable Candidates (timescale/pg-aiguide, 1.9k stars), Retentioneering Contributing (retentioneering/retentioneering-tools, 927 stars), Retentioneering Product Analytics (retentioneering/retentioneering-tools, 927 stars) and Querying Indonesian Gov Data (suryast/indonesia-gov-apis, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cv Usage?

tombelieber (a GitHub user) maintains it in tombelieber/claude-view, which has 111 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: tombelieber/claude-view on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.