clarity-revision

Align grammatical subjects with main characters and convert nominalizations into active verbs.

6|Updated Jan 14, 2026

Search Tags:#writing #editing #communication #grammar #clarity #prose

Ready to run

npx skills add https://github.com/markacianfrani/armor --skill clarity-revision

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: clarity-revision
Source: https://github.com/markacianfrani/armor/tree/main/skills/clarity-revision
Command: npx skills add https://github.com/markacianfrani/armor --skill clarity-revision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the common issue of dense, abstract, or confusing writing by restructuring sentences to prioritize clear subjects and active verbs.

Core Features & Use Cases

Subject-Verb Alignment: Automatically identifies and corrects sentences where the main character is buried or the action is hidden in abstract nouns.
Nominalization Reduction: Converts abstract nouns back into active verbs to improve readability and flow.
Use Case: Use this to polish technical documentation, emails, or reports that feel overly formal or difficult for the reader to parse quickly.

Quick Start

Ask the clarity-revision skill to analyze and rewrite the provided text to improve its grammatical flow and clarity.

Frequently Asked Questions about clarity-revision

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

FAQPage Schema

How do I fix dense, abstract writing in technical documentation?▼

To fix dense technical documentation, the Skill restructures sentences by aligning grammatical subjects with main characters and converting nominalized actions into active verbs to improve reader comprehension.

What is nominalization reduction and how does it improve prose clarity?▼

Nominalization reduction is the process of converting abstract nouns back into active verbs. This improves prose clarity by making sentences less formal and easier for readers to parse quickly.

How do I revise professional reports to prioritize clear subjects and active verbs?▼

You can revise professional reports by applying a three-step diagnostic process that identifies abstract subjects and hidden verbs, automatically rewriting the text to preserve original meaning while improving grammatical flow.

Does this prose editing approach work for polishing formal emails?▼

Yes, this prose editing approach works for formal emails by targeting overly formal or difficult text, restructuring the sentences to reduce abstract nouns, and improving overall readability and impact.

What is the best way to align grammatical subjects with main characters in complex reports?▼

The best way to align grammatical subjects with main characters in complex reports is using an automated diagnostic process that detects buried subjects and rewrites the sentence structure to maximize clarity.