review-mistakes

Review pending MISTAKE-*.md and SKELETON-*.md reports with Accept, Reject, Discard, Enrich, or Skip options.

8|1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/orban/intent-layer --skill review-mistakes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-mistakes
Source: https://github.com/orban/intent-layer/tree/main/skills/review-mistakes
Command: npx skills add https://github.com/orban/intent-layer --skill review-mistakes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactive review of pending mistake reports from the Intent Layer learning loop. Walk through each report with the user, accepting/rejecting/discarding as appropriate.

Core Features & Use Cases

  • Review pending mistake reports (SKELETON-.md and MISTAKE-.md).
  • Summarize each report and present decision options (Accept, Reject, Discard, Enrich, Skip).
  • Integrate accepted mistakes by appending entries to AGENTS.md and organizing reports into integrated, rejected, or discarded.

Quick Start

Start the review session by listing pending reports in your project: find "${CLAUDE_PROJECT_DIR:-.}/.intent-layer/mistakes/pending"
( -name "MISTAKE-.md" -o -name "SKELETON-.md" )
-type f 2>/dev/null | sort

Frequently Asked Questions about review-mistakes

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

FAQPage Schema
How do I review pending AI mistake reports in an intent layer workflow?

Review pending AI mistake reports by interactively triaging SKELETON-*.md and MISTAKE-*.md files. The workflow summarizes each report and guides you through Accept, Reject, Discard, Enrich, or Skip decisions to harden AI workflows.

What happens to AGENTS.md when I accept a mistake report?

Accepted mistake reports are integrated by appending corresponding entries to AGENTS.md. The reviewed report files are then organized into dedicated integrated, rejected, or discarded directories to maintain a clear audit trail.

How do I find pending MISTAKE and SKELETON markdown files for triage?

Find pending MISTAKE and SKELETON markdown files by searching the project's .intent-layer/mistakes/pending directory. The review session automatically lists these files to begin the interactive triage process.

Can I enrich a mistake report instead of accepting or rejecting it?

You can enrich a mistake report during the interactive triage process. Enrich is one of the five available decision options alongside Accept, Reject, Discard, and Skip, allowing you to add context before finalizing the report's status.

Does the intent layer mistake review process require external dependencies?

The intent layer mistake review process requires no external dependencies. It operates entirely within your project environment to automate the triage and integration of mistake reports into your operational workflow.

Why do I need to triage SKELETON markdown files in my AI workflow?

Triage SKELETON markdown files to identify and integrate structural learning loop insights into AGENTS.md. This continuous review prevents recurring AI workflow pitfalls by maintaining an updated operational audit trail.