toolkit-health

Analyze MTK toolkit usage from analytics.json and on-disk artifacts to surface health anomalies.

6|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/moberghr/mtk-agent-toolkit --skill toolkit-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toolkit-health
Source: https://github.com/moberghr/mtk-agent-toolkit/tree/main/.claude/skills/toolkit-health
Command: npx skills add https://github.com/moberghr/mtk-agent-toolkit --skill toolkit-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when the engineer asks for toolkit usage stats, adoption signals, or wants to diagnose whether MTK is being used as intended — reads analytics.json and surfaces anomalies with suggested actions.

Core Features & Use Cases

  • Reads .claude/analytics.json and on-disk artifacts (specs, lessons, commits) to surface actionable health signals.
  • Supports periodic adoption reviews and pre-promotion sanity checks by surfacing gaps and anomalies.
  • Provides read-only reporting with suggested actions for improvement.

Quick Start

Request a health report on MTK usage by analyzing analytics.json and related docs.

Frequently Asked Questions about toolkit-health

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

FAQPage Schema
How do I check MTK adoption metrics from analytics.json?

You can diagnose MTK adoption by having the skill load analytics.json and on-disk artifacts, which surfaces health anomalies and usage gaps through read-only reporting.

What is the best way to run a readiness check before promoting CLAUDE.md?

Run a pre-promotion sanity check by analyzing analytics.json and related docs to surface adoption gaps and anomalies, ensuring readiness before promoting CLAUDE.md.

Does the toolkit health audit modify analytics or task files?

No, the health audit enforces read-only reporting of metrics and flags, ensuring it never modifies analytics.json, tasks, or documentation during its analysis.

Can I use this to diagnose whether MTK is being used as intended?

Yes, you can diagnose whether MTK is being used as intended by loading analytics.json and on-disk artifacts to surface health anomalies and suggest actions for improvement.

How do I get a periodic health report across specs, lessons, and commits?

Request a health report by having the skill analyze analytics.json and related docs, which surfaces health anomalies and flags across specs, lessons, and commits.

Why does my health audit return read-only flags instead of fixing issues?

The health audit returns read-only flags because it enforces reporting without modifying analytics, tasks, or docs, providing suggested actions for you to implement manually.