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.