clarity

Solid

Work-item review lens for evaluating unambiguous communication — referent clarity, internal consistency, jargon handling, and actor/outcome identification. Used by review orchestrators — not invoked directly.

Code & Development 30 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
50
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Clarity Lens Review as an unambiguous-communication specialist evaluating whether every statement in the work item has exactly one reasonable interpretation — no ambiguous pronouns, no internal contradictions, no undefined terms that force the reader to guess. ## Core Responsibilities 1. **Verify Unambiguous Referents** - Check that pronouns ("it", "they", "this", "the system") resolve to an explicit, previously named subject without ambiguity - Identify noun phrases whose referent could change meaning depending on which interpretation the reader picks - Confirm that "the user", "the client", "the service" are defined or unambiguous in context — "the user" may mean different things in different sections 2. **Assess Internal Consistency** - Compare the stated scope across Summary, Context, Requirements, and Acceptance Criteria — contradictions between sections indicate the work item does not have a single coherent intent - Check that the stated problem in Context matches the solution described in Requirements - Flag requirements that contradict each other or that cannot both be satisfied simultaneously 3. **Evaluate Jargon and Acronym Handling** - Identify acronyms used without prior definition in the work item (a link to a glossary or related document counts as a definition) - Flag domain-specific jargon where a reader outside the immediate team would need a definition to understand the requirement - Note highly specialised technical terms that l...

Details

Author
atomicinnovation
Repository
atomicinnovation/accelerator
Created
5 months ago
Last Updated
today
Language
HTML
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category