revise-docs-fresh-eyes

Revises existing documentation through an isolated subagent that never receives the authoring conversation.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mtk177a/skills --skill revise-docs-fresh-eyes-mtk177a
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: revise-docs-fresh-eyes
Source: https://github.com/mtk177a/skills/tree/main/skills/revise-docs-fresh-eyes
Command: npx skills add https://github.com/mtk177a/skills --skill revise-docs-fresh-eyes-mtk177a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documents revised in the same conversation that produced them inherit the author's biases, attachments, and blind spots. This Skill structurally separates revision from authoring by delegating the cold read and rewrite to a fresh subagent that receives none of the parent conversation's diagnosis, preferences, or rationale. ## Core Features & Use Cases - Isolated subagent revision: Spawns a distinct child execution (Codex with fork_turns="none", or a fresh Claude Code Agent subagent) that cold-reads and revises the artifact without inheriting authoring turns. - Minimal delegation payload: Passes only the target artifact, the user's latest request, explicit preservation constraints, and the authorized output mode, excluding parent diagnosis and preferred conclusions. - Fail-closed behavior: When subagents are prohibited or unavailable, it reports Fresh revision: not executed. instead of falling back to same-context editing. - Use Case: After drafting a deployment guide in a long conversation, ask for a fresh-eyes revision; a separate subagent rewrites the guide for on-call engineers while preserving stated facts, uncertainty, and compatibility constraints. ## Quick Start Use revise-docs-fresh-eyes to have a fresh subagent cold-read docs/deployment.md and revise it for on-call engineers, editing only that file.

Frequently Asked Questions about revise-docs-fresh-eyes

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

FAQPage Schema
How do I get an unbiased revision of a document I wrote with an AI assistant?▼

Request a fresh-eyes or cold-pass revision so a separate subagent cold-reads the artifact without receiving the authoring conversation. The child completes both review and revision, and the parent only verifies scope, authority, and preservation constraints mechanically.

What is the difference between fresh-eyes revision and ordinary editing?▼

Ordinary editing happens in the same context that wrote the text, inheriting the author's preferences and blind spots. Fresh-eyes revision delegates to a distinct subagent that receives only the artifact and the user's latest request, never the parent's diagnosis or desired conclusions.

Which AI clients support subagent-based document revision?▼

This Skill targets Codex CLI and Claude Code. Codex starts a new agent thread with fork_turns="none" so authoring turns are not forked, while Claude Code uses a normal fresh Agent subagent rather than resuming the parent conversation.

What happens if subagents are prohibited or unavailable?▼

The workflow fails closed: it reports "Fresh revision: not executed." along with the unavailable or prohibited capability, and stops. It never falls back to revising the document in the parent context.

When should I not use fresh-eyes document revision?▼

Do not use it for ordinary trimming or proofreading, first-draft generation, factual verification of claims, or general diff review of changes. Those tasks belong to same-context editing, research, or diff-review workflows respectively.

Can the fresh subagent add missing operational details to a procedure?▼

Only when the missing context is directly necessary to understand or perform something already in the artifact or request. It must identify missing values without fabricating commands, systems, approvals, or rollback steps, and must not expand short procedures into speculative templates.