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.