{
  "markdown": "# Dyslex.ai\n\nDyslex.ai is a cognitive accessibility skills plugin for AI agents.\n\nIt 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.\n\nDyslex.ai does not diagnose disability, provide medical advice, or claim medical benefit.\n\n## Quickstart\n\n- [Codex](#codex)\n- [Claude Code](#claude-code)\n- [Antigravity](#antigravity)\n- [Cursor](#cursor)\n- [Factory Droid](#factory-droid)\n- [GitHub Copilot CLI](#github-copilot-cli)\n- [Kimi Code](#kimi-code)\n- [OpenCode](#opencode)\n- [Pi](#pi)\n\n## How It Works\n\nDyslex.ai is a skills-only plugin with an evidence-aware cognitive model.\n\nThe plugin contributes reusable Agent Skills through:\n\n```text\n.codex-plugin/plugin.json\nskills/\nsrc/cognitive/\n```\n\nWhen 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.\n\n```text\nscientific knowledge\n  -> functional model\n  -> interaction risk\n  -> adaptation strategy\n  -> skill behavior\n```\n\nThe 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.\n\nEvery 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.\n\n## Installation\n\n### Codex\n\nPrimary path, after public availability:\n\n```text\n/plugins\n```\n\nSearch for:\n\n```text\nDyslex.ai\n```\n\nCLI install, when available from the configured marketplace:\n\n```bash\ncodex plugin add dyslex-ai@openai-curated\n```\n\nFallback if Dyslex.ai is not visible in the public plugin directory yet:\n\n```bash\ncodex plugin add dyslex-ai@npm:@firou91/dyslex.ai\n```\n\nStart a new Codex session after installation so the skills are loaded.\n\n<!-- UNAVAILABLE FOR THE MOMENT -->\n<!-- ### Claude Code\n\nInstall Superpowers first:\n\n```text\n/plugin install superpowers@claude-plugins-official\n```\n\nDyslex.ai currently ships a static adapter plan for Claude Code:\n\n```bash\ndyslexai install --host claude-code\n```\n\nPublic Claude Code deployment is planned after the project reaches the support target listed below.\n\n### Antigravity\n\nInstall Superpowers first:\n\n```bash\nagy plugin install https://github.com/obra/superpowers\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host antigravity\n```\n\n### Cursor\n\nInstall Superpowers first:\n\n```text\n/add-plugin superpowers\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host cursor\n```\n\nPublic Cursor deployment is planned after the project reaches the support target listed below.\n\n### Factory Droid\n\nInstall Superpowers first:\n\n```bash\ndroid plugin marketplace add https://github.com/obra/superpowers\ndroid plugin install superpowers@superpowers\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host factory-droid\n```\n\n### GitHub Copilot CLI\n\nInstall Superpowers first:\n\n```bash\ncopilot plugin marketplace add obra/superpowers-marketplace\ncopilot plugin install superpowers@superpowers-marketplace\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host copilot-cli\n```\n\n### Kimi Code\n\nInstall Superpowers first:\n\n```text\n/plugins install https://github.com/obra/superpowers\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host kimi-code\n```\n\n### OpenCode\n\nInstall Superpowers using the OpenCode instructions from the Superpowers project:\n\n```text\nhttps://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host opencode\n```\n\n### Pi\n\nInstall Superpowers first:\n\n```bash\npi install git:github.com/obra/superpowers\n```\n\nGenerate the Dyslex.ai adapter plan:\n\n```bash\ndyslexai install --host pi\n``` -->\n\n### Local Package\n\nThe npm package is published as:\n\n```bash\nnpm install @firou91/dyslex.ai\n```\n\nThe CLI command is:\n\n```bash\ndyslexai doctor --verbose\n```\n\n## The Basic Workflow\n\n1. Install Superpowers in the target agent.\n2. Install Dyslex.ai as a plugin.\n3. Start a new session so the skills are visible.\n4. Ask normally, including messy text, unclear instructions, raw errors, or long output.\n5. Dyslex.ai detects the relevant accessibility skill.\n6. The skill preserves commands, paths, package names, environment variables, and other technical tokens.\n7. The agent clarifies only material ambiguity before acting.\n8. The response is structured for readability and verification.\n\n## What's Inside\n\nDyslex.ai currently includes 16 skills, plus a shared cognitive model for evidence, functional dimensions, and adaptation rules.\n\n### Readability And Writing\n\n- `accessible-response`: reshape answers into clearer blocks without losing detail.\n- `spelling-and-writing-support`: correct, proofread, or reformulate text while preserving tone.\n- `typo-tolerant-intent`: infer likely intent from typos or malformed wording.\n- `identifier-safety`: protect paths, commands, URLs, package names, variables, hashes, and regexes.\n\n### Debugging\n\n- `error-decoder`: turn raw errors, stack traces, and logs into clear explanations.\n- `terminal-output-reader`: summarize noisy terminal output without hiding failures.\n- `diff-reader`: explain changes, risks, and test needs from diffs or patches.\n- `code-explainer`: explain source code in accessible layers.\n\n### Collaboration\n\n- `instruction-decoder`: unpack dense prompts, issues, specs, or task descriptions.\n- `prompt-clarifier`: ask only the questions that materially change the result.\n- `task-sequencer`: break work into ordered steps with dependencies and checks.\n- `decision-comparator`: compare options and provide a clear recommendation when needed.\n- `number-and-date-clarifier`: clarify ambiguous dates, units, versions, decimals, and ranges.\n\n### Meta And Continuity\n\n- `context-reentry`: resume interrupted work after pauses, compaction, or task switching.\n- `documentation-navigator`: identify which docs matter and what is required versus recommended.\n- `accessible-superpowers`: present Superpowers workflows more accessibly without weakening them.\n\n## Philosophy\n\nDyslex.ai is built around a simple rule: accessibility should reduce cognitive friction without reducing technical precision or user autonomy.\n\nThat means:\n\n- adapt to functional needs, not diagnostic labels;\n- preserve exact technical tokens;\n- separate facts from assumptions;\n- ask fewer, better questions;\n- make success criteria explicit;\n- keep warnings and failures visible;\n- avoid medical claims;\n- avoid pseudo-neuroscience;\n- treat unsupported ideas as hypotheses or preferences;\n- respect Superpowers as the workflow authority.\n\nThe project is not trying to make agents softer or less rigorous. It is trying to make rigorous work easier to read, resume, and verify.\n\n## Scientific Model\n\nThe first research and architecture report is available in [DYSLEX.AI — Scientific Interaction Model](docs/research/scientific-interaction-model.md).\n\nThe model avoids diagnosis-based modes. It uses functional dimensions such as:\n\n- working-memory load;\n- spelling variability;\n- lexical-access uncertainty;\n- reading-speed load;\n- numerical ambiguity;\n- sequencing and planning load;\n- interface and tool-action burden;\n- over-adaptation risk.\n\n## Identity\n\nHere is how we connect the very minimal visual identity to Dyslex.ai's role, name, and philosophy.\n\nRead the full visual identity notes in [Identity](docs/identity.md).\n\n## Support\n\nPublishing 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.\n\nCodex is already covered as the first public deployment target.\n\nCommunity support will guide the next deployment targets:\n\n- 1,000 GitHub stars: Public deployment for Claude Code.\n- 5,000 GitHub stars: Public release of the plugin for Cursor and other planned hosts.\n\nYou can support the project by:\n\n- starring the repository;\n- testing Dyslex.ai in real workflows;\n- reporting unclear behavior;\n- suggesting accessibility improvements;\n- sharing reproducible prompts where the skills help or fail.\n\n## Documentation\n\n- [Architecture](docs/architecture/README.md)\n- [Installation](docs/installation/README.md)\n- [Codex CLI ](docs//codex-cli.md)\n- [Plugin E2E Publication](docs//plugin-e2e.md)\n- [Compatibility](docs/compatibility/README.md)\n- [Security](docs/security/README.md)\n- [Accessibility](docs/accessibility/README.md)\n- [Publishing](docs/publishing.md)\n",
  "bytes": 8784,
  "sha": "9a03d44ef6b61a8e20eb048e9cb7826ab7c401ff337f781aee403ad87a24ce17",
  "repo_slug": "firou91/dyslex.ia",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_firou91_dyslex_ia_c8a5f9a4/readme"
}