agentleFS
humanity4aihumanity4ai/project_human/skills/cognitive-accessibility/SKILL.md

cognitive-accessibility

Skill5 starsChanged 9 months agoMITView on GitHub

Improve content and workflows for users with varied attention, memory, and executive function profiles. Use when user asks to 'simplify content', 'reduce cognitive load', 'improve readability', 'chunk content', 'make accessible for ADHD', 'help with focus'.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. About 0 are common, 14 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈14

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use clear, simple language

    line 37
  2. Distinctive:

    Never use jargon without explanation

    line 49
  3. Distinctive:

    Never create complex multi-step flows without breaks

    line 50
  4. Distinctive:

    Safety boundaries apply: Do not make medical or clinical claims about cognitive conditions such as ADHD or dyslexia.

    line 60
  5. Distinctive:

    No way to save progress

    line 78
  6. Distinctive:

    Use White Space: Don't crowd content

    line 138
  7. Distinctive:

    Allow Pacing: Don't rush users

    line 141
  8. Distinctive:

    Avoid: Sentences over 25 words

    line 147
  9. Distinctive:

    Use white space between paragraphs

    line 153
  10. Distinctive:

    Use common, everyday words

    line 156
  11. Distinctive:

    Use verbs, not noun forms

    line 159
  12. Distinctive:

    Don't require memory across steps

    line 167
  13. Distinctive:

    Don't blame users

    line 172
  14. Distinctive:

    Don't require remembering

    line 178

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Cognitive Accessibility

Purpose

Improves content and workflows for users with varied attention, memory, and executive function profiles. Applies cognitive load theory (Sweller, 1988), chunking strategies, and clear information architecture.

When to Use

  • "Simplify this content"
  • "Reduce cognitive load"
  • "Make this more readable"
  • "Chunk this information"
  • "Help users with focus issues"
  • "Improve accessibility for ADHD"
  • "Simplify the user flow"

Boundaries

Always

  • Use clear, simple language
  • Chunk information into small pieces
  • Provide clear signposting
  • Include recovery options

Ask First

  • Confirm before major restructuring
  • Check cultural context

Never

  • Never use jargon without explanation
  • Never create complex multi-step flows without breaks

Principles

This skill is grounded in the Humanity4AI core principles and the following skill-specific principles:

  1. Cognitive load is a spectrum. Users have varying levels of working memory, attention, and executive function. Recommendations must be framed as considerations, not absolute requirements.
  2. Simplicity is not condescension. Clear, simple language and structured layouts respect all users. Avoid framing simplification as "dumbing down".
  3. Explicit uncertainty over false certainty. Acknowledge when a recommendation may not apply to all users or contexts.
  4. Inclusive design benefits everyone. Cognitive accessibility improvements (chunked content, clear headings, reduced distractions) improve usability for all users.
  5. Safety boundaries apply. Do not make medical or clinical claims about cognitive conditions such as ADHD or dyslexia.

Instructions

Step 1: Assess Load

Analyze content for:

  • Sentence length and complexity
  • Jargon and technical terms
  • Multi-step processes
  • Information density

Step 2: Identify Friction

Find:

  • Ambiguous instructions
  • Missing progress indicators
  • No way to save progress
  • Dense paragraphs

Step 3: Recommend Changes

Suggest:

  • Chunking strategies
  • Clear headings
  • Progress indicators
  • Save/resume options

Examples

Example 1: Chunking

Input: "To register, fill out the form completely including your name, email, phone number, address, and preferences, then review your information, confirm it's correct, and submit."

Output: "Register in 3 steps:

  1. Your details (name, email)
  2. Your address
  3. Review and submit"

Example 2: Clear Language

Input: "The aforementioned functionality requires authentication prior to utilization."

Output: "You need to sign in to use this feature."

Additional Resources

  • references/standards.md - Cognitive accessibility standards
  • references/patterns.md - Chunking patterns
  • references/checklist.md - Cognitive checklist
  • references/load-theory.md - Cognitive load theory
  • references/simplification.md - Simplification techniques
  • references/measurement.md - Measurement metrics
  • references/examples.md - Examples
  • references/quick-reference.md - Quick reference

Cognitive Load Theory

Note: Cognitive Load Theory was originally developed for instructional design; its application to user interface and content design is an extrapolation supported by subsequent HCI research (Hollender et al., 2010; Paas et al., 2003).

Types of Cognitive Load

Intrinsic Load: Inherent complexity of the material

  • Cannot be eliminated, can be managed
  • Break complex topics into steps

Extraneous Load: Unnecessary burden from design

  • Should be minimized
  • Clear layout, simple language

Germane Load: Productive learning

  • Should be supported
  • Good examples, practice

Reducing Cognitive Load

  1. Chunk Information: Group related items
  2. Use White Space: Don't crowd content
  3. Clear Hierarchy: Headings, lists, structure
  4. Multiple Formats: Text + images + video
  5. Allow Pacing: Don't rush users

Sentence and Paragraph Guidelines

Sentence Length

  • Target: 15-20 words maximum
  • Avoid: Sentences over 25 words
  • Split long sentences into two

Paragraph Length

  • Maximum 3-4 sentences per paragraph
  • One idea per paragraph
  • Use white space between paragraphs

Word Choice

  • Use common, everyday words
  • Avoid jargon
  • Define technical terms inline
  • Use verbs, not noun forms

Task Design

Multi-Step Tasks

  • Break into 3-5 steps maximum
  • Show progress (step X of Y)
  • Allow saving progress
  • Don't require memory across steps

Error Recovery

  • Clear error messages
  • Suggest corrections
  • Don't blame users
  • Easy to find and fix errors

Navigation

  • Consistent placement
  • Clear labels
  • Don't require remembering
  • Provide search

Script Usage

This skill includes validation scripts:

  • analyze_load.py — Analyze cognitive load
  • measure_readability.py — Measure readability
  • simplify_text.py — Suggest simplifications
  • chunk_content.py — Analyze chunking
# Analyze cognitive load

# Measure readability

This skill helps create cognitively accessible content.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.