agent-insights
Installation
SKILL.md
Agent Insights
Contract
Generate a self-contained private HTML report from local development-agent metadata while keeping raw conversations out of the report and out of durable knowledge stores.
The report:
- analyzes a rolling window of locally available Claude, Codex, Gemini, Kimi, claude-mem, and Hermes activity;
- separates likely user-authored prompts from common forge, subagent, imported-session, command-wrapper, and system templates;
- reports project concentration, work modes, correction signals, friction signals, requested completion signals, and candidate workflow rules;
- writes only aggregate HTML and JSON under
~/.hermes/cache/agent-insights/by default; - complements token and cost telemetry rather than rebuilding it;
- labels heuristic evidence honestly and never treats generated summaries as verified outcomes.
A successful run is not merely an HTML file. The collector must complete, the report validator must pass, the generated JSON must contain no prompt bodies, and the operator must explain the main evidence limitations.