Agent skill

analytics

Query cross-project usage analytics. Use when reviewing agent, skill, hook, or team performance across OrchestKit projects. Also replay sessions, estimate costs, and view model delegation trends.

Stars 143
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/yonatangross/orchestkit/tree/main/src/skills/analytics

Metadata

Additional technical details for this skill

category
document-asset-creation

SKILL.md

Cross-Project Analytics

Query local analytics data from ~/.claude/analytics/. All data is local-only, privacy-safe (hashed project IDs, no PII).

Subcommands

Parse the user's argument to determine which report to show. If no argument provided, use AskUserQuestion to let them pick.

Subcommand Description Data Source Reference
agents Top agents by frequency, duration, model breakdown agent-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md
models Model delegation breakdown (opus/sonnet/haiku) agent-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md
skills Top skills by invocation count skill-usage.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md
hooks Slowest hooks and failure rates hook-timing.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md
teams Team spawn counts, idle time, task completions team-activity.jsonl ${CLAUDE_SKILL_DIR}/references/jq-queries.md
session Replay a session timeline with tools, tokens, timing CC session JSONL ${CLAUDE_SKILL_DIR}/references/session-replay.md
cost Token cost estimation with cache savings stats-cache.json ${CLAUDE_SKILL_DIR}/references/cost-estimation.md
trends Daily activity, model delegation, peak hours stats-cache.json ${CLAUDE_SKILL_DIR}/references/trends-analysis.md
summary Unified view of all categories All files ${CLAUDE_SKILL_DIR}/references/jq-queries.md

Quick Start Example

bash
# Top agents with model breakdown
jq -s 'group_by(.agent) | map({agent: .[0].agent, count: length}) | sort_by(-.count)' ~/.claude/analytics/agent-usage.jsonl

# All-time token costs
jq '.modelUsage | to_entries | map({model: .key, input: .value.inputTokens, output: .value.outputTokens})' ~/.claude/stats-cache.json

Quick Subcommand Guide

agents, models, skills, hooks, teams, summary — Run the jq query from Read("${CLAUDE_SKILL_DIR}/references/jq-queries.md") for the matching subcommand. Present results as a markdown table.

session — Follow the 4-step process in Read("${CLAUDE_SKILL_DIR}/references/session-replay.md"): locate session file, resolve reference (latest/partial/full ID), parse JSONL, present timeline.

cost — Apply model-specific pricing from Read("${CLAUDE_SKILL_DIR}/references/cost-estimation.md") to CC's stats-cache.json. Show per-model breakdown, totals, and cache savings.

trends — Follow the 4-step process in Read("${CLAUDE_SKILL_DIR}/references/trends-analysis.md"): daily activity, model delegation, peak hours, all-time stats.

summary — Run all subcommands and present a unified view: total sessions, top 5 agents, top 5 skills, team activity, unique projects.

Data Files

Load Read("${CLAUDE_SKILL_DIR}/references/data-locations.md") for complete data source documentation.

File Contents
agent-usage.jsonl Agent spawn events with model, duration, success
skill-usage.jsonl Skill invocations
hook-timing.jsonl Hook execution timing and failure rates
session-summary.jsonl Session end summaries
task-usage.jsonl Task completions
team-activity.jsonl Team spawns and idle events

Rules

Each category has individual rule files in rules/ loaded on-demand:

Category Rule Impact Key Pattern
Data Integrity ${CLAUDE_SKILL_DIR}/rules/data-privacy.md CRITICAL Hash project IDs, never log PII, local-only
Cost & Tokens ${CLAUDE_SKILL_DIR}/rules/cost-calculation.md HIGH Separate pricing per token type, cache savings
Performance ${CLAUDE_SKILL_DIR}/rules/large-file-streaming.md HIGH Streaming jq for >50MB, rotation-aware queries
Visualization ${CLAUDE_SKILL_DIR}/rules/visualization-recharts.md HIGH Recharts charts, ResponsiveContainer, tooltips
Visualization ${CLAUDE_SKILL_DIR}/rules/visualization-dashboards.md HIGH Dashboard grids, stat cards, widget registry

Total: 5 rules across 4 categories

References

Reference Contents
${CLAUDE_SKILL_DIR}/references/jq-queries.md Ready-to-run jq queries for all JSONL subcommands
${CLAUDE_SKILL_DIR}/references/session-replay.md Session JSONL parsing, timeline extraction, presentation
${CLAUDE_SKILL_DIR}/references/cost-estimation.md Pricing table, cost formula, daily cost queries
${CLAUDE_SKILL_DIR}/references/trends-analysis.md Daily activity, model delegation, peak hours queries
${CLAUDE_SKILL_DIR}/references/data-locations.md All data sources, file formats, CC session structure

Important Notes

  • All files are JSONL (newline-delimited JSON) format
  • For large files (>50MB), use streaming jq without -s — load Read("${CLAUDE_SKILL_DIR}/rules/large-file-streaming.md")
  • Rotated files: <name>.<YYYY-MM>.jsonl — include for historical queries
  • team field only present during team/swarm sessions
  • pid is a 12-char SHA256 hash — irreversible, for grouping only

Output Format

Present results as clean markdown tables. Include counts, percentages, and averages. If a file doesn't exist, note that no data has been collected yet for that category.

Related Skills

  • ork:explore - Codebase exploration and analysis
  • ork:feedback - Capture user feedback
  • ork:remember - Store project knowledge
  • ork:doctor - Health check diagnostics

Expand your agent's capabilities with these related and highly-rated skills.

yonatangross/orchestkit

expect

Diff-aware AI browser testing — analyzes git changes, generates targeted test plans, and executes them via agent-browser. Reads git diff to determine what changed, maps changes to affected pages via route map, generates a test plan scoped to the diff, and runs it with pass/fail reporting. Use when testing UI changes, verifying PRs before merge, running regression checks on changed components, or validating that recent code changes don't break the user-facing experience.

143 15
Explore
yonatangross/orchestkit

github-operations

GitHub CLI operations for issues, PRs, milestones, and Projects v2. Covers gh commands, REST API patterns, and automation scripts. Use when managing GitHub issues, PRs, milestones, or Projects with gh.

143 15
Explore
yonatangross/orchestkit

chain-patterns

Chain patterns for CC 2.1.71 pipelines — MCP detection, handoff files, checkpoint-resume, worktree agents, CronCreate monitoring. Use when building multi-phase pipeline skills. Loaded via skills: field by pipeline skills (fix-issue, implement, brainstorm, verify). Not user-invocable.

143 15
Explore
yonatangross/orchestkit

storybook-mcp-integration

Storybook MCP server integration for component-aware AI development. Covers 6 tools across 3 toolsets (dev, docs, testing): component discovery via list-all-documentation/get-documentation, story previews via preview-stories, and automated testing via run-story-tests. Use when generating components that should reuse existing Storybook components, running component tests via MCP, or previewing stories in chat.

143 15
Explore
yonatangross/orchestkit

component-search

Search 21st.dev component registry for production-ready React components. Finds components by natural language description, filters by framework and style system, returns ranked results with install instructions. Use when looking for UI components, finding alternatives to existing components, or sourcing design system building blocks.

143 15
Explore
yonatangross/orchestkit

ai-ui-generation

AI-assisted UI generation patterns for json-render, v0, Bolt, and Cursor workflows. Covers prompt engineering for component generation, review checklists for AI-generated code, design token injection, refactoring for design system conformance, and CI gates for quality assurance. Use when generating UI components with AI tools, rendering multi-surface MCP visual output, reviewing AI-generated code, or integrating AI output into design systems.

143 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results