session-metrics

Summarize git changes, turn counts, and token usage for active sessions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mykaarma/claude-sutras --skill session-metrics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-metrics
Source: https://github.com/mykaarma/claude-sutras/tree/main/skills/session-metrics
Command: npx skills add https://github.com/mykaarma/claude-sutras --skill session-metrics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often lose track of what has changed in a session, how much context has been consumed, and the associated cost implications. This skill provides an at-a-glance summary of git changes, turn counts, and efficiency tips, helping teams decide when to compact context or adjust workflow.

Core Features & Use Cases

  • Git Change Overview: Quickly shows modified, added, and untracked files with diff statistics.
  • Context Health Check: Estimates session length, token usage, and recommends compacting long contexts.
  • Cost‑Awareness Tips: Offers actionable advice to reduce token cost based on session activity.
  • Use Case Example: After a coding sprint, a developer asks for a session metrics report to decide whether to commit, clean up, or run a /compact before starting the next task.

Quick Start

Ask the assistant to provide a session metrics report for the current project.

Frequently Asked Questions about session-metrics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check git changes and token usage in my active development session?

You can check git changes and token usage by requesting a session metrics report, which summarizes modified files, estimates token consumption, and provides context health insights without reading large files.

What is a session metrics report and when do I need one for my project?

A session metrics report is a concise summary of git changes, context health, and cost considerations. You need one during active development sprints to track modifications, monitor context length, and decide whether to compact context.

How do I get a summary of modified, added, and untracked files with diff statistics?

To get a summary of modified, added, and untracked files with diff statistics, ask the assistant for a session snapshot. It uses git commands to provide an at-a-glance overview of your current project state.

How do I reduce token cost based on my coding session activity?

To reduce token cost, use the cost-awareness tips provided in the session metrics report. It analyzes your session activity, estimates token usage, and offers actionable advice to improve efficiency and reduce expenses.

Can I estimate session length and token usage without reading large files?

Yes, you can estimate session length and token usage without reading large files. The session metrics skill accesses git commands and conversation memory to estimate tokens and actions efficiently.

When should I compact context during an active development session?

You should compact context when the session metrics report indicates high token usage or a long context length. The report recommends compacting long contexts to maintain efficiency and manage costs during extended coding sprints.