# File Edit In Place

Use when the user names a local file and explicitly asks to clean, rewrite, humanize...

- Repository: https://github.com/conorbronsdon/avoid-ai-writing (5364 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add conorbronsdon/avoid-ai-writing --skill file-edit-in-place -g -a claude-code -y`
Codex: `npx skills add conorbronsdon/avoid-ai-writing --skill file-edit-in-place -g -a codex -y`
Cursor: `npx skills add conorbronsdon/avoid-ai-writing --skill file-edit-in-place -g -a cursor -y`
Gemini CLI: `npx skills add conorbronsdon/avoid-ai-writing --skill file-edit-in-place -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add conorbronsdon/avoid-ai-writing`

## Description

Use when the user names a local file and explicitly asks to clean, rewrite, humanize, or remove AI-writing patterns in that file itself, with minimal targeted edits and post-edit verification.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# File Edit In Place

Edit a named file according to the original `../avoid-ai-writing/SKILL.md` edit mode and editing contract.

For cross-Skill work, follow `../avoid-ai-writing-router/references/handoff-contract.md` and `../avoid-ai-writing-router/references/skill-graph.json`.

## Connection contract

### Incoming

Accept mutation work from:

- `avoid-ai-writing-router` via `ROUTE` when a named file and explicit mutation request are present.
- `ai-writing-detector` via `FEED` only when the user requested a named-file fix after an audit.
- `preservation-verifier` via bounded `REPAIR` when the named file failed a preservation check.

A detector result never authorizes a write by itself. User mutation intent must already be explicit.

### Required handoff state

Before mutation, preserve:

- source file reference,
- relevant original content or before snapshot,
- requested scope,
- explicit factual corrections supplied by the user,
- canonical context profile, detector context mode, and voice constraints,
- protected semantic constraints,
- detector evidence when already available,
- representation-sensitive guard state when applicable.

Set `execution_evidence.mutation: executed` only after a real host write/patch succeeds.

### Outgoing

- `VERIFY` to `preservation-verifier` after a successful edit when before/after material is available.
- Return to the router if the user changes from named-file mutation to returned-text rewriting.
- Return to the router for consequential authorship interpretation rather than answering it locally.

## Senior-developer implementation lens

Apply the `agency-senior-developer` lens encoded in `../avoid-ai-writing-router/references/agency-role-lenses.md`:

- read before writing,
- use the narrowest available edit or patch mechanism,
- retain a before snapshot for verification,
- propagate write failures instead of reporting success,
- re-read the changed region,
- keep mutation and verification evidence distinct.

The rest: https://github.com/conorbronsdon/avoid-ai-writing/blob/HEAD/skills/file-edit-in-place/SKILL.md