check-clarity

Review prose and documentation for clarity, audience fit, jargon, and structure.

5|3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/leifericf/agentic-sdk --skill check-clarity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-clarity
Source: https://github.com/leifericf/agentic-sdk/tree/main/skills/check-clarity
Command: npx skills add https://github.com/leifericf/agentic-sdk --skill check-clarity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill reviews prose and documentation for clarity, ensuring that the intended audience can easily understand the content without confusion or misunderstandings.

Core Features & Use Cases

  • Reader Experience: Checks for audience fit, buried points, jargon, pacing, and structure to enhance readability.
  • Scope: Designed for human-readable content such as design docs, ADRs, reference material, and READMEs.
  • Use Case: When reviewing a complex design document, this Skill can help identify areas where the text is unclear or could be improved for better comprehension.

Quick Start

Run the check-clarity skill on your design document to ensure clarity and reader-friendliness.

Frequently Asked Questions about check-clarity

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

FAQPage Schema
How do I check my documentation for readability and clarity?

To check documentation for readability, you can review prose for audience fit, jargon, pacing, and structure. This ensures the intended audience can easily understand the content without confusion or misunderstandings.

What is the best way to review a design document for buried points?

Reviewing a design document for buried points involves checking the structure and pacing of the text. This process identifies areas where the text is unclear and highlights improvements to enhance overall comprehension.

Can I use this to check the clarity of a README?

Yes, you can check the clarity of a README. The process is designed for human-readable content such as design docs, ADRs, reference material, and READMEs to ensure reader-friendly comprehension.

Does code review for prose help identify jargon in technical writing?

Yes, reviewing prose for clarity helps identify jargon in technical writing. It evaluates audience fit and pacing to ensure the content is accessible and easily understood by the intended readers.

When do I need to review prose for audience fit?

You need to review prose for audience fit when preparing human-readable content like design documents. This ensures the intended audience can easily understand the material without encountering confusion or misunderstandings.