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.