editing
Skill1 starsChanged 7 months agoMITView on GitHub
Edit and proofread text for grammar, clarity, structure, tone, and readability. Trigger with "edit this", "proofread", "review my writing", "improve this draft", "fix the grammar", "make this clearer", or when the user provides text that needs refinement, restructuring, or polishing.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- Melvynx/video-agent-skillstheir own version, first seen Oct 15, 2026
- nimadorostkar/Claude-Skills-collectiontheir own version, first seen Oct 13, 2026
- Dimks777/aiclubtheir own version, first seen Apr 3, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- Melvynx/video-agent-skills★ 126same name
- nimadorostkar/Claude-Skills-collection★ 33same name
- Dimks777/aiclub★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository164 other files it gives its agents.
- instrument-data-to-allotropeSkill
- literature-reviewSkill
- nextflow-developmentSkill
- scientific-problem-selectionSkill
- scvi-toolsSkill
- single-cell-rna-qcSkill
- discover-brandSkill
- enforce-voiceSkill
- generate-guidelinesSkill
- csat-reportSkill
- customer-escalationSkill
- customer-researchSkill
- draft-responseSkill
- kb-articleSkill
- sentiment-analysisSkill
- ticket-triageSkill
- analyzeSkill
- build-dashboardSkill
- create-vizSkill
- data-context-extractorSkill
- data-modelingSkill
- data-pipelineSkill
- etl-designSkill
- explore-dataSkill
- sql-queriesSkill
- statistical-analysisSkill
- validate-dataSkill
- write-querySkill
- accessibility-reviewSkill
- component-librarySkill
- design-critiqueSkill
- design-handoffSkill
- design-systemSkill
- frontend-designSkill
- research-synthesisSkill
- user-researchSkill
- ux-copySkill
- wireframingSkill
- Agent DevelopmentSkill
- CLAUDE.md ManagementSkill
- MCP Server BuilderSkill
- Plugin DevelopmentSkill
- Prompt EngineeringSkill
- Skill CreatorSkill
- curriculum-designSkill
- lesson-planningSkill
- quiz-generatorSkill
- study-guideSkill
- tutoringSkill
- api-designSkill
- architectureSkill
- ci-cd-pipelineSkill
- code-reviewSkill
- database-migrationSkill
- debugSkill
- dependency-auditSkill
- deploy-checklistSkill
- documentationSkill
- error-handlingSkill
- git-workflowSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 10 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 33
Before editing, understand the context:
- Distinctive: line 37
Ask about any style guide requirements (AP, Chicago, APA, brand guidelines).
- Distinctive: line 39
Read the full text once without editing to understand the overall argument and structure.
- Distinctive: line 60
Remove filler phrases ("it is important to note that" becomes nothing).
- Distinctive: line 61
Ensure parallel structure in lists and series.
- Distinctive: line 76
Verify the tone matches the intended audience and purpose:
- Distinctive: line 133
Never introduce errors: if unsure about a change, flag it as a suggestion rather than applying it.
- Distinctive: line 134
When cutting content, save the deleted material in a "cut bank" in case the author wants it back.
- Distinctive: line 136
If the text has fundamental issues (unclear purpose, wrong audience, missing argument), flag these before line-editing — polishing a …
- Distinctive: line 137
Ask before changing meaning: an edit that alters the author's claim requires confirmation.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Editing and Proofreading
Edit text systematically across multiple dimensions: grammar and mechanics, clarity and conciseness, structure and flow, tone and voice, and readability. Deliver tracked changes with explanations.
Workflow
Step 1: Assess the Text
Before editing, understand the context:
- Identify the document type (email, report, blog post, academic paper, marketing copy).
- Determine the intended audience and appropriate register.
- Ask about any style guide requirements (AP, Chicago, APA, brand guidelines).
- Identify the editing focus: does the user want a light proofread or a substantive edit?
- Read the full text once without editing to understand the overall argument and structure.
Step 2: Structural Edit
Evaluate and improve organization (skip if focus is grammar-only):
- Does the opening clearly state the purpose or thesis?
- Is information presented in a logical sequence?
- Are there sections that should be reordered, combined, or split?
- Are transitions between paragraphs and sections smooth?
- Does the conclusion deliver on the promise of the introduction?
- Flag any missing information or logical gaps.
Step 3: Line Edit
Improve clarity, conciseness, and flow sentence by sentence:
- Replace vague language with specific, concrete terms.
- Eliminate redundancies ("completely finished" becomes "finished").
- Convert passive voice to active where it strengthens the sentence.
- Break sentences longer than 30 words into shorter ones.
- Remove filler phrases ("it is important to note that" becomes nothing).
- Ensure parallel structure in lists and series.
- Vary sentence length and structure to maintain rhythm.
Step 4: Copy Edit
Fix mechanical errors:
- Grammar: Subject-verb agreement, pronoun reference, tense consistency, dangling modifiers.
- Punctuation: Comma splices, semicolon usage, apostrophes, quotation marks.
- Spelling: Typos, commonly confused words (affect/effect, its/it's, their/they're).
- Consistency: Number formatting, capitalization, hyphenation, abbreviation usage.
- Style compliance: Apply the specified style guide rules.
Step 5: Tone Check
Verify the tone matches the intended audience and purpose:
- Is the register appropriate (formal, conversational, technical, persuasive)?
- Are there jarring shifts in tone between sections?
- Does the voice feel consistent throughout?
- Is the language inclusive and free of unintended bias?
- For persuasive text: are claims supported and hedged appropriately?
Step 6: Deliver Results
Present the edit in a clear, actionable format.
Output Format
## Edit Summary
**Document type**: [Type]
**Edit level**: Proofread | Line edit | Substantive edit
**Key changes**: [3-5 bullet summary of most significant improvements]
**Readability**: [Before/after Flesch-Kincaid estimate]
---
## Edited Text
[Full edited text with changes applied]
---
## Change Log
| # | Location | Original | Revised | Reason |
|---|----------|----------|---------|--------|
| 1 | Para 1, line 2 | [original phrase] | [revised phrase] | [why] |
| 2 | ... | ... | ... | ... |
## Structural Notes
- [Any high-level feedback on organization, argument, or missing content]Examples
User: "Proofread this email before I send it to the VP" Action: Focus on grammar, tone (professional and respectful), and conciseness. Fix errors without changing the author's voice. Note any unclear requests or missing context.
User: "This report is too long and unclear — help me tighten it up" Action: Perform a structural edit (reorder for clarity), then a line edit (cut word count by 20-30%), deliver a change log explaining major cuts and restructures.
User: "Make this blog post more conversational" Action: Focus on tone: replace formal constructions with direct address, add rhetorical questions, shorten sentences, and use contractions. Preserve the original argument and structure.
Best Practices
- Preserve the author's voice — edit to clarify their intent, not to rewrite in your style.
- Explain the reasoning behind significant changes so the author learns.
- For light proofreads, fix errors silently; for substantive edits, flag and explain.
- Never introduce errors: if unsure about a change, flag it as a suggestion rather than applying it.
- When cutting content, save the deleted material in a "cut bank" in case the author wants it back.
- Present the most impactful changes first in the change log.
- If the text has fundamental issues (unclear purpose, wrong audience, missing argument), flag these before line-editing — polishing a structurally broken text wastes effort.
- Ask before changing meaning: an edit that alters the author's claim requires confirmation.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

