Skip to content
Development
Command

/metrics

Summarise the per-turn records written by the track-metrics hook: activity over time, files changed, and latest commits.

BOOST
From plugin
project-starter
1.4k26 skills7 agents26 commands6 hooks
Install
> /plugin marketplace add CloudAI-X/claude-workflow-v2
> /plugin install project-starter@claude-workflow

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/metrics

Context preview

What this command does when you run it.

Summarise the per-turn records written by the track-metrics hook: activity over time, files changed, and latest commits.

Command definition

metrics.md
allowed-tools: Read, Bash, Glob
description: "Summarise the per-turn records written by the track-metrics hook: activity over time, files changed, and latest commits."

Context

  • Metrics file: !`cat .claude/agent-metrics.jsonl 2>/dev/null || echo "NO_METRICS_FILE"`

Task

Analyze the recorded metrics and present a summary.

**If the metrics file does not exist or the context above shows "NO_METRICS_FILE":** Print exactly: "No metrics recorded yet. Metrics are automatically collected after each turn."

**If metrics data exists**, parse each JSON line and present:

1. **Overview**

  • Total turns logged (the hook writes one record each time Claude finishes responding)
  • Turns in the last 7 days (compare timestamps to now)
  • Average files changed per turn

2. **Recent Turns** (last 10) Format as a markdown table:

| # | Timestamp (UTC) | Files Changed | Commit | | --- | --------------- | ------------- | ------ |

  • Show the most recent 10 turns, newest first
  • For "Commit", show the short commit message or "—" if none

3. **Patterns**

  • Note any trends (e.g., turns with many file changes, frequency of commits)
  • If there are turns with 0 files changed, note how many were "no-op" turns

Keep the output concise and well-formatted.

Ships withproject-starter

A universal Claude Code workflow plugin with specialized agents, skills, hooks, and mode commands for any software project. Compatible with skills.sh — works with Claude Code, Cursor, Codex, and 35+ AI agents.

Get the whole plugin

Other commands on project-starter.