review-log

Analyze run narratives for coherence, stuck hypotheses, and overfitting signals.

3|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/qualit527/qec-ai-decoder --skill review-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-log
Source: https://github.com/qualit527/qec-ai-decoder/tree/main/.claude/skills/review-log
Command: npx skills add https://github.com/qualit527/qec-ai-decoder --skill review-log

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and evaluate runs/<id>/log.md to detect narrative coherence issues, identify stuck hypotheses, and surface signs of overfitting, then generate a formal review.

Core Features & Use Cases

  • Structured review generation: reads log.md and writes runs/<id>/review.md.
  • Stuck-hypothesis detection: highlights hypotheses that recur across rounds.
  • Overfitting signals: flags improvements on training metrics that do not transfer to holdout data.
  • Actionable guidance: provides top insights and recommended next steps for researchers.

Quick Start

Run python -m cli.autoqec review-log <run_dir> to generate a structured review and save it to runs/<id>/review.md.

Frequently Asked Questions about review-log

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

FAQPage Schema
How do I identify stuck hypotheses from experiment run logs?

To identify stuck hypotheses from run logs, you can analyze runs/<id>/log.md to detect recurring hypotheses across rounds, evaluate narrative coherence, and flag overfitting signals. This structured review process highlights hypotheses that fail to progress across experiment iterations.

What is overfitting signal detection in research run tracking?

Overfitting signal detection in run tracking flags improvements on training metrics that fail to transfer to holdout data. By analyzing run narratives in log.md, it surfaces these discrepancies to help researchers avoid models that memorize training data without generalizing.

How do I generate a structured review from a markdown experiment log?

To generate a structured review from a markdown experiment log, run the review-log command on your run directory. It reads runs/<id>/log.md, extracts coherence and overfitting signals, and writes actionable feedback with recommended next steps to runs/<id>/review.md.

When should I run a log review for experiment evaluation?

You should run a log review for experiment evaluation after long experiments spanning 10 or more rounds. Applying the review process at this stage ensures enough data exists to accurately detect narrative incoherence, stuck hypotheses, and overfitting signals from the run logs.

Does the review-log workflow require external dependencies to parse run logs?

The review-log workflow does not require external dependencies to parse run logs. It operates independently to read runs/<id>/log.md, extract evaluation metrics, and write structured feedback to review.md without needing additional components or packages installed.