reflect-on-agent-sessions

Analyze autosearch-indexed agent sessions and generate markdown reports of recurring workflow problems.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/mistakenot/auto-stack --skill reflect-on-agent-sessions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect-on-agent-sessions
Source: https://github.com/mistakenot/auto-stack/tree/main/.agents/skills/reflect-on-agent-sessions
Command: npx skills add https://github.com/mistakenot/auto-stack --skill reflect-on-agent-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and report recurring issues in coding agent sessions to improve automation reliability and workflow efficiency.

Core Features & Use Cases

  • Analyze autosearch-indexed sessions to surface patterns and recurring problems.
  • Generate a machine-readable and human-friendly markdown report with evidence and reasoning.
  • Produce one report per issue topic, including times seen and representative incidents.

Quick Start

Refresh the autosearch index and generate a markdown report of recurring issues with evidence.

Frequently Asked Questions about reflect-on-agent-sessions

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

FAQPage Schema
How do I identify recurring issues in agent sessions using indexed data?

To identify recurring issues in agent sessions, this Skill systematically analyzes autosearch-indexed session data to surface workflow problems and generates a structured markdown report with evidence and reasoning. It produces one report per issue family.

What is the best way to report automation reliability problems found in coding agent workflows?

The best way to report automation reliability problems is to analyze autosearch-indexed sessions to surface recurring workflow patterns. This Skill generates a human-friendly markdown report containing evidence, reasoning, and representative incidents.

Do I need autosearch to analyze agent session messages for patterns?

Yes, you need autosearch and access to session/message data to analyze agent sessions. The Skill refreshes the autosearch index across a specified analysis window to accurately identify recurring workflow problems and generate evidence-based reports.

How does this analysis generate evidence for recurring workflow problems?

The analysis generates evidence by scanning autosearch-indexed sessions within a defined window, counting times seen, and extracting representative incidents. It outputs a machine-readable markdown report detailing each issue family with structured reasoning.

Can I produce multiple issue reports from a single analysis of agent sessions?

Yes, you can produce multiple issue reports from a single analysis. The Skill operates across an analysis window and generates one distinct markdown report per identified issue family, ensuring each recurring problem is documented separately with evidence.

What format does the session analysis report use for documenting agent incidents?

The session analysis report uses a structured markdown format for documenting agent incidents. This machine-readable and human-friendly output includes evidence, reasoning, and the frequency of recurring workflow problems to improve automation reliability.