Accessibility MCP server and Agent Skills for AI agents. Requires Superpowers.
Dyslex.ai is a cognitive accessibility skills plugin for AI agents.
It helps agents reduce friction across the human-AI interaction loop: expressing intent, reconstructing meaning from imperfect wording, preserving technical detail, managing cognitive load, and presenting the next action clearly.
Dyslex.ai does not diagnose disability, provide medical advice, or claim medical benefit.
Dyslex.ai is a skills-only plugin with an evidence-aware cognitive model.
The plugin contributes reusable Agent Skills through:
.codex-plugin/plugin.json
skills/
src/cognitive/
When a matching task appears, the agent can use the relevant skill to reduce a specific functional friction. The project maps evidence-informed mechanisms to interaction risks, then to concrete agent behavior.
scientific knowledge
-> functional model
-> interaction risk
-> adaptation strategy
-> skill behavior
The goal is not to replace the agent's reasoning or Superpowers workflow. The goal is to make that workflow easier to follow, safer to resume, and harder to misread.
Every skill starts with a Superpowers gate. If Superpowers is missing or uncertain, the agent must stop and ask the user to install Superpowers before applying Dyslex.ai.
Primary path, after public availability:
/plugins
Search for:
Dyslex.ai
CLI install, when available from the configured marketplace:
codex plugin add dyslex-ai@openai-curated
Fallback if Dyslex.ai is not visible in the public plugin directory yet:
codex plugin add dyslex-ai@npm:@firou91/dyslex.ai
Start a new Codex session after installation so the skills are loaded.
The npm package is published as:
npm install @firou91/dyslex.ai
The CLI command is:
dyslexai doctor --verbose
Dyslex.ai currently includes 16 skills, plus a shared cognitive model for evidence, functional dimensions, and adaptation rules.
accessible-response: reshape answers into clearer blocks without losing detail.spelling-and-writing-support: correct, proofread, or reformulate text while preserving tone.typo-tolerant-intent: infer likely intent from typos or malformed wording.identifier-safety: protect paths, commands, URLs, package names, variables, hashes, and regexes.error-decoder: turn raw errors, stack traces, and logs into clear explanations.terminal-output-reader: summarize noisy terminal output without hiding failures.diff-reader: explain changes, risks, and test needs from diffs or patches.code-explainer: explain source code in accessible layers.instruction-decoder: unpack dense prompts, issues, specs, or task descriptions.prompt-clarifier: ask only the questions that materially change the result.task-sequencer: break work into ordered steps with dependencies and checks.decision-comparator: compare options and provide a clear recommendation when needed.number-and-date-clarifier: clarify ambiguous dates, units, versions, decimals, and ranges.context-reentry: resume interrupted work after pauses, compaction, or task switching.documentation-navigator: identify which docs matter and what is required versus recommended.accessible-superpowers: present Superpowers workflows more accessibly without weakening them.Dyslex.ai is built around a simple rule: accessibility should reduce cognitive friction without reducing technical precision or user autonomy.
That means:
The project is not trying to make agents softer or less rigorous. It is trying to make rigorous work easier to read, resume, and verify.
The first research and architecture report is available in DYSLEX.AI — Scientific Interaction Model.
The model avoids diagnosis-based modes. It uses functional dimensions such as:
Here is how we connect the very minimal visual identity to Dyslex.ai's role, name, and philosophy.
Read the full visual identity notes in Identity.
Publishing and maintaining Dyslex.ai across public agent ecosystems costs time and API tokens. Making an accessibility plugin publicly available usually requires repeated review passes, test runs, model-specific validation, and ongoing compatibility checks.
Codex is already covered as the first public deployment target.
Community support will guide the next deployment targets:
You can support the project by:
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @firou91/dyslex.iaMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-firou91-dyslex-ia": {
"command": "npx",
"args": [
"-y",
"@firou91/dyslex.ia"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@firou91/dyslex.ianpmdyslex.ia works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.