editing

Edit technical writing for clarity, conciseness, and active voice.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Objective-Arts/lens-dist --skill editing-objective-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: editing
Source: https://github.com/Objective-Arts/lens-dist/tree/main/canon/editing
Command: npx skills add https://github.com/Objective-Arts/lens-dist --skill editing-objective-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users improve their writing by applying Stephen King's practical advice to technical documentation and code, focusing on clarity, conciseness, and honesty.

Core Features & Use Cases

  • Eliminate Jargon and Pretentiousness: Replaces overly complex vocabulary with plain language.
  • Active Voice and Strong Verbs: Encourages direct and impactful writing by avoiding passive voice and weak adverbs.
  • Conciseness: Implements the "kill your darlings" principle, cutting unnecessary words and phrases.
  • Use Case: Refine a lengthy technical explanation into a clear, actionable summary for a commit message or a README file.

Quick Start

Apply the editing skill to refine the provided text for clarity and conciseness.

Frequently Asked Questions about editing

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

FAQPage Schema
How do I improve technical writing clarity and conciseness?

To improve technical writing clarity, eliminate jargon, passive voice, and unnecessary adverbs. Apply active voice, simple vocabulary, and direct phrasing to enhance readability in documentation and commit messages.

What is the best way to refine lengthy technical explanations into clear summaries?

The best way to refine lengthy technical explanations is by killing self-indulgent phrasing, cutting unnecessary words, and replacing complex vocabulary with plain language to produce actionable summaries.

How do I eliminate passive voice and jargon from my documentation?

Eliminate passive voice and jargon from documentation by using strong verbs and active voice. Replace overly complex vocabulary with plain language to ensure direct and impactful technical writing.

Does this editing approach work for code comments and commit messages?

Yes, this editing approach works for code comments and commit messages. It focuses on removing jargon and weak adverbs to improve readability, ensuring concise and clear technical communication.

When should I use concise editing principles for technical content?

Use concise editing principles for technical content when you need to transform verbose explanations into actionable summaries. This ensures documentation, commit messages, and README files remain direct and readable.