---
name: Edit Document
slug: edit-document
category: Writing
description: Edit Document restructures existing documents for clarity, flow, and tighter prose while preserving intent and accuracy. Use it for specs, READMEs, articles, or technical writing that already exists and needs revision.
github: "https://github.com/danielvm-git/bigpowers/tree/main/skills/edit-document"
language: Shell
stars: 173
forks: 14
install: "npx degit https://github.com/danielvm-git/bigpowers/tree/main/skills/edit-document ~/.claude/skills/edit-document"
installs_to: ~/.claude/skills/edit-document
source_path: skills/edit-document/SKILL.md
collection_size: 23
category_size: 1328
collection_url: "https://dirskills.com/collections/danielvm-git/bigpowers"
added: 2026-09-07T05:22:14.538Z
last_synced: 2026-09-07T05:22:14.538Z
canonical_url: "https://dirskills.com/skills/edit-document"
---

# Edit Document

Edit Document restructures existing documents for clarity, flow, and tighter prose while preserving intent and accuracy. Use it for specs, READMEs, articles, or technical writing that already exists and needs revision.

**Install:**

```bash
npx degit https://github.com/danielvm-git/bigpowers/tree/main/skills/edit-document ~/.claude/skills/edit-document
```

## README

# Edit Document

**Distinct from `write-document`:** Use this skill when the document already exists and needs restructuring, clarity, or prose improvements. Use `write-document` to create a document from scratch.

> **HARD GATE** — Document edits must preserve intent and accuracy. Do NOT remove or contradict existing content without understanding why it was written. Check git history for context.

## Process

1. First, divide the document into sections based on its headings. Think about the main points made in each section.

Consider that information is a directed acyclic graph, and that pieces of information can depend on other pieces of information. Make sure that the order of the sections and their contents respects these dependencies.

Confirm the sections with the user.

2. For each section:

2a. Rewrite the section to improve clarity, coherence, and flow. Use maximum 240 characters per paragraph.