write

Improve sentence-level prose in drafts and revisions for technical writing.

Updated Nov 26, 2025
One-click install
npx skills add https://github.com/Aias/dotfiles --skill write-aias
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write
Source: https://github.com/Aias/dotfiles/tree/main/agents/skills/write
Command: npx skills add https://github.com/Aias/dotfiles --skill write-aias

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Drafting and revising prose can be tedious and error-prone; this skill provides sentence-level craft guidance to improve clarity, concision, and impact across writing tasks like PR descriptions, docs, READMEs, and commit messages.

Core Features & Use Cases

  • Sentence-level prose craft anchored in canonical sources and working writers.
  • Guidance for writing new prose and editing existing prose, including trimming fillers, avoiding clichés, and sharpening logic.
  • Use Case: Draft a PR description or README update and revise for clarity and brevity.

Quick Start

Draft a clear README update describing a new feature and its rationale.

Frequently Asked Questions about write

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

FAQPage Schema
How do I improve prose clarity and concision in a README or PR description?

Improve prose clarity by applying sentence-level craft guidance that trims fillers, avoids clichés, and sharpens logic. Use this skill to revise drafts like README updates and PR descriptions for clearer, more effective communications.

What is the best way to revise commit messages for brevity and impact?

Revising commit messages for brevity and impact involves applying process-based guidance from canonical style sources. This skill structures edits to enforce crisp, persuasive sentences in your commit messages and documentation drafts.

Can I use this to edit existing documentation drafts, or is it only for writing new prose?

Yes, you can edit existing documentation drafts. This skill provides explicit guidance for both writing new prose and revising existing text, systematically trimming fillers and sharpening logical flow across your docs and agent rules.

Does this prose polishing skill enforce specific style guides during revision?

Yes, prose polishing enforces guidance from canonical sources listed in its references directory. It relies on process-based style guidance to structure edits, ensuring revisions align with established writing principles for clarity and concision.

When do I need sentence-level editing for technical communications?

You need sentence-level editing when technical communications like docs or PR descriptions lack clarity or persuasive impact. This skill provides targeted prose craft to trim fillers, avoid clichés, and sharpen logic across your drafts.

What limitations should I expect when polishing prose with this editing approach?

The main limitation is that this approach focuses strictly on sentence-level prose craft rather than overall document structuring. It enforces canonical style guidance for clarity and concision within individual sentences, paragraphs, and commit messages.