writing-and-editing

Audit drafting, readability, and metadata for user-provided documents.

1|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/matt-riley/agent-skills --skill writing-and-editing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-and-editing
Source: https://github.com/matt-riley/agent-skills/tree/main/skills/writing-and-editing
Command: npx skills add https://github.com/matt-riley/agent-skills --skill writing-and-editing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The skill provides a structured approach to improve drafting, readability, and short metadata strings, reducing time spent polishing prose and metadata.

Core Features & Use Cases

  • Drafting assistance for proposals, runbooks, README rewrites, and documentation restructures.
  • Readability audits for multi-paragraph prose with concrete feedback.
  • Metadata reviews for titles, descriptions, and taglines to improve surface clarity and consistency.

Quick Start

Provide a document and audience, and specify the mode (draft, readability-audit, or metadata-audit) to start.

Frequently Asked Questions about writing-and-editing

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

FAQPage Schema
How do I run a readability audit on multi-paragraph prose for documentation?

To perform a readability audit, provide your document and audience, then specify readability-audit mode to receive concrete, actionable feedback on multi-paragraph prose clarity.

What is the best way to rewrite a README and restructure documentation?

The best way to rewrite a README and restructure documentation is using draft mode, which provides structured drafting assistance for proposals, runbooks, and textual materials to reduce time spent polishing prose.

How do I improve metadata titles, descriptions, and taglines for surface clarity?

To improve metadata titles, descriptions, and taglines, use metadata-audit mode to review and enhance short metadata strings, ensuring surface clarity and consistency across your documents.

Can I use this writing and editing tool for both proposals and runbooks?

Yes, you can use this tool for proposals and runbooks. It applies to proposals, READMEs, runbooks, and other textual materials where writing quality and metadata surface matter, supporting multiple document types.

Does the metadata review process support structured frontmatter in documents?

Yes, the metadata review process satisfies requirements for structured frontmatter, applying metadata audits to titles, descriptions, and taglines while maintaining mode routing and concise guidance outputs.