tombelieber/claude-view/cv-usage

Name: cv-usage
Author: tombelieber

Claude Code and agent skill by tombelieber/claude-view

Trust tier 2

community

By tombelieber
Coding
tombelieber/claude-view
packages/plugin/skills/cv-usage/SKILL.md
Updated 23 Sep 2026
Version 1.0.12 versions recorded

Source check pending

Checking that the SKILL.md file is still in the repository.

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'

Install

npx vskill@latest install tombelieber/claude-view/cv-usage

SKILL.md

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

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.

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

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

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%

Trends (vs last week)

Sessions: +X% | Tokens: +Y%
[any notable trend direction]

If the user asks about a specific time range (e.g. "this week", "last month"), pass from and to parameters to get_stats.

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

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

Tool	Description
Session Tools
`list_sessions`	List sessions with filters
`get_session`	Get session details
`search_sessions`	Grep search across sessions
Stats Tools
`get_stats`	Dashboard statistics
`get_fluency_score`	AI Fluency Score (0-100)
`get_token_stats`	Token usage statistics
Live Tools
`list_live_sessions`	Currently running sessions
`get_live_summary`	Aggregate live session summary
Auth Tools
`auth_post_session`	auth session
`auth_delete_session`	auth session
`auth_get_status`	auth status
Classify Tools
`classify_start_classification`	Trigger a classification job.
`classify_cancel_classification`	Cancel a running classification job.
`classify_single_session`	Classify a single session synchronously.
`classify_get_classification_status`	Get classification status.
Claude Home Tools
`claude_home_list_claude_home`	home
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_contributions`	Main contributions page data.
`contributions_get_branch_sessions`	Sessions for a branch.
`contributions_get_session_contribution`	Session contribution detail.
Devices Tools
`devices_list_devices_handler`	devices
`devices_terminate_others_handler`	others
`devices_delete_device_handler`	devices {device_id}
Export Tools
`export_sessions`	Export all sessions.
Facets Tools
`facets_facet_badges`	Quality badges (outcome + satisfaction) for the requested session IDs
`facets_trigger_facet_ingest`	Start facet ingest from the Claude Code insights cache
`facets_pattern_alert`	Check the most recent sessions for a negative satisfaction pattern
`facets_facet_stats`	Aggregate statistics across all session facets.
Health Tools
`health_config`	config
`health_check`	Health check endpoint.
`health_get_status`	Get index metadata and data freshness info.
Ide Tools
`ide_get_detect`	`GET /api/ide/detect` — return cached list of installed IDEs.
`ide_post_open`	`POST /api/ide/open` — open a file in the requested IDE.
Insights Tools
`insights_get_insights`	Compute and return behavioral insights.
`insights_get_benchmarks`	Compute personal progress benchmarks.
`insights_get_categories`	Returns hierarchical category data.
`insights_get_insights_models`	per-model usage aggregated from rollup tables.
`insights_get_insights_projects`	per-project usage aggregated from rollup tables.
`insights_get_insights_trends`	Get time-series trend data for charts.
`insights_list_invocables`	List all invocables with their usage counts.
Jobs Tools
`jobs_list_jobs`	List 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_servers`	returns all deduplicated MCP server configurations.
Memory Tools
`memory_get_all_memories`	returns all memory entries grouped by scope.
`memory_get_memory_file`	read a single memory file.
`memory_get_project_memories`	returns memories for a specific project.
Monitor Tools
`monitor_snapshot`	- One-shot JSON snapshot of current resources.
Oauth Tools
`oauth_get_auth_identity`	`GET /api/oauth/identity`
`oauth_get_oauth_usage`	`GET /api/oauth/usage`
`oauth_post_oauth_usage_refresh`	`POST /api/oauth/usage/refresh`
Pairing Tools
`pairing_generate_qr`	Generate 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_marketplaces`	plugins marketplaces
`plugins_marketplace_action`	plugins marketplaces action
`plugins_refresh_all`	all
`plugins_refresh_status`	status
`plugins_list_ops_handler`	List all queued/running/completed ops.
`plugins_enqueue_op`	Enqueue a plugin mutation, return immediately.
Processes Tools
`processes_cleanup_processes`	processes cleanup
`processes_kill_process`	processes {pid} kill
Profiles Tools
`profiles_list_profiles`	profiles
Projects Tools
`projects_list_projects`	list all projects backed by the in-memory catalog.
`projects_list_project_branches`	List distinct branches with session counts.
`projects_list_project_sessions`	paginated sessions for one project.
Prompts Tools
`prompts_list_prompts`	List prompt history with optional search/filter.
`prompts_get_prompt_stats`	Aggregate prompt statistics.
`prompts_get_prompt_templates`	Detected prompt templates.
Providers Tools
`providers_list_providers`	providers with session counts (count > 0 only, Claude Code always first).
`providers_usage`	token/cost aggregates per foreign provider within a trailing window
Reports Tools
`reports_list_reports`	List all saved reports.
`reports_get_preview`	Aggregate preview stats for a date range.
`reports_get_report`	Get a single report.
`reports_delete_report`	Delete a report.
Sessions Tools
`sessions_get_active_sessions`	returns all active session files from ~/.claude/sessions/.
`sessions_list_branches`	Get distinct list of branch names across all sessions.
`sessions_estimate_cost`	cost estimation (Rust-only, no sidecar).
`sessions_session_activity`	Activity histogram for sparkline chart.
`sessions_session_activity_rich`	Full server-side activity aggregation.
`sessions_bulk_archive_handler`	sessions archive
`sessions_bulk_unarchive_handler`	sessions unarchive
`sessions_archive_session_handler`	sessions {id} archive
`sessions_get_file_history`	List all file changes for a session.
`sessions_get_file_diff`	history/:file_hash/diff?from=N&to=M
`sessions_get_session_hook_events`	Fetch hook events for a session.
`sessions_get_session_messages_by_id`	Get paginated messages by session ID.
`sessions_get_subagent_messages`	Paginated blocks for a sub-agent.
`sessions_unarchive_session_handler`	sessions {id} unarchive
`sessions_interact_handler`	Resolve a pending interaction (permission, question, plan, elicitation).
`sessions_get_interaction_handler`	Fetch the full interaction data for a session's pending interaction.
Settings Tools
`settings_get_claude_code_settings`	returns merged, redacted Claude Code settings.
`settings_get_settings`	Read current app settings.
`settings_update_settings`	Update app settings (partial).
`settings_update_git_sync_interval`	Update the git sync interval.
Share Tools
`share_create_share`	sessions {session_id} share
`share_revoke_share`	sessions {session_id} share
`share_list_shares`	shares
Stats Tools
`stats_ai_generation_stats`	AI generation statistics with time range filtering.
`stats_overview`	Aggregate usage statistics.
`stats_storage_stats`	Storage statistics for the settings page.
`stats_get_trends`	Get week-over-week trend metrics.
Sync Tools
`sync_indexing_status`	- lightweight JSON snapshot of indexing progress.
`sync_trigger_deep_index`	Trigger a full deep index rebuild.
`sync_trigger_git_sync`	Trigger git commit scanning (A8.5).
System Tools
`system_check_path`	Check whether a filesystem path still exists.
`system_get_system_status`	Get comprehensive system status.
`system_clear_cache`	Clear obsolete search cache.
`system_trigger_git_resync`	Trigger full git re-sync.
`system_trigger_reindex`	Trigger a full re-index.
`system_reset_all`	Factory reset all data.
Teams Tools
`teams_list_teams`	List all teams.
`teams_get_team`	Get team detail.
`teams_get_team_cost`	Get team cost breakdown.
`teams_get_team_inbox`	Get team inbox messages.
`teams_get_team_sidechains`	Get team member sidechains.
Telemetry Tools
`telemetry_set_consent`	Set telemetry consent preference.
`telemetry_ingest_event`	ingress for web journey events.
Turns Tools
`turns_get_session_turns`	- Per-turn breakdown for a historical session.
Webhooks Tools
`webhooks_list_webhooks`	list all webhooks (secrets excluded).
`webhooks_create_webhook`	create a new webhook (returns signing secret once).
`webhooks_get_webhook`	get a single webhook by ID.
`webhooks_update_webhook`	update an existing webhook (partial update).
`webhooks_delete_webhook`	remove a webhook from config and secrets.
`webhooks_test_send`	send a synthetic test payload.
Workflows Tools
`workflows_list_workflows`	workflows
`workflows_create_workflow`	workflows
`workflows_control_run`	workflows run {run_id} control
`workflows_list_workflow_runs`	workflows runs
`workflows_get_workflow_run_detail`	workflows runs {session_id} {run_id}
`workflows_get_workflow_agent_detail`	workflows runs {session_id} {run_id} agents {agent_id}
`workflows_get_workflow`	workflows {id}
`workflows_delete_workflow`	workflows {i

This is the start of the file. Read the full SKILL.md on GitHub.

Security

Security scanPassed, 96 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingpackages/plugin/skills/cv-usage/SKILL.md

Popularity

Repository stars: 95
Repository forks: 9
7-day trend score: 23

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/tombelieber/claude-view/cv-usage/badge)](https://verified-skill.com/skills/tombelieber/claude-view/cv-usage)

Something wrong with this skill or its page? Tell us.