agent-instructions
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when editing prose for clarity and force. Covers cutting, structural editing, the specific constructions that weaken writing, and editing someone else's work without destroying their voice.
$ npx -y skills add nimadorostkar/Claude-Skills-collection --skill editing --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/editingContext preview
The summary Claude sees to decide when to auto-load this skill.
Use when editing prose for clarity and force. Covers cutting, structural editing, the specific constructions that weaken writing, and editing someone else's work without destroying their voice.
name: editing description: Use when editing prose for clarity and force. Covers cutting, structural editing, the specific constructions that weaken writing, and editing someone else's work without destroying their voice. metadata: category: writing version: 1.0.0 tags: [editing, clarity, concision, prose, revision]
Make writing shorter and stronger without making it yours. Most editing is cutting; most weak prose is not badly constructed but merely padded.
1. **Structure before sentences** — There is no point polishing a paragraph you are about to cut. Read for the argument first: does each section earn its place, and are they in the right order? 2. **Cut the throat-clearing** — Most drafts genuinely begin in the second or third paragraph. Find where the piece actually starts and delete everything above it. 3. **Then edit the lines** — Cut hedges, filter phrases, and nominalizations. Prefer the active voice unless the passive is doing real work. 4. **Read it aloud** — Every sentence you stumble over is a sentence that needs rewriting. This is the single most reliable line-editing tool there is. 5. **When editing someone else's work, separate suggestion from correction** — A grammatical error is a correction. A different word choice is a suggestion, and it is theirs to decline.
**A line edit, showing the specific constructions:**
BEFORE (61 words):
It is important to note that there is a growing body of evidence which
suggests that the implementation of comprehensive code review processes
may potentially lead to a reduction in the number of defects that are
introduced into production systems, although it should be acknowledged
that the effectiveness of such processes can vary considerably depending
on a number of different factors.
AFTER (24 words):
Code review reduces production defects — though how much depends heavily
on how it is done. Reviews that rubber-stamp large diffs catch almost nothing.
What was cut, and why:
"It is important to note that" filter phrase — delete, never replace
"there is a growing body of evidence
which suggests that" filter phrase — say the thing
"the implementation of ... processes" nominalization — "code review"
"may potentially" double hedge — one of these, at most
"lead to a reduction in the number of" nominalization — "reduces"
"that are introduced into" passive padding
"although it should be acknowledged
that" filter phrase
"can vary considerably depending on a
number of different factors" says nothing — replaced with a
specific, useful claimThe second version is not merely shorter. It is more informative, because the space freed by cutting the padding was spent on an actual claim.
**Editing someone else's work — the distinction that matters:**
## Structural - Sections 3 and 4 argue the same point with different examples. Merge them; the piece loses nothing and gains 400 words of pace. - The strongest argument is in section 5. It should be section 2 — the reader currently has to earn it. ## Corrections (these are errors) - "the data shows" — "data" takes a plural verb in this publication's style guide. - Para 6: the 40% figure contradicts the 34% in the chart. One of them is wrong. ## Suggestions (yours to take or leave) - "utilise" -> "use" throughout. Not wrong; just heavier than your usual register. - The opening quote is doing less work than the sentence after it. Consider cutting it — but it is your voice, and if you like it, keep it.
A curated library of 137 production-grade skills for Claude and other AI coding agents. Every skill follows one structure, speaks with one voice, and earns its place by changing what the agent does.
Repo: nimadorostkar/Claude-Skills-collection
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what does not, structure, and…
Use when an agent needs state that survives a session or a context compaction. Covers what to persist, file-based memory, structuring notes for retrieval, and…
Use when automating agent behavior with lifecycle hooks. Covers hook events, deterministic enforcement of rules the model should not be trusted to remember,…
Use when packaging skills, commands, hooks, and MCP servers into a distributable plugin. Covers manifest structure, bundling, versioning, testing, and…
Use when writing a new skill for an AI agent. Covers scoping, description writing for reliable triggering, progressive disclosure, and the difference between a…
Use when reviewing or improving an existing agent skill. Covers triggering accuracy, content quality, redundancy with the base model, and measuring whether the…