skills.rest
mikkeymoo
mikkeymooCOMMUNITY
Explore all skills by this author →
GitHub

mm-hud

Generate session and project health metrics from JSONL logs, Git status, and hooks configuration.

1|Updated Apr 6, 2026
Search Tags:#project health#codebase navigation#metrics monitoring#session display#pre-build checks
One-click install
npx skills add https://github.com/mikkeymoo/claude-solo --skill mm-hud
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mm-hud
Source: https://github.com/mikkeymoo/claude-solo/tree/main/mm-skills/mm-hud
Command: npx skills add https://github.com/mikkeymoo/claude-solo --skill mm-hud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive heads-up display for session information and project health metrics, streamlining project oversight and diagnostics.

Core Features & Use Cases

  • Session HUD: Provides a default heads-up display with Git and sprint state, token usage, recent tool distribution, active hooks, and open TODOs.
  • Project Health Check: Offers a project health check to diagnose potential issues.
  • Codebase Map: Generates a map of the codebase for better navigation.
  • Pre-build Gate: Ensures readiness before building by checking project health.
  • Use Case: Before starting a new feature, use the pre-build gate to check the project's current state and ensure all necessary checks are passed.

Quick Start

Run the command /mm-hud to view the session heads-up display.

Frequently Asked Questions about mm-hud

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

FAQPage Schema
How do I check project health metrics before starting a new build?▼

You can check project health metrics by running a pre-build gate that evaluates Git state, token usage, and active hooks to ensure readiness before building. This diagnostic identifies potential issues prior to starting new features.

What is a session heads-up display for codebase navigation?▼

A session heads-up display provides real-time project oversight by aggregating Git state, token usage, tool distribution, active hooks, and open TODOs into a single view for streamlined diagnostics.

Do I need jq and Python installed to generate project health reports?▼

Yes, you need jq and Python installed to generate project health reports. jq handles JSON parsing for JSONL logs, while Python executes the report generation scripts.

How do I generate a codebase map for better project navigation?▼

Generate a codebase map by running the session display command, which analyzes the project structure and outputs a navigational map to improve codebase orientation and project oversight.

Can I monitor token usage and tool distribution from JSONL logs?▼

Yes, you can monitor token usage and tool distribution by parsing JSONL logs with jq. The tool extracts session metrics and formats them into a report using Python for display.

What are the limitations of using JSONL logs for session metrics monitoring?▼

Session metrics monitoring depends entirely on the integrity of JSONL logs, Git status, and hooks configuration. Incomplete or missing logs will result in inaccurate health reports and limited tool distribution visibility.

Related Skills

Explore More Software Engineering Skills→
nuno7lopesnuno7lopes

session-logs

Search and analyze JSONL session logs using jq and ripgrep.

Community
Basic
mhattingpetemhattingpete
657

conversation-analyzer

Analyze Claude Code conversation history to identify usage patterns and automation opportunities.

Community
Advanced
kivo360kivo360
1

moai-session-info

Display MoAI-ADK project configuration, Git status, and session metrics.

Community
Advanced
chiptoe-svgchiptoe-svg

add-dashboard

Add a local monitoring dashboard for NanoClaw deployments.

Community
Intermediate