Clarity Skills

An event notice may say that a waiting list is available without explaining whether applicants should come to the venue. What seems obvious to the writer may leave a first-time participant unsure what to do.

Clarity is a collection of writing skills for AI assistants. They help authors supply the context readers need to understand a proposal and judge its merits.

A question about the waiting list is best answered where the term appears. nutshell keeps that explanation in place. Readers can find out how a place is offered without leaving the notice to search for a separate set of rules.

This does not mean withholding essential information. The deadline still belongs in the main text. Readers familiar with the process need not work through every detail again.

Read nutshell ↗

Understanding a rule does not settle whether it is a good one. Consider a proposal to add daily quests to a game. It might give players a reason to return, or turn playing into another obligation. The discussion needs to begin with that experience.

design-review keeps comments alongside the proposal they address, so the author can see where people disagree. Once a decision is reached, a preserves the reasoning. Someone revising the proposal later can understand how the earlier choice was made.

Read design-review ↗
Glossary