clarity-gate

Identify and fix difficult-to-understand content for broad audiences.

1|Updated Mar 6, 2014
One-click install
npx skills add https://github.com/79yuuki/dotfiles --skill clarity-gate-79yuuki
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarity-gate
Source: https://github.com/79yuuki/dotfiles/tree/main/claude/skills/clarity-gate
Command: npx skills add https://github.com/79yuuki/dotfiles --skill clarity-gate-79yuuki

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps transform complex writing into clear, understandable content that works for non-specialists, customers, executives, and broad audiences.

Core Features & Use Cases

  • Plain-Language Review: Evaluates writing for sentence structure, vocabulary, logical flow, and readability.
  • Content Quality Checks: Reviews documents, proposals, user guides, marketing copy, and public content against clarity and accessibility criteria.
  • Decision Document Review: Adds decision-quality checks for strategy documents, including options, assumptions, risks, and next steps.

Quick Start

Ask the clarity-gate skill to review this document for readability, accessibility, and actionable improvements.

Frequently Asked Questions about clarity-gate

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

FAQPage Schema
How do I improve readability and accessibility for public documentation?▼

To improve readability, perform structured plain-language checks evaluating sentence structure, vocabulary, and logical flow. This identifies difficult content and provides actionable recommendations to fix complex writing for broad audiences.

What is plain-language review for strategy documents and proposals?▼

Plain-language review for strategy documents evaluates clarity and accessibility while adding decision-quality checks. It validates options, assumptions, risks, and next steps to ensure proposals are understandable and actionable for executives.

Can I use automated content review for marketing copy and user guides?▼

Automated content review works for marketing copy, user guides, and internal communications by applying clarity criteria. It evaluates documents against readability standards to generate actionable improvement recommendations for non-specialists.

What's the best way to check decision quality in internal communications?▼

Checking decision quality involves validating that strategy documents explicitly include options, assumptions, risks, and next steps. This ensures internal communications are structurally sound for executive decision-making and broad accessibility.

Does plain-language guidance work for technical documentation intended for non-specialists?▼

Plain-language guidance works for technical documentation by identifying difficult content and applying structured readability checks. It transforms complex writing into accessible language for non-specialists, customers, and broad audiences.