fresh-eyes

Review and patch plan documents with minimal edits and validation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mattjefferson/agents --skill fresh-eyes-mattjefferson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fresh-eyes
Source: https://github.com/mattjefferson/agents/tree/main/skills/fresh-eyes
Command: npx skills add https://github.com/mattjefferson/agents --skill fresh-eyes-mattjefferson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

Review plan documents with an independent critical pass, then patch them in place with minimal high-value edits.

Core Features & Use Cases

  • Independent, multi-lens review against project constraints and planning standards
  • Patch-in-place edits with minimal diffs to preserve original intent
  • Structured validation and change summary using the references in references/review-lenses.md

Quick Start

Provide a plan document path or allow the tool to locate the most recent plan under docs/plans.

Frequently Asked Questions about fresh-eyes

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

FAQPage Schema
How do I review and patch plan documents with minimal edits?

Review and patch plan documents by running an independent critical pass that enforces multi-lens checks, then applies minimal high-value in-place edits to preserve the original intent. It provides a structured validation pass and change summary.

What is a multi-lens quality gate for plan review?

A multi-lens quality gate evaluates plan documents against project constraints and planning standards defined in review-lenses references. It surfaces issues with severity levels and patches documents in place to ensure plan quality before execution.

How do I find recent plans under docs/plans for validation?

Provide a specific plan document path for validation, or allow the tool to automatically locate the most recent plan under docs/plans. It also checks docs/brainstorms or the current directory when standard plan folders are absent.

Can I patch brainstorm documents in place or does it only work for formal plans?

Patch in place works for both formal plans and brainstorm documents. The scope includes files located under docs/plans, docs/brainstorms, or the current directory when none of these standard plan folders are present.

Does the plan review process preserve original document intent?

The plan review process preserves original document intent by applying minimal diffs during the patch-in-place edits. It enforces checks from review-lenses references and only makes high-value edits to fix surfaced issues without rewriting the document.