skills.rest
markacianfrani
markacianfraniCOMMUNITY
Explore all skills by this author →
Website𝕏@markacianfraniGitHub

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
One-click install
npx skills add https://github.com/markacianfrani/armor --skill clarity-revision
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
pasunbonelevepasunboneleve
10

oiticica-vigor

Revise English prose to enforce active, concrete wording and pass/fail vigor checks.

Community
Intermediate
EdgeAppEdgeApp
1

no-slop

Enforce stylistic guidelines to eliminate AI-generated writing patterns in technical prose.

Official
Intermediate
faizalhaini958faizalhaini958

proofreader-academic

Analyze academic text for grammar, style, consistency, and tone errors.

Community
Intermediate
bradoctechbradoctech
1

docs-review

Review documentation changes for compliance with the Metabase writing style guide.

Official
Intermediate