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.