Skill v1.0.1

currentAutomated scan96/100

tombelieber/claude-view/cv-usage

+3 new

──Details

PublishedJuly 11, 2026 at 06:39 PM

Content Hashsha256:3b47e745fd1c00d9...

Git SHAfd4ac8e82a88

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 12.2 KB)

SKILL.md12.2 KBactive

SKILL.md · 236 lines · 12.2 KB

version: "1.0.1" 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

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
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 {id}

← v1.0.0 All versions