What does the Technical Clarity skill do?

It audits technical prose to ensure it is easy for learners to understand by removing gatekeeping language and defining complex terms.

Does it support documentation accessibility?

Yes, it verifies requirements for screen-reader friendly code, alt-text, and ensuring color is not the sole indicator of meaning.

When should I use this skill in my workflow?

It is best used after content creation but before finalization to validate that your guides, tutorials, and READMEs are truly accessible.

How does it measure readability?

It uses systematic inquiry and proficiency tiers (A2 to B2+) to match text complexity to the target audience's specific grade level.

Can it identify gatekeeping language?

Yes, it flags 'minimizer' words like 'obviously,' 'simply,' and 'just' that create psychological barriers for learners.

Technical Clarity Auditor

Name: Technical Clarity Auditor
Author: panaversity

bypanaversity

•

학습 및 문서화

Audits technical documentation and prose to ensure it is accessible, jargon-free, and optimized for learner comprehension.

The Technical Clarity skill transforms Claude into a specialized accessibility auditor that prioritizes learner comprehension over author intention. It systematically evaluates technical content using a reasoning-activated framework to identify gatekeeping language, measure readability gaps, and ensure complex jargon is defined on first use. By applying principles like 'show before tell' and matching grade-level complexity to the target audience, this skill helps developers and technical writers create inclusive, high-quality documentation that bridges the gap between expert context and beginner understanding.

주요 기능

01Jargon density evaluation and inline definition checking

02Automated gatekeeping language detection and removal

03Readability gap analysis based on target proficiency levels

0496 GitHub stars

05Accessibility verification for screen readers and global audiences

06Cognitive-load optimization through 'show before tell' pattern enforcement

사용 사례

01Ensuring educational blog posts match the target reader's grade level

02Simplifying complex API documentation for public consumption

03Reviewing onboarding tutorials for junior developers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add panaversity/agentfactory technical-clarity

For use in Claude.ai and ChatGPT

Download Skill