meta-retrospective

Analyze prompt histories to detect anti-patterns and generate retrospective reports.

6|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/slowman2084/meta-agent --skill meta-retrospective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-retrospective
Source: https://github.com/slowman2084/meta-agent/tree/main/source/skills/meta-retrospective
Command: npx skills add https://github.com/slowman2084/meta-agent --skill meta-retrospective

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iterative prompt engineering often drifts or degrades over multiple rounds of edits, causing tests to fail, rules to conflict, or improvements to vanish. Meta-retrospective automates multi-iteration analysis to pinpoint when and why performance regresses, identify systemic anti-patterns, and produce actionable next directions to break harmful optimization cycles.

Core Features & Use Cases

  • Prompt diff analysis: compare sequential prompt backups (.bak) to enumerate added, removed, and modified sections, CRITICAL markers, and optimization direction tags.
  • Execution metrics extraction: ingest per-iteration evaluation reports and logs to quantify avg/min/max scores, low-scoring cases, tool call patterns, and error rates.
  • Anti-pattern detection & turning points: detect 13 built-in anti-patterns (e.g., symptom-driven fixes, simultaneous multi-variable changes, testset overfitting) and mark first-appearance and collapse points.
  • Deliverables & persistence: generate structured JSON and human-readable Markdown retrospectives, emit forced_new_directions.md for the next engineer loop, append high-value entries to learnings.jsonl, and sync status.json.
  • Use case: run a full retrospective after three or more iteration backups to stop "change-and-degrade" cycles and force a change in optimization direction.

Quick Start

Run a retrospective by giving the current prompt path, a bak directory with at least two .bak backups, and the evaluation reports directory so the skill can produce forced_new_directions.md and structured reports.

Frequently Asked Questions about meta-retrospective

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

FAQPage Schema
How do I detect anti-patterns in my prompt engineering iteration history?

To detect anti-patterns in prompt engineering iteration history, analyze multi-iteration prompt backups and evaluation reports to identify degradation directions and systemic issues like symptom-driven fixes. The skill parses sequential diffs and execution metrics to pinpoint exactly when performance regresses.

Why does my prompt performance degrade after multiple iterations of edits?

Prompt performance degrades over multiple iterations due to drifting rules, conflicting edits, and testset overfitting. Analyzing prompt backups and per-iteration evaluation reports identifies these degradation directions and marks the exact turning points where optimization cycles collapse.

How do I run a retrospective analysis on prompt backups and evaluation logs?

To run a retrospective analysis on prompt backups and evaluation logs, provide the current prompt path, a backup directory with at least two .bak files, and the evaluation reports directory. The analysis outputs structured JSON and Markdown reports detailing added, removed, and modified prompt sections.

Can I quantify execution metrics from per-iteration evaluation reports?

Yes, you can quantify execution metrics from per-iteration evaluation reports by ingesting the reports and optional run logs to extract average, minimum, and maximum scores, low-scoring cases, tool call patterns, and error rates for comprehensive iteration analysis.

What is the minimum number of prompt backups needed for iteration analysis?

The minimum requirement for iteration analysis is at least two prompt backups stored in a .bak directory. Running a full retrospective after three or more iteration backups is recommended to effectively stop change-and-degrade cycles and identify systemic anti-patterns.

How do I stop simultaneous multi-variable changes from breaking my prompt workflow?

To stop simultaneous multi-variable changes from breaking your prompt workflow, use rule-based heuristics to detect this and 12 other built-in anti-patterns in your iteration history. The analysis generates a forced new directions file to break harmful optimization cycles and guide the next engineering loop.